码迷,mamicode.com
首页 > 编程语言 > 详细

Springfox集成swagger实战篇

时间:2020-04-13 16:43:26      阅读:165      评论:0      收藏:0      [点我收藏+]

标签:body   隐藏   success   常用   ping   图片   ppi   hand   笔记   

一   引入maven依赖

技术图片
compile ‘io.springfox:springfox-swagger2:2.9.2‘
compile ‘io.springfox:springfox-swagger-ui:2.9.2‘
compile "io.springfox:springfox-bean-validators:2.9.2"
技术图片

 编写配置文件

技术图片
package com.wxbc.constant;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Import;
import springfox.bean.validators.configuration.BeanValidatorPluginsConfiguration;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.ParameterBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.schema.ModelRef;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.service.Parameter;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

import java.util.ArrayList;
import java.util.List;

@Configuration
@EnableSwagger2
@Import(BeanValidatorPluginsConfiguration.class)
public class Swagger2 {
@Bean
public Docket createRestApi() {
         return new Docket(DocumentationType.SWAGGER_2)
.select()
.apis(RequestHandlerSelectors.any())
.paths(PathSelectors.any())
.build();
    }

private ApiInfo apiInfo() {
return new ApiInfoBuilder().title("test平台端").description("可以直接访问的接口")
.version("0.1")
.build();
}

}
技术图片

三 启动项目访问http://localhost:9079/swagger-ui.html

效果图如下:

技术图片

 

 

 

 

 四 Swagger2常用注解介绍

常用注解: 
- @Api()用于类; 
表示标识这个类是swagger的资源 , 一般作用于Controller上 

@Api(tags = "(查询类api)")


- @ApiOperation()用于方法; 
表示一个http请求的操作 ,一般作用于接收http请示的方法上
- @ApiParam()用于方法,参数,字段说明; 
表示对参数的添加元数据(说明或是否必填等) 
- @ApiModel()用于类 
表示对类进行说明,用于参数用实体类接收 ,一般作用于@RequestBody的类上


- @ApiModelProperty()用于方法,字段 
表示对model属性的说明或者数据操作更改 

- @ApiIgnore()用于类,方法,方法参数 

表示这个方法或者类被忽略 
- @ApiImplicitParam() 用于方法 
表示单独的请求参数 
- @ApiImplicitParams() 用于方法,包含多个 @ApiImplicitParam

 

技术图片
@ApiOperation(value = "test", notes = "test2",
response = Response.class)
@PostMapping("/query")
public Response queryTransferDetail(@Valid @RequestBody QueryDetailPara para) throws ParameterException {

return Response.success();
}
技术图片

 

 

@ApiModel()用于类 ;表示对类进行说明,用于参数用实体类接收 
value–表示对象名 
description–描述 
都可省略 
@ApiModelProperty()用于方法,字段; 表示对model属性的说明或者数据操作更改 
value–字段说明 
name–重写属性名字 
dataType–重写属性类型 
required–是否必填 
example–举例说明 
hidden–是否对前端隐藏

技术图片
@Data
@ApiModel
public class QueryDetailPara extends BaseInfo {

@NotBlank(message = "project不能为空")
@ApiModelProperty(value = "项目来源",required = true,example = "rhine3")
@Size(min = 1,max = 65)
private String project;

@Max(100)
@Min(10)
@ApiModelProperty(value = "用户年龄",allowableValues = "range[1,11]")
private Integer age;

@Max(100)
@Min(10)
@ApiModelProperty(value = "用户年龄")
private Integer age1;


@Max(100)
@Min(10)
@ApiModelProperty(value = "用户年龄",allowableValues = "10,100,1000")
private Integer age2;

}
技术图片

 

JSR 303:Bean Validation  允许您注释Java类的字段以声明约束和验证规则。您可以使用以下规则注释单个字段: - 不能为空,最小值,最大值,正则表达式匹配等。

一点说明:

1. @Max @Min注解 只能作用于Integer类的整形约束

2. 如果要修释字符串的长度,使用@Size注解 

3.如果有些数据项需要枚举值,可使用allowableValues,有三种写法,

   i)  allowableValues="test1,test2,test3"

  ii)  allowableValues="range[1,11]"

  具体查看源码:

 /**
     * Limits the acceptable values for this parameter.
     * <p>
     * There are three ways to describe the allowable values:
     * <ol>
     * <li>To set a list of values, provide a comma-separated list.
     * For example: {@code first, second, third}.</li>
     * <li>To set a range of values, start the value with "range", and surrounding by square
     * brackets include the minimum and maximum values, or round brackets for exclusive minimum and maximum values.
     * For example: {@code range[1, 5]}, {@code range(1, 5)}, {@code range[1, 5)}.</li>
     * <li>To set a minimum/maximum value, use the same format for range but use "infinity"
     * or "-infinity" as the second value. For example, {@code range[1, infinity]} means the
     * minimum allowable value of this parameter is 1.</li>
     * </ol>
     */
    String allowableValues() default "";

 

4. 使用allowableValues属性会导致@Max @Min及@Size注解失效。

 

此文章纯属学习笔记,如有什么不足之处请在下方留言,我一会竭力改进

Springfox集成swagger实战篇

标签:body   隐藏   success   常用   ping   图片   ppi   hand   笔记   

原文地址:https://www.cnblogs.com/xifenglou/p/12692211.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!