[Java] Spring Boot整合Swagger测试api构建全纪录

• 执行简单的api测试
  
• 生成openapi文档
  
• 探索新的api功能
  

<!--swagger服务api构建个性包-->
<dependency>
 <groupid>io.springfox</groupid>
 <artifactid>springfox-swagger2</artifactid>
 <version>2.6.1</version>
</dependency>
<!--swagger ui界面-->
<dependency>
 <groupid>io.springfox</groupid>
 <artifactid>springfox-swagger-ui</artifactid>
 <version>2.6.1</version>
</dependency>
<!--springboot web服务-->
<dependency>
 <groupid>org.springframework.boot</groupid>
 <artifactid>spring-boot-starter-web</artifactid>
</dependency>
<!--springboot单元测试-->
<dependency>
 <groupid>org.springframework.boot</groupid>
 <artifactid>spring-boot-starter-test</artifactid>
 <scope>test</scope>
</dependency>

@configuration
@enableswagger2
public class swaggerconfig {
@bean
public docket createrestapi() {
  return new docket(documentationtype.swagger_2).apiinfo(apiinfo())
   .select()
   .apis(requesthandlerselectors.basepackage("com.simple.spring.boot.controller"))
   .paths(pathselectors.any()).build();
}
private apiinfo apiinfo() {
 return new apiinfobuilder()
  .title("spring boot中使用swagger2构建restful apis")
  .description("myapp")
  .termsofserviceurl("http://blog.csdn.net/simplewu")
  .version("1.0").build();
 }
}

@springbootapplication
@componentscan(basepackages={"com.simple.spring.boot.controller"}) 
public class swaggerapplication {
 public static void main(string[] args) {
  springapplication.run(swaggerapplication.class, args);
 }
}

@restcontroller
@api(tags = "swgger测试服务", description = "swgger测试服务")
@requestmapping(value = "/simple/wu")
public class testcontroller {
 
 @apioperation(value="测试post方法", notes="测试post方法")
 @apiimplicitparam(name = "令牌", value = "id", required = true, datatype = "token")
 @requestmapping(value="hello", method=requestmethod.post)
 public string post(@requestbody string token) {
  books.put(book.getid(), book);
  return "success";
 }
}

• @api(tags = "swgger测试服务", description = "swgger测试服务") 指定某个类提供服务的名字
  
• @apioperation(value="测试post方法", notes="测试post方法") 指定某个请求的名字
  
• @apiimplicitparam(name = "令牌", value = "token", required = true, datatype = "string")指定名字对应参数为令牌，以及对应参数字段token，required = true代表这个参数为必填参数，datatype 代表数据类型。