swagger 연동

[uiop9900]

스프링부트 2.6.x 버전, gradle 파일 - swagger연동

1. gradle에 의존성 추가
2. swaggerConfig 추가한다.
3. 서버를 키고 " http://localhost/swagger-ui/index.html " 으로 들어가면 연동이 된다.

상당히 쉬운방법이지만 계속해서 아래와 같은 오류가 떴다. gradle spring boot because the return value of springfox.documentation.spi.service.contexts.orderings.patternscondition(springfox.documentation.requesthandler)" is null

삽질(3h)

• 계속해서 다른 설정들을 추가하고
• gradle에 속성을 추가했는데 gradle refresh를 하지 않았고
• 구글링 한 결과, 이건 스트링 부트와 swagger의 호환문제로 되지 않는다는걸 알았다.

해결방안

• gradle에서 버전을 다운그레이드했다. plugins{ id 'org.springframework.boot' version '2.4.2' } 이렇게 수정하고 gradle-fresh를 통해 빌드하니 swagger가 연동되었다.

• 이때, swagger 버전에 따라 접속url도 다르니 주의하자

[uiop9900]

AWS에 프로젝트를 등록후 http://54.193.165.205:8080/swagger-ui/index.html 로 들어가야 swagger가 보여진다.

[uiop9900]

swagger 중복값

@RequestMapping으로 메소드를 선언하니 swagger에서 모든 종류의 mapping이 다 뜬다.(get, put, delete, head, option...) 모든 @RequestMapping을 @GetMapping으로 변환했다.

[uiop9900]

서버에 올렸던 파일 수정시

1. branch에서 수정후 master에 병합
2. master는 새로운 aws에 병합
3. 병합 확인 후, 다시 파일을 압축해 ROOT.war로 만든후 서버를 키고 ip주소/manager에서 기존의 파일을 삭제하고 새롭게 ROOT.war를 배치한다.