swagger 2.0 3.0 문의

Question

스프링 부트에서 지금까지 swagger 2.0 으로 사용하다가3.0으로 변경해보려고 다음 URL 참고해서 변경해봤습니다.https://choisblog.tistory.com/74https://velog.io/@hyejinjeong9999/springdoc%EC%9C%BC%EB%A1%9C-swagger3-%EB%8F%84%EC%9E%85@EnableWebMvc하지 않고, @EnableSwagger2 로 하고return new Docket(DocumentationType.SWAGGER_2)이 부분만return new Docket(DocumentationType.OAS_30)이렇게 변경하니 OAS3 배지가 뜨면서 3.0 적용된것처럼 보입니다.@ApiModelProperty 가 @Schema 로 변경되었다고 하는데,@Schema 로 하면 설명이 안나옵니다.2.0 에서 하던 방식 그대로 VO 객체를파라미터는@ApiModelProperty응답은@Schema로 설정해야 하더라구요... 이렇다 보니 2.0하고 3.0 하고 차이를 모르겠네요... UI 가 조금 다른 정도?메이븐 디펜더시는 다음과 같습니다. io.springfox springfox-boot-starter 3.0.0 springfox라 그럴까요?2.0 하고 3.0 설정 및 사용법 문서로 정리하려고 했는데 의미가 없어 보이네요...

adduci · Answer

링크하신 글들이 정보가 부족한듯 하네요https://jeonyoungho.github.io/posts/Open-API-3.0-Swagger-v3-%EC%83%81%EC%84%B8%EC%84%A4%EC%A0%95/이 글을 한번 보셔요

kdk1026 · Answer

해당 링크에도 &#64;Schema 의 경우, 예시에 응답 VO에 설정이 되어 있네요.&#64;Parameter 의 경우 사용을 안해봤고요청 VO는 &#64;ApiModelProperty 로 해야 설명이 나오고, Swagger 2.0이든 3.0 이든 동일하더라구요...많이 다르다고 하는데 동일해서 문의한겁니다...&#64;EnableSwagger2 대신 &#64;EnableWebMvc 의 경우에도 2.0 에서도 먹히는지는 테스트를 해봐야겠네요.DocumentationType.SWAGGER_2랑 DocumentationType.OAS_30설정은 딱 요정도 차이인거 같고, UI가 아주 살짝 다른 정도?그룹 설정도&#64;Tag 랑 &#64;Api 둘다 해줘야 제대로 되는거는 2.0이나 3.0이나 동일하더라구요.

kdk1026 · Answer

https://velog.io/&#64;gillog/Swagger-UI-Annotation-%EC%84%A4%EB%AA%85여기서는DocumentationType.OAS_30 설정했는데&#64;ApiModelProperty 랑 &#64;ApiParam 사용했네요.큰 차이 없는게 맞나 봅니다.아니면 라이브러리 차이일 수도 있겠네요.springfox 사용해봤고 사용중인거springdoc-openapi 한번도 사용을 안해봤습니다.

swagger 2.0 3.0 문의

3개의 답변

Q&A 목록