Spring Boot 3 + Swagger 3 연동해 보기
서론 사실 난 swagger가 뭔지 모른다. 대략 RESTAPI를 개발할때 서버(백엔드)와 클라이언트(프론트엔드)간 프로토콜 동기화를 위해 강력하게, 유용하게, 자주 사용된다는 정도밖에 모른다. 그리고 공부를 해 보려 해도 도대체 감이 잡히질 않았다. 그래서 설치해서 사용해 보기로 했다. 그런데 Spring Boot 3와 Swagger 3가 비교적 최신 버전이라서, Reference를 찾기가 힘들었다. 이렇게 하는게 맞나 싶지만, 어째저째 index.html은 띄웠기에 기록을 해 둔다. 제약 나는 IntelliJ IDEA Community Edition을 사용하고 있기에, 유료인 Ultimate 버전과 달리 Spring Boot를 직접 생성할 수 없었다. 번거롭긴 하지만 Spring Initializr 라는 사이트에서 초기 Framework를 Generate해서 다운로드 받는 방법이 가장 Quick & Easy 한 방법 인것 같다. Spring Boot 3 초기 코드 https://start.spring.io/ 위 사이트에 들어가서 아래와 같이 설정 해 준다. Project의 Build도구로 Gradle과 Maven을 선택할 수 있는데, 이것은 개인의 취향 차이 이므로 선호하는 것을 골라준다. Spring Boot는 현재 릴리즈된 버전중 안정화 된 버전이 3.0.6이다. 각종 영어가 붙어있는 버전은 개발중인 버전이다. Java 버전은 17을 사용해야 한다. Spring Boot 3 부터는 17이 필수라 한다. 우측에 "ADD DEPENDENCIES"를 눌러 "Spring Web"을 찾아 선택해 준다. Lombok은 Java의 Annotation Library라고 하는데, 대표적인 annotation은 "@Override"가 있다. 즉, @뒤에 기능을 특정하는 역할을 하는 것이 annotation인것 같다. Lombok이 뭔지 잘 모르겠으나 여러 사람들이 사용하는것 같다. 그래서 나도 일단 써본다.