Swagger란 ?
: 개발한 REST API를 편리하게 문서화 해주고, 이를 통해 관리 및 제 3의 사용자가 편리하게 API를 호출해보고 테스트 할 수 있는 프로젝트이다.
: Spring Boot에서는 springfox-boot-starter를 gradle dependencies에 추가 함으로 사용할 수 있다.
: 운영환경과 같은 외부에 노출되면 안되는 곳에는 주의해야 한다.
Swagger Annotation
- @Api : 클래스를 스웨거의 리소스로 표시
- @ApiOperation : 특정 경로의 오퍼레이션 HTTP 메소드 설명
- @ApiParam : 오퍼레이션 파라미터에 메타 데이터 설명
- @ApiResponse : 오퍼레이션의 응답 지정
- @ApiModelProperty : 모델의 속성 데이터를 설명
- @ApiImplicitParam : 메소드 단위의 오퍼레이션 파라미터를 설명
- @ApiImplicitParams
Swagger Dependency
- Spring Boot 2.6.2 version에서는 에러가 발생하여 추후 진행 예정
- Link : springfox-boot-starter