swagger 썸네일형 리스트형 [Spring] Rest-Docs 연결 Spring-Rest-Docs 테스트 코드를 기반으로 Restful API 문서 작성을 돕는 도구 Asciidoctor를 사용하여 HTML 등 다양한 포맷으로 문서를 자동 출력할 수 있다. API Spec과 문서화를 위한 테스트 코드가 일치하지 않으면, 테스트 빌드를 실패하게 되어 테스트 코드로 검증된 문서임을 보장할 수 있다. Swagger @ApiOperation 등 코드에는 영향을 주지 않지만, Swagger를 위해서 지속적으로 추가 코드를 작성해야 한다. 명세를 위한 코드들이 너무 많아 가독성이 떨어질 수 있다. 구조가 변경되었을 때, 명세도 같이 변경하지 않으면 초기 명세와 달라질 가능성이 존재한다. 프로젝트를 진행하면서, API 문서 자동화를 위해 Swagger와 Spring-Rest-Docs.. 더보기 이전 1 다음
