Rumah > Java > javaTutorial > Bagaimana springboot menyepadukan swagger3 dan knife4j

Bagaimana springboot menyepadukan swagger3 dan knife4j

王林
Lepaskan: 2023-05-19 12:49:06
ke hadapan
2065 orang telah melayarinya

springboot menyepadukan swagger3

pakej balang pelancar springboot swagger3

<!-- 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>
Salin selepas log masuk

Nota: Versi SpringBoot semasa ialah 2.5.6 dan Swagger3.0 pada masa ini tidak serasi sepenuhnya dengan SpringBoot2 .6. x!

Tulis kod 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;
    }
}
Salin selepas log masuk

Buat 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");
    }
}
Salin selepas log masuk

Annotate antara muka

Anotasi yang biasa digunakan dalam swagger
注解作用使用位置
@Api表示对类的说明常用参数
@ApiOperation说明方法的用途方法
@ApiImplicitParams里面可以包含多个@ApiImplicitParam方法
@ApiImplicitParam描述参数的用途方法
@ApiModel表示一个数据类的信息
@ApiModelProperty描述数据类的属性属性
@ApiIgnore忽略某个字段使之不显示在文档中属性
Penggunaan asas antara muka
1 Cipta kelas entiti pengguna baharu

@ApiModel("用户")
@Data
public class User {
    @ApiModelProperty("用户名")
    private String username;
    @ApiModelProperty("密码")
    private String password;
}
Salin selepas log masuk

2. Tambahkan anotasi pada 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;
    }
}
Salin selepas log masuk

Hasil yang dijalankan
<🎜. >

Bagaimana springboot menyepadukan swagger3 dan knife4j

Bagaimana springboot menyepadukan swagger3 dan knife4j

Bagaimana springboot menyepadukan swagger3 dan knife4jSepadukan UI-knife4j yang lebih baik

maven

<dependency>
   <groupId>com.github.xiaoymin</groupId>
   <artifactId>knife4j-micro-spring-boot-starter</artifactId>
   <version>3.0.3</version>
</dependency>
Salin selepas log masuk
Pelancar
Tambah **@EnableKnife4j** pada kelas SwaggerConfig
@Configuration
@EnableOpenApi
@EnableKnife4j
public class SwaggerConfig
Salin selepas log masuk

Atas ialah kandungan terperinci Bagaimana springboot menyepadukan swagger3 dan knife4j. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!

Label berkaitan:
sumber:yisu.com
Kenyataan Laman Web ini
Kandungan artikel ini disumbangkan secara sukarela oleh netizen, dan hak cipta adalah milik pengarang asal. Laman web ini tidak memikul tanggungjawab undang-undang yang sepadan. Jika anda menemui sebarang kandungan yang disyaki plagiarisme atau pelanggaran, sila hubungi admin@php.cn
Tutorial Popular
Lagi>
Muat turun terkini
Lagi>
kesan web
Kod sumber laman web
Bahan laman web
Templat hujung hadapan