标签：response 资源 name exce operation 配置 添加用户 一个 end
使用Swagger 可以动态生成Api接口文档，在项目开发过程中可以帮助前端开发同事减少和后端同事的沟通成本，而是直接参照生成的API接口文档进行开发，提高了开发效率。这里以springboot(版本2.1.4.RELEASE)集成swagger2并以简单测试用例延时集成效果。
pom依赖加入swagger
<!--swagger--> <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger2</artifactId> <version>2.9.2</version> </dependency> <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger-ui</artifactId> <version>2.9.2</version> </dependency>
配置文件application.properties可以添加swagger.enabled配置控制是否开启
# 控制开启或关闭swagger
swagger.enabled=true
添加swagger配置类，主要用于配置生成api的相关信息
@Configuration @EnableSwagger2 public class SwaggerConfig { /** * 控制开启或关闭swagger */ @Value("${swagger.enabled}") private boolean swaggerEnabled; @Bean public Docket createRestApi() { return new Docket(DocumentationType.SWAGGER_2) // api基础信息 .apiInfo(apiInfo()) // 控制开启或关闭swagger .enable(swaggerEnabled) // 选择那些路径和api会生成document .select() // 扫描展示api的路径包 .apis(RequestHandlerSelectors.basePackage("com.example.springbootswagger.controller")) // 对所有路径进行监控 .paths(PathSelectors.any()) // 构建 .build(); } /** * @descripiton: * @author: kinson * @date: 2019/9/10 23:33 * @param * @exception： * @modifier： * @return：springfox.documentation.service.ApiInfo */ private ApiInfo apiInfo() { return new ApiInfoBuilder() // api名称 .title("SwaggerUI APIS") // api 描述 .description("Simple Demo About SwaggerUI APIS") // api 版本 .version("1.0") // 构建 .build(); } }
这里的@EnableSwagger2用于让激活swagger，也可以加载启动类上。
添加测试url
@RestController @Api(tags = "测试demo") @RequestMapping(value = "swagger") public class SwaggerController { @ApiOperation(value = "hello", notes = "hello测试api") @GetMapping(value = "hello") public String hello() { return "hello"; } @ApiOperation(value = "add", notes = "路径变量测试") @ApiImplicitParam(name = "swaggerId",value = "测试参数id",required = true, dataType = "Integer", paramType="path") @PostMapping(value = "add/{swaggerId}") public String add(@PathVariable Integer swaggerId) { Assert.notNull(swaggerId, "swaggerId为空"); return swaggerId.toString(); } @ApiOperation(value = "update",notes = "多路径参数变量测试") @ApiImplicitParams({ @ApiImplicitParam(name = "swaggerId",value = "测试参数id",required = true, dataType = "Integer", paramType="path"), @ApiImplicitParam(name = "name",value = "测试参数名称",required = true, dataType = "String", paramType="path")}) @PutMapping(value = "/update/{swaggerId}/{name}") public String update(@PathVariable Integer swaggerId,@PathVariable String name) { return String.valueOf(swaggerId + name); } @ApiOperation(value = "addUser",notes = "对象添加测试") @ApiImplicitParam(name = "user",value = "待添加用户信息",required = true, dataType = "User", paramType="body") @ApiResponse(code = 200, message = "添加成功") @PostMapping(value = "/addUser") public String addUser(@RequestBody User user){ return user.getName(); } }
上述工作加完后就可以启动项目查看效果，打开浏览器访问http://127.0.0.1:8080/swagger-ui.html，如下图则表示集成成功
○ paramType：参数放在哪个地方
§ header-->请求参数的获取：@RequestHeader
§ query-->请求参数的获取：@RequestParam
§ path（用于restful接口）-->请求参数的获取：@PathVariable
§ body（以流的形式提交 仅支持POST）
§ form（以form表单的形式提交 仅支持POST）
○ name：参数名
○ dataType：参数的数据类型 只作为标志说明，并没有实际验证
§ Long
§ String
○ required：参数是否必须传
§ true
§ false
○ value：参数的意义
○ defaultValue：参数的默认值
标签：response 资源 name exce operation 配置 添加用户 一个 end
原文地址：https://www.cnblogs.com/kingsonfu/p/11519728.html
