아 여러분 정말 이거 꼭! 꼭! 읽어보세요. 콘텐츠 제작하는 사람들의 입장에서는 같은 콘텐츠를 사골 우리듯 계속 재탕삼탕하는 것처럼 느껴질 수 있지만, 다른 사람들이 내 콘텐츠만 집중하고 막 정독하고 꼬박꼬박 읽을 것이라는 자기중심적 사고를 버려야합니다. 우리가 독자일 때 자주 그렇듯 세상에는 정말 다양한 콘텐츠가 많기 때문에 대강 슥슥 읽거나 금방 잊어버리기 마련이잖아요. 잘 만든 콘텐츠 하나, 이곳 저곳 자주 공유하세요.
< 💡 Spring Rest Docs 로 Swagger API 문서 관리 자동화 >
💬 Spring Rest Docs 란?
Spring REST Docs 는 RESTful 서비스의 문서화를 도와주는 도구이다.
문서 작성 도구로 Asciidoctor 를 기본적으로 사용하며, 이것을 통해 HTML 문서를 생성한다. 필요한 경우 Markdown 문법을 사용하도록 변경할 수 있다.
RESTful API를 문서화 할때 중요한 포인트는 API 에서 필요한 HTTP 요청과 응답의 리소스를 설명하는 것인데 Spring REST Docs 를 사용할 경우 테스트 코드를 작성하여 이러한 리소스와 HTTP 요청/응답에 대한 세부 내용을 문서화하는데 편리한 기능을 제공한다.
💬 Swagger 란?
RESTful API 를 약속된 규칙에 따라 json 이나 yaml 형식으로 문서화한 Open API Specification(OAS) 라는게 있는데 이 문서를 관리하기위한 목적으로 만들어진 프레임워크다.
API 문서 자동화 도구로 Spring REST Docs 의 비교군으로 자주 등장하는데 Spring 을 사용할 경우 서비스 코드에 어노테이션... 더 보기