Spring Boot エンジニア

コアワークフロー

1. 要件分析 — サービス境界、API、データモデル、セキュリティ要件を特定
2. アーキテクチャ設計 — マイクロサービス、データアクセス、クラウド統合、セキュリティを計画；コーディング前に設計を確認
3. 実装 — コンストラクタインジェクションとレイヤー化アーキテクチャでサービスを作成（下記のクイックスタートを参照）
4. セキュリティ対応 — Spring Security、OAuth2、メソッドセキュリティ、CORS設定を追加；セキュリティルールがコンパイルされ、テストに合格することを確認。コンパイルまたはテストが失敗した場合：エラー出力を確認し、失敗したルールまたは設定を修正して、再実行してから進める
5. テスト — ユニット、統合、スライステストを記述；./mvnw test（または ./gradlew test）を実行し、すべてが合格することを確認してから進める。テストが失敗した場合：スタックトレースを確認し、失敗したアサーションまたはコンポーネントを特定し、問題を修正して、完全なスイートを再実行
6. デプロイ — Actuatorを通じてヘルスチェックと可観測性を設定；/actuator/healthがUPを返すことを確認。ヘルスがDOWNの場合：レスポンス内のcomponentsの詳細を確認し、失敗しているコンポーネント（例：データソース、ブローカー）を解決して、再検証

リファレンスガイド

コンテキストに基づいて詳細なガイダンスを読み込む：

トピック	リファレンス	読み込むタイミング
Web レイヤー	references/web.md	コントローラー、REST API、バリデーション、例外処理
データアクセス	references/data.md	Spring Data JPA、リポジトリ、トランザクション、プロジェクション
セキュリティ	references/security.md	Spring Security 6、OAuth2、JWT、メソッドセキュリティ
クラウドネイティブ	references/cloud.md	Spring Cloud、Config、Discovery、Gateway、レジリエンス
テスト	references/testing.md	@SpringBootTest、MockMvc、Testcontainers、テストスライス

クイックスタート — 最小限の実装構造

標準的な Spring Boot フィーチャーはこれらのレイヤーで構成されます。これらをコピペの出発点として使用してください。

エンティティ

@Entity
@Table(name = "products")
public class Product {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @NotBlank
    private String name;

    @DecimalMin("0.0")
    private BigDecimal price;

    // getters / setters or use @Data (Lombok)
}

リポジトリ

public interface ProductRepository extends JpaRepository<Product, Long> {
    List<Product> findByNameContainingIgnoreCase(String name);
}

サービス（コンストラクタインジェクション）

@Service
public class ProductService {
    private final ProductRepository repo;

    public ProductService(ProductRepository repo) { // constructor injection — no @Autowired
        this.repo = repo;
    }

    @Transactional(readOnly = true)
    public List<Product> search(String name) {
        return repo.findByNameContainingIgnoreCase(name);
    }

    @Transactional
    public Product create(ProductRequest request) {
        var product = new Product();
        product.setName(request.name());
        product.setPrice(request.price());
        return repo.save(product);
    }
}

REST コントローラー

@RestController
@RequestMapping("/api/v1/products")
@Validated
public class ProductController {
    private final ProductService service;

    public ProductController(ProductService service) {
        this.service = service;
    }

    @GetMapping
    public List<Product> search(@RequestParam(defaultValue = "") String name) {
        return service.search(name);
    }

    @PostMapping
    @ResponseStatus(HttpStatus.CREATED)
    public Product create(@Valid @RequestBody ProductRequest request) {
        return service.create(request);
    }
}

DTO（レコード）

public record ProductRequest(
    @NotBlank String name,
    @DecimalMin("0.0") BigDecimal price
) {}

グローバル例外ハンドラー

@RestControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(MethodArgumentNotValidException.class)
    @ResponseStatus(HttpStatus.BAD_REQUEST)
    public Map<String, String> handleValidation(MethodArgumentNotValidException ex) {
        return ex.getBindingResult().getFieldErrors().stream()
            .collect(Collectors.toMap(FieldError::getField, FieldError::getDefaultMessage));
    }

    @ExceptionHandler(EntityNotFoundException.class)
    @ResponseStatus(HttpStatus.NOT_FOUND)
    public Map<String, String> handleNotFound(EntityNotFoundException ex) {
        return Map.of("error", ex.getMessage());
    }
}

テストスライス

@WebMvcTest(ProductController.class)
class ProductControllerTest {
    @Autowired MockMvc mockMvc;
    @MockBean ProductService service;

    @Test
    void createProduct_validRequest_returns201() throws Exception {
        var product = new Product(); product.setName("Widget"); product.setPrice(BigDecimal.TEN);
        when(service.create(any())).thenReturn(product);

        mockMvc.perform(post("/api/v1/products")
                .contentType(MediaType.APPLICATION_JSON)
                .content("""{"name":"Widget","price":10.0}"""))
            .andExpect(status().isCreated())
            .andExpect(jsonPath("$.name").value("Widget"));
    }
}

制約

必須（MUST DO）

ルール	正しいパターン
コンストラクタインジェクション	public MyService(Dep dep) { this.dep = dep; }
API入力のバリデーション	すべての変更エンドポイントで @Valid @RequestBody MyRequest req
タイプセーフな設定	@ConfigurationProperties(prefix = "app") をレコード/クラスにバインド
適切なステレオタイプ	ビジネスロジックに@Service、データに@Repository、HTTPに@RestController
トランザクションスコープ	複数ステップの書き込みに@Transactional；読み取りに@Transactional(readOnly = true)
内部実装の隠蔽	@RestControllerAdviceでドメイン例外をキャッチ；スタックトレースではなく問題の詳細を返却
シークレットの外部化	環境変数または Spring Cloud Config を使用；application.propertiesには格納しない

禁止（MUST NOT DO）

• フィールドインジェクション（フィールドの@Autowired）を使用
• API エンドポイントでの入力バリデーションをスキップ
• @Service/@Repository/@Controllerが適用できる場合に@Componentを使用
• ブロッキングコードとリアクティブコードを混在させる（例：WebFlux チェーン内で.block()を呼び出す）
• application.properties/application.ymlにシークレット認証情報を保存
• URL、認証情報、環境固有の値をハードコード
• 非推奨の Spring Boot 2.x パターンを使用（例：WebSecurityConfigurerAdapter）

ドキュメンテーション