기록 및 회고
Spring Rest Docs 트러블 슈팅
스프링 진영에서는 API 명세서로 사용하는 대표적인 두 가지가 있다. 바로 Swagger와 Spring Rest Docs다. 간단하게 설명하면 Swagger는 도입이 매우 편리하지만 운영 코드가 지저분해지고 기능적인 보장을 할 수 없다. Spring Rest Docs는 테스트를 기반으로 작성되므로 운영 코드가 지저분해지지 않고 기능적인 보장을 한다. 다만 적용하는데 꽤 많은 시간이 소요된다. 저번 동아리 프로젝트는 빠르게 개발을 해야하므로 Swagger을 도입했었다. 이번에는 졸업 프로젝트를 하면서 새로운 기술을 도입해보고 싶었기에 Spring Rest Docs를 도입하기로 결정했다. 이번 포스팅에서는 구체적인 도입 방법보다는 트러블 슈팅과 해결 과정을 기록하려고 한다. Spring Rest Docs를 ..
