[Swagger 3] Swagger2에서 달라진 것들

현재 프로젝트에서 스웨거3을 사용하고 있는데, 버전2의 관련 문서를 참고하면 빨간줄이 뜨는 어노테이션이 많았다.

그래서 찾아보니, 버전 2와 3에서 바뀐 어노테이션이나 파라미터가 좀 있는 것 같아서 정리해보았다. 

 

 

• 어노테이션

@ApiParam -> @Parameter	
@ApiOperation -> @Operation
@Api -> @Tag
@ApiImplicitParams -> @Parameters
@ApiImplicitParam -> @Parameter
@ApiIgnore -> @Parameter(hidden = true) or @operation(hidden = true) or @hidden
@apimodel -> @Schema
@ApiModelProperty -> @Schema

• 파라미터

value -> description
tags -> name