> Java > java지도 시간 > 본문

springboot가 swagger3와 Knife4j를 통합하는 방법

王林
풀어 주다: 2023-05-19 12:49:06
앞으로
2026명이 탐색했습니다.

springboot는 swagger3

swagger3의 springboot 실행기 jar 패키지

<!-- https://mvnrepository.com/artifact/io.springfox/springfox-boot-starter -->
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-boot-starter</artifactId>
    <version>3.0.0</version>
</dependency>
로그인 후 복사

를 통합합니다. 참고: 현재 SpringBoot 버전은 2.5.6이고 Swagger3.0은 현재 SpringBoot2.6.x와 완전히 호환되지 않습니다!

TestController 코드 작성

@RestController
@RequestMapping("test")
public class TestController {
    @GetMapping
    public Map<String, Object> get(@RequestParam String id) {
        Map<String, Object> r = new HashMap<>(1);
        r.put("id", id);
        return r;
    }

    @PostMapping
    public Map<String, Object> post() {
        Map<String, Object> r = new HashMap<>(1);
        r.put("code", 200);
        return r;
    }
    @PutMapping
    public Map<String, Object> put(String id) {
        Map<String, Object> r = new HashMap<>(1);
        r.put("id", id);
        return r;
    }

    @DeleteMapping
    public Map<String, Object> delete(String id) {
        Map<String, Object> r = new HashMap<>(1);
        r.put("id", id);
        return r;
    }
}
로그인 후 복사

Swagger3Configuration 만들기

@Configuration
@EnableOpenApi
public class SwaggerConfig {
    private static final String VERSION = "0.0.1";
    @Bean
    public Docket createRestApi() {
        return new Docket(DocumentationType.OAS_30)
                .groupName("分组名称")
                .apiInfo(apiInfo())
                .select()
                //要扫描的包
                .apis(RequestHandlerSelectors.basePackage("com.example.swagger.controller"))
                .paths(PathSelectors.any())
                .build();
    }
    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                // 设置标题
                .title("文档标题")
                //联系人
                .contact(contact())
                //描述
                .description("xxx文档")
                //服务
                .termsOfServiceUrl("https://spring.io/")
                //许可证
                .license("Apache 2.0")
                .licenseUrl("https://www.apache.org/licenses/LICENSE-2.0")
                .version(VERSION)
                .build();
    }
    private Contact contact (){
        return new Contact("SpringBoot", "https://spring.io/", "email");
    }
}
로그인 후 복사

인터페이스에 주석 달기

swagger에서 일반적으로 사용되는 주석
을 포함할 수 있습니다.
AnnotationFunction위치 사용
@Api는 예라고 말합니다. 설명 공통 매개변수Class
@ApiOperation메서드의 목적을 설명하세요Method
@ApiImplicitParams여러 개의 @ApiImplicitParammethod
@ApiImplicitParam설명 매개변수의 목적method
@ApiModel은 데이터 클래스의 정보를 나타냅니다.class
@ApiModelProperty데이터 클래스의 속성을 설명합니다attributes
@Api 무시 문서에 표시되지 않도록 누군가 필드를 무시하세요속성
인터페이스의 기본 사용법

1. 새로운 사용자 엔터티 클래스를 생성하세요

@ApiModel("用户")
@Data
public class User {
    @ApiModelProperty("用户名")
    private String username;
    @ApiModelProperty("密码")
    private String password;
}
로그인 후 복사

2. TestController에 주석을 추가하세요

@Api(tags = "测试接口")
@RestController
@RequestMapping("test")
public class TestController {
    @ApiOperation("get请求")
    @GetMapping
    @ApiImplicitParam(name = "id", value = "测试用id", dataTypeClass = String.class)
    public Map<String, Object> get(@RequestParam String id) {
        Map<String, Object> r = new HashMap<>(1);
        r.put("id", id);
        return r;
    }

    @ApiOperation("post请求")
    @PostMapping
    public Map<String, Object> post(@RequestBody User user) {
        Map<String, Object> r = new HashMap<>(1);
        r.put("code", 200);
        return r;
    }

    @ApiOperation("put请求")
    @PutMapping
    @ApiImplicitParam(name = "id", value = "put请求id", dataTypeClass = String.class)
    public Map<String, Object> put(String id) {
        Map<String, Object> r = new HashMap<>(1);
        r.put("id", id);
        return r;
    }

    @ApiOperation("delete请求")
    @DeleteMapping
    @ApiImplicitParam(name = "id", value = "delete请求id", dataTypeClass = String.class)
    public Map<String, Object> delete(String id) {
        Map<String, Object> r = new HashMap<>(1);
        r.put("id", id);
        return r;
    }
}
로그인 후 복사
.

springboot가 swagger3와 Knife4j를 통합하는 방법

springboot가 swagger3와 Knife4j를 통합하는 방법

springboot가 swagger3와 Knife4j를 통합하는 방법

더 나은 UI-knife4j 통합

maven
<dependency>
   <groupId>com.github.xiaoymin</groupId>
   <artifactId>knife4j-micro-spring-boot-starter</artifactId>
   <version>3.0.3</version>
</dependency>
로그인 후 복사
Launcher

SwaggerConfig 클래스에 **@EnableKnife4j** 추가

@Configuration
@EnableOpenApi
@EnableKnife4j
public class SwaggerConfig
로그인 후 복사

위 내용은 springboot가 swagger3와 Knife4j를 통합하는 방법의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!

관련 라벨:
원천:yisu.com
본 웹사이트의 성명
본 글의 내용은 네티즌들의 자발적인 기여로 작성되었으며, 저작권은 원저작자에게 있습니다. 본 사이트는 이에 상응하는 법적 책임을 지지 않습니다. 표절이나 침해가 의심되는 콘텐츠를 발견한 경우 admin@php.cn으로 문의하세요.
인기 튜토리얼
더>
최신 다운로드
더>
웹 효과
웹사이트 소스 코드
웹사이트 자료
프론트엔드 템플릿