swagger
-
Swagger 3개발/JAVA 2025. 8. 4. 13:20
Swagger 3 (OpenAPI) 설정. 또 바뀌었네.Swagger 2에서 OpenAPI 3으로 넘어오면서 어노테이션과 설정이 꽤 바뀌었다.매번 새로 찾아보기 귀찮으니 정리해둔다.핵심 어노테이션 변경점Swagger 2 어노테이션은 이제 잊자. OpenAPI 3는 이걸 쓴다.@Api → @Tag: API 그룹 정의.@ApiOperation → @Operation: API 설명.@ApiParam → @Parameter: 파라미터 설명.@ApiModel, @ApiModelProperty → @Schema: DTO 모델과 속성 설명.DTO Request/Response 필드 분리@Schema 어노테이션으로 제어한다. accessMode를 사용하면 된다.import io.swagger.v3.oas.annotat..