[Spring Boot] swagger ui HTML문서로 출력하기
Back end rest api를 개발하면 api 스펙 문서를 어떻게 만들지 고민하게 된다. 그 대안중 하나로 널리 쓰이고 있는 swagger-ui 를 활용하는 방법이 있을 것이다. swagger 형식에 맞게 doc 를 작성하고 서버를 실행하면 swagger 페이지를 볼 수 있다. 깔끔하게 rest api 스펙을 정리해서 보여주고 직접 api 테스트 및 결과 출력도 볼 수 있다. 그러나 여러 부서와 일을 하게 되면 산출물 공유시 문서가 필요할 경우가 있다. 서버 주소를 알려줄수도 있지만 오프라인으로 api 스펙 문서를 검토해야 할때는 별도의 문서 파일을 원하는 부서가 있을수 있다. swagger 구현을 넘어서 swagger 공식 홈페이지에서는 swagger editor라는 tool을 제공해주고 있다. 온..