728x90 반응형 SMALL spring rest docs1 Spring Rest Docs 이전 포스팅 중 Swagger를 이용한 API 문서화 및 테스트 자동화 (https://kimyhcj.tistory.com/354) 내용이 있다. 사실 Swagger는 테스트 용이성이 매우 높고 쉽고 빠르게 초기에 진입할 수 있기 때문에 선택했었다. Swagger를 사용해서 API를 모두 만들고 난 후 API에 대해서 FrontEnd 개발자와 이야기해야 할 때 문서가 필요했는데 Swagger 화면으로 설명하기에는 부족함이 많았다. Swagger의 Annotation 설명과 실제 구현코드가 맞지 않을 수 있다는 것. 즉, 문서화 로직이 불일치 할 수 있다는 것이 가장 큰 문제였다. 그리고 소스코드에 더덕더덕 붙어 있는 지저분한 Swagger Annotation들... @ApiOperation(value .. 2020. 5. 22. 이전 1 다음 728x90 반응형 LIST