이번 포스팅은 혹시나 다른 방법을 찾으신 분은 댓글로 공유 부탁드립니다! Contents 0. "중계 서비스" 관점에서 API 문서화가 필요한 이유 1. Swagger 채택 이유 1-a. 적용을 위한 비용이 상대적으로 낮습니다. 1-b. Swagger에서 Spring Rest docs로 전환하는 케이스가 많습니다. 1-c. 저렴한 전환 비용 2. Swagger : 단점과 보완 전략 2-a. 검증이 되지 않은API의 노출 2-b. 서비스를 위한 코드와 문서화 코드의 결합 3. 서비스 코드와 문서화 코드의 분리 방법 3-a. Swagger의 동작 원리 3-b. 적용 순서 3. 마치며... 0. "중계 서비스" 관점에서 API 문서화가 필요한 이유 최근 프로젝트에 문서화 툴을 적용하자는 제안을 받았습니다. 물..
오늘 내용의 샘플 코드는 다음 깃허브 저장소를 통해서 확인가능합니다. 소스코드 확인하기 앵귤러 + 스프링부트 + RDBMS 우리에게 상당히 친숙한 3-tier 아키텍처입니다. 제가 현재 속한 팀에서도 많이 사용하는 데요. 우리가 매번 엄청난 트래픽이 예상되는 서비스를 만들지는 않습니다. 낮은 워크로드를 요구하는 어플리케이션의 경우 앵귤러와 스프링부트를 함께 패키징해서 사용하기도 합니다. 제가 지금까지는 패키징할때마다 엄청난 시간을 소모하는데요. (게을러서 Gradle 스크립트를 제대로 공부하지 않아서...) 그래서 이번에는 아예 샘플로 사용할 프로젝트를 만들어버렸습니다. (물론 공부도 했지요 ㅎ ) ( 깃허브 저장소를 참고하세요 ) 오늘은 그레이들을 활용하여 스프링부트와 앵귤러를 함께 패키징하는 방법에 ..
