spring rest docs vs swagger

Question

https://techblog.woowahan.com/2597/위 사이트 들어가보시면 스웨거는 코드와 동기화가 안된다고 설명이 되어있어요근데 스웨거가 코드작성하고 빌드하면 파일이 동기화되어 생기는거아닌가요?스웨거를 안써봐서 모르겠어요&#34;자바문서자동화&#34;의 예시중 하나가 스웨거라면 당연히 코드변경에 따른 파일 동기화기능을 제공해야하는거아닌가요?이해가 안가네요...ㅠㅠ

wittgen · Answer

스웨거는 어노테이션 기반으로 api 문서가 작성됩니다.rest docs 같은 경우는 실제로 수행이 완료된 테스트케이스를 토대로 api문서가 생성되서 코드와 동기화 문제가 없지만,스웨거는 개발자가 입력한 어노테이션 기반으로 api문서가 생성되기 때문에..코드가 변경되었는데 개발자가 관련 어노테이션을 추가/수정 등의 작업을 하지않으면 그 api문서는 코드와 동기화되지 않은 api문서가 되죠..스웨거 사용하는 방법에 대해서 한번 검색하셔서 보시는게 이해는 더 빠르실거같습니다.

adduci · Answer

어노테이션을 실수로 안쓰면 문서에 안나올수있다 이거 아닌가요?전 갠적으로 스웨거보단 resdocs 선호합니다동기화 이런거보다 그냥 제품 코드에 스웨거 코드가 섞이는게 싫어서요 ㅎㅎ

spring rest docs vs swagger

2개의 답변

Q&A 목록