springboot-patterns · rohitg00 — скилл для Claude Code
Скилл springboot-patterns задаёт слоистую структуру Spring Boot проекта и шаблоны контроллеров, сервисов и репозиториев с разбором типичных ошибок.
Apache-2.0 ★ 2 858 обновлён 2026-05-12
npx skills add rohitg00/awesome-claude-code-toolkit --skill springboot-patterns -a claude-codeЧто делает springboot-patterns
Скилл описывает разбиение Java-пакета на config, controller, service, repository, model (entity, dto, mapper), exception и security, где контроллер только принимает HTTP-запрос и передаёт его сервису. В примерах — REST-контроллер на Spring MVC с пагинацией, JPA-сущность Order со связями @ManyToOne и @OneToMany, репозиторий с @Query и @EntityGraph против N+1, сервисный слой с @Transactional и глобальный обработчик ошибок через ProblemDetail по RFC 7807.
Отдельный список антипаттернов называет внедрение репозитория прямо в контроллер, FetchType.EAGER по умолчанию и возврат сущностей JPA вместо DTO. Чеклист в конце требует @Valid на входных DTO и интеграционные тесты через @SpringBootTest с testcontainers — без них часть пунктов проверить не на чём.
Все примеры на Java с Lombok-аннотациями @RequiredArgsConstructor и @Getter/@Setter, так что скилл предполагает именно этот стек, а не Kotlin или чистый Spring без Lombok.
Какие задачи решает
- разложить модуль заказов по слоям controller, service, repository
- избежать N+1 запросов через
@EntityGraphилиJOIN FETCH - вернуть ошибки в формате
ProblemDetailпо RFC 7807 - заменить сущности JPA на DTO в ответах контроллера
- настроить
@Transactionalс правильным read/write скоупом
Примеры запросов агенту
- Разбей сервис заказов на слои controller, service и repository по этому скиллу
- Проверь JPA-сущность
Orderна лишнийFetchType.EAGER - Добавь глобальный обработчик ошибок с
ProblemDetailдля контроллера
Как установить springboot-patterns
1Через Skills CLI (Vercel)
npx skills add rohitg00/awesome-claude-code-toolkit --skill springboot-patterns -a claude-code2Вручную: положить файлы
~/.claude/skills/springboot-patterns/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/springboot-patterns/
1Через Skills CLI (Vercel)
npx skills add rohitg00/awesome-claude-code-toolkit --skill springboot-patterns -a codex2Вручную: положить файлы
.agents/skills/springboot-patterns/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add rohitg00/awesome-claude-code-toolkit --skill springboot-patterns -a cursor2Вручную: положить файлы
.cursor/skills/springboot-patterns/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install rohitg00/awesome-claude-code-toolkit skills/springboot-patterns2Вручную: положить файлы
.github/skills/springboot-patterns/SKILL.md1Через Skills CLI (Vercel)
npx skills add rohitg00/awesome-claude-code-toolkit --skill springboot-patterns -a gemini-cli2Командой платформы
gemini skills install https://github.com/rohitg00/awesome-claude-code-toolkit --path skills/springboot-patternsВручную: положить файлы
.devin/skills/springboot-patterns/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о springboot-patterns
Как установить springboot-patterns в Claude Code?
Выполните npx skills add rohitg00/awesome-claude-code-toolkit --skill springboot-patterns -a claude-code, скилл появится в ~/.claude/skills/springboot-patterns/SKILL.md.
Что делает скилл springboot-patterns?
Он задаёт слоистую архитектуру Spring Boot приложения и даёт шаблоны REST-контроллера, JPA-сущности с репозиторием, сервиса с транзакциями и обработчика исключений, а также список типичных ошибок и чеклист проверки.
Для какого стека подходит springboot-patterns?
Примеры написаны на Java с аннотациями Lombok (@RequiredArgsConstructor, @Getter, @Setter) и Spring Data JPA, так что скилл рассчитан на классический Spring Boot стек с этими библиотеками.
Исходный текст
SKILL.md · Apache-2.0
---
name: springboot-patterns
description: Spring Boot patterns including JPA repositories, REST controllers, layered services, and configuration
---
# Spring Boot Patterns
## Layered Architecture
```
src/main/java/com/example/app/
config/ # @Configuration beans
controller/ # @RestController (thin, delegates to service)
service/ # @Service (business logic)
repository/ # @Repository (data access via JPA)
model/
entity/ # @Entity JPA classes
dto/ # Request/response DTOs
mapper/ # MapStruct or manual mapping
exception/ # @ControllerAdvice, custom exceptions
security/ # SecurityFilterChain, JWT filters
```
Controllers handle HTTP concerns. Services contain business logic. Repositories handle persistence.
## REST Controller
```java
@RestController
@RequestMapping("/api/v1/orders")
@RequiredArgsConstructor
public class OrderController {
private final OrderService orderService;
@GetMapping
public Page<OrderResponse> list(
@RequestParam(defaultValue = "0") int page,
@RequestParam(defaultValue = "20") int size) {
return orderService.findAll(PageRequest.of(page, size));
}
@PostMapping
@ResponseStatus(HttpStatus.CREATED)
public OrderResponse create(@Valid @RequestBody CreateOrderRequest request) {
return orderService.create(request);
}
@GetMapping("/{id}")
public OrderResponse getById(@PathVariable UUID id) {
return orderService.findById(id);
}
}
```
## JPA Entity and Repository
```java
@Entity
@Table(name = "orders")
@Getter @Setter @NoArgsConstructor
public class Order {
@Id
@GeneratedValue(strategy = GenerationType.UUID)
private UUID id;
@ManyToOne(fetch = FetchType.LAZY)
@JoinColumn(name = "customer_id", nullable = false)
private Customer customer;
@OneToMany(mappedBy = "order", cascade = CascadeType.ALL, orphanRemoval = true)
private List<OrderItem> items = new ArrayList<>();
@Enumerated(EnumType.STRING)
private OrderStatus status = OrderStatus.PENDING;
@CreationTimestamp
private Instant createdAt;
}
public interface OrderRepository extends JpaRepository<Order, UUID> {
@Query("SELECT o FROM Order o JOIN FETCH o.items WHERE o.customer.id = :customerId")
List<Order> findByCustomerWithItems(@Param("customerId") UUID customerId);
@EntityGraph(attributePaths = {"customer", "items"})
Optional<Order> findWithDetailsById(UUID id);
}
```
## Service Layer
```java
@Service
@Transactional(readOnly = true)
@RequiredArgsConstructor
public class OrderService {
private final OrderRepository orderRepository;
private final OrderMapper orderMapper;
private final EventPublisher eventPublisher;
public OrderResponse findById(UUID id) {
Order order = orderRepository.findWithDetailsById(id)
.orElseThrow(() -> new ResourceNotFoundException("Order", id));
return orderMapper.toResponse(order);
}
@Transactional
public OrderResponse create(CreateOrderRequest request) {
Order order = orderMapper.toEntity(request);
order = orderRepository.save(order);
eventPublisher.publish(new OrderCreatedEvent(order.getId()));
return orderMapper.toResponse(order);
}
}
```
## Global Exception Handler
```java
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(ResourceNotFoundException.class)
@ResponseStatus(HttpStatus.NOT_FOUND)
public ProblemDetail handleNotFound(ResourceNotFoundException ex) {
return ProblemDetail.forStatusAndDetail(HttpStatus.NOT_FOUND, ex.getMessage());
}
@ExceptionHandler(MethodArgumentNotValidException.class)
@ResponseStatus(HttpStatus.BAD_REQUEST)
public ProblemDetail handleValidation(MethodArgumentNotValidException ex) {
ProblemDetail detail = ProblemDetail.forStatus(HttpStatus.BAD_REQUEST);
Map<String, String> errors = ex.getFieldErrors().stream()
.collect(Collectors.toMap(FieldError::getField, FieldError::getDefaultMessage));
detail.setProperty("errors", errors);
return detail;
}
}
```
## Anti-Patterns
- Injecting repositories directly into controllers (bypassing service layer)
- Using `FetchType.EAGER` on entity relationships by default
- Returning JPA entities directly from controllers instead of DTOs
- Missing `@Transactional(readOnly = true)` on read-only service methods
- Catching generic `Exception` instead of specific types
- Hardcoding configuration values instead of using `@Value` or `@ConfigurationProperties`
## Checklist
- [ ] Controllers are thin and delegate to services
- [ ] All JPA relationships use `FetchType.LAZY` by default
- [ ] DTOs used for request/response, never raw entities
- [ ] `@Transactional` applied at service level with correct read/write scoping
- [ ] Validation annotations (`@Valid`, `@NotNull`, `@Size`) on request DTOs
- [ ] Global exception handler returns `ProblemDetail` (RFC 7807)
- [ ] Entity graphs or `JOIN FETCH` used to avoid N+1 queries
- [ ] Integration tests use `@SpringBootTest` with test containers
© rohitg00 · Apache-2.0 · rohitg00/awesome-claude-code-toolkit
Похожие скиллы
Все скиллы по теме «Бэкенд и API» →Сначала — springboot-patterns от других авторов.