[REFACTOR] Swagger request body, responseBody Schema 등록

[isayaksh]

✏️ Description

Spring 서버에서 구현한 Swagger의 parameter, request body, response body가 UI에 구현되지 않은 문제점을 발견

🛠 Features

• [x] Spring 서버에 구현된 controller를 Swagger에 제대로 연동

🔥 New Issue

• 현재 사용중인 Swagger 라이브러리는 io.springfox:springfox-boot-starter:3.0.0이다.
• springfox 라이브러리는 2020년 7월 이후로 없데이트 중이다.
• 현재 겪고 있는 문제를 다루는 대부분의 레퍼런스에서 제공하는 방법을 사용해보았지만 문제는 해결되지 않았다.
• springfox 라이브러리에 집착하지 않고 새로운 방법을 찾기로 했다.

💡Solution

• springfox 라이브러리와는 다르게 현재까지 꾸준히 업데이트를 진행중인 org.springdoc:springdoc-openapi-ui:1.6.9 라이브러리를 발견하였다.
• springdoc 라이브러리는 가장 최근 업데이트는 2023년 4월이다.
• springdoc 라이브러리는 docs도 굉장히 잘 구현되어 있다.
• Swagger를 springfox에서 springdoc로 migration할 예정이다.

📌 Work Done

• io.springfox:springfox-boot-starter:3.0.0 에서 org.springdoc:springdoc-openapi-ui:1.6.9 라이브러리로 변경
• Swagger 설정 값들을 새로 설정함
• 새로운 라이브러리를 위한 Swagger Configuration을 새로 생성
• 기존의 모든 controller에 @ApiResponse 어노테이션 추가

⚙️ 이후 수정할 점

• controller에 추가한 @ApiResponse 어노테이션의 내용이 모두 비슷한데 AOP를 적용하면 controller가 추가되어도 매번 @ApiResponse를 추가적으로 작성하지 않아도 될 것이다.