OpenAPI 스펙으로 Spring API 코드 생성하기
OpenAPI 스펙으로 Spring API 코드 생성하기 YAML로 API 스펙을 먼저 작성하고, 그 스펙에서 Java 인터페이스와 DTO, Swagger 문서를 생성하는 spec-first 워크플로를 직접 만들어보았습니다. Spring Boot 3.5와 openapi-generator를 사용했습니다. API를 개발할 때 실제로 관리하게 되는 산출물은 보통 세 가지입니다. 이 API가 무엇을 받고 무엇을 돌려주는지 적은 문서, 컨트롤러 시그니처와 검증이 들어가는 서버 코드, 그리고 호출하는 쪽의 클라이언트 코드입니다. 이 셋이 따로 관리되면 시간이 지날수록 서로 어긋나기 쉽습니다. 컨트롤러를 고치고 문서는 따로 갱신하고, 프런트엔드에는 변경 사항을 별도로 공유하는 식이면 어딘가는 결국 옛 상태로 남습니다. 스펙 우선(spec-first) 방식은 이 순서를 바꿔서, 사람이 직접 작성하는 것을 OpenAPI 스펙 한 파일로 좁히고 나머지는 거기서 생성합니다. 문서와 서버, 클라이언트가