Swagger2 프로젝트 설정

프로젝트를 하다 보면 가장 귀찮은 일은 문서 작업일 것이다. API 개발 완료 후 FrontEnd 개발자에게 API 설명을 위해서는 IN/OUT 값을 정의한 명세서를 작성해야 할 것이다. 그리고 API가 변경될 때마다 현행화 해야 하는 일도 만만치 않은 작업일 것이다. 만약에 API 명세서를 현행화 하지 않는 다면 프로그램은 에러가 발생할 것이다. Swagger를 사용하는 가장 큰 이유는 위에서 설명하였지만 별도의 문서 작업 없이 Documentation 작업이 가능하며 Postman을 대체해서 테스트도 가능하다는 점입니다. 어떤 분들은 단점으로 실제 코드보다는 주석의 양이 많아져서 가독성이 떨어진다 하지만 나중에 프로그램을 인수받는 입장에서는 코드도 중요하지만 코드에 대한 주석이 더 중요할 수 도 있을..

2021.08.29