Swagger使用

Posted wccw

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Swagger使用相关的知识,希望对你有一定的参考价值。

@


spring boot + swagger
这里用的是knife4j

1、添加knife4j依赖

只需添加下面一段即可,自动引入其他相关依赖

<dependency>
    <groupId>com.github.xiaoymin</groupId>
    <artifactId>knife4j-spring-boot-starter</artifactId>
    <version>2.0.3</version>
</dependency>

2、配置类Swagger2Config.java

package com.wwwc.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.service.Contact;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

@Configuration
@EnableSwagger2
public class Swagger2Config {
    @Bean
    public Docket createRestApi(){
        return new Docket(DocumentationType.SWAGGER_2)//swagger版本
                .apiInfo(apiInfo())//定义api文档汇总信息
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.wwwc.controller"))//指定生成api文档的包
                .paths(PathSelectors.any())//指定所有路径
                .build();
    }
    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("API接口文档")
                .contact(new Contact("ccw","http://cwccw.github.io","2838704605@qq.com"))//联系人信息
                .description("spring boot demo的API接口文档")//描述
                .termsOfServiceUrl("http://localhost:80/")//网站地址
                .version("1.0")//文档版本号
                .build();
    }
}

3、基本使用

1、在Controller类上添加,标注一个分类信息
@Api(tags = "测试类TestController")
2、在请求类上添加,标注一个接口信息
@ApiOperation(value = "返回列表数据",notes = "根据两个参数返回其范围内的数据")
3、其余自行扩展,这里只讲基本使用

4、访问效果

启动项目,输入访问 项目url/doc.html 即可。
技术图片








以上是关于Swagger使用的主要内容,如果未能解决你的问题,请参考以下文章

swagger文档转换为WebApiClient声明式代码

使用 Swashbuckle V5 从代码生成 swagger.json

Swagger-codegen 开始使用

Swagger 生成 Node.JS Express 服务器代码

Swagger结合mustache模板生成后台接口代码以及前后台建模代码

Swagger使用总结