# Backend Controller Java

> Criar controllers HTTP Spring (@RestController) Java. Usar quando o pedido envolver REST API, rotas ou controllers na camada interfaces/web.

- Skill: `eskcti/backend-controller-java` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add eskcti/backend-controller-java`
- Raw SKILL.md: https://api.skillmd.com/api/skills/eskcti/backend-controller-java/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: EskCti (https://skillmd.com/u/eskcti)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/eskcti/backend-controller-java

---


# Backend Controller (Java / Spring Boot)

## Overview

Controllers finos em `modules/<bc>/interfaces/web/CustomerController.java` — delegam a use cases da camada `application`.

## Guidelines

- Controller não implementa regra de domínio; delega para use case.
- Definir rota com `@RequestMapping`, verbos `@GetMapping`, `@PostMapping`, etc.
- Extrair input com `@RequestBody`, `@PathVariable`, `@RequestParam`.
- Devolver sempre DTO de saída (`*Output`) — nunca a entidade de domínio.
- Mapear `Result.isFailure()` → `ResponseEntity`: `400 { "errors": [...] }` (lista completa via `getErrorMessages()`), `404` (não encontrado), `500` (exceção inesperada).
- Create retorna `201 Created` (não `200`).
- Prefixo de rota por BC: `/customers`, `/orders`.
- Sem JPA nem regras de domínio no controller.

## Workflow

1. Definir `@RequestMapping` base.
2. Implementar endpoints delegando ao use case e mapeando `Result.isFailure()` → 400/404/500 (ver `references/controller-pattern-java.md`).
3. Injetar use cases via construtor (Spring DI).
4. E2E com MockMvc — `test-e2e-java`.

## References

- Ver `references/controller-pattern-java.md` — exemplo completo (create 201, `400 { "errors": [...] }`, 404 e 500).
- Ver `../config-shared-core-java/references/shared-patterns-java.md` — API do `Result<T>`.
- Consultar `../skills-standards.md` § **5.1** e seção **Java Stack Standards**.