Springboot项目整合swagger2

IDEA下载swagger插件

File -> settings -> Plugins 搜索swagger并安装

pom文件添加依赖

<artifactId>springfox-swagger2</artifactId>

</dependency>

<artifactId>springfox-swagger-ui</artifactId>

</dependency>

Swagger配置类

@Configuration
public class Swagger2 {

@Bean
public Docket createRestApi() {

//添加head参数
ParameterBuilder tokenPar = new ParameterBuilder();
List<Parameter> pars = new ArrayList<Parameter>();
("token").description("令牌").modelRef(new ModelRef("string")).parameterType("header")
.required(false).build();
(());

        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .select()
                //扫描包的路径
                .apis((""))
                .paths(())
                .build()

.globalOperationParameters(pars);//添加head参数
    }
    //构建 api文档的详细信息函数
    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                //页面标题
                .title("springboot利用swagger构建api文档")
                //创建人
                .contact("jia")
                //版本号
                .version("1.0")
                //描述
                .description("API 描述")
                .build();
    }
}

开启swagger

在启动类上添加@EnableSwagger2注解，开启swagger

@SpringBootApplication
@ComponentScan("")//开启spring注解扫描
@EnableJpaRepositories(basePackages = {""})//扫描JPA资源库
@EntityScan(basePackages = {""})//扫描实体类
@EnableSwagger2//开启swagger
public class DemoApplication {
    public static void main(String[] args) {
        (, args);
    }
}

此时启动项目就可以访问http://localhost:8080/页面查看扫描路径下的接口文档了，只是因为项目中没有使用相关注解而没有任何注释。

swagger2 常用注解(非必要)

@Api放在类上面

@Api(description = "测试JPA接口")
public class BookController {

...

}

效果：

@ApiOperation使用在接口上

@ApiOperation(value = "测试接口hello",notes = "用于测试项目能否运行")
@PostMapping("hello")
public String hello(){
return "wellcome!";
}

效果：

@ApiImplicitParam 与 @ApiImplicitParams

@ApiImplicitParam注解用于表明前端传入的name参数的名字，value是对参数的注释，example是样例参数，required是否为必需项，以及dataType参数类型，以及paramType传递方式（query表示使用url问号的方式传参，这种比较常用，如果使用formData的方式进行传参，那么paramType的值为 form）。

当有多个参数时，需要用@ApiImplicitParams将@ApiImplicitParam包起来

@ApiOperation(value = "测试使用jpa实现分页功能")
@ApiImplicitParams({
@ApiImplicitParam(name = "page",value = "当前页码",example = "1",required = false,dataType = "int",paramType = "query"),
@ApiImplicitParam(name = "size",value = "每页显示的数量",example = "5",required = false,dataType = "int",paramType = "query")
})
@PostMapping("noQuery")
public Page<BookEntity> findBookNoQuery(Integer page,Integer size){

....
}

效果：