Springboot中集成Swagger2框架的方法

概述摘要：在项目开发中，往往期望做到前后端分离，也就是后端开发人员往往需要输出大量的服务接口，接口的提供方无论是是Java还是PHP等语言，往往会要花费一定的精力去写接口文档，比如A接口的地址、需要传递参数情况、

摘要：在项目开发中，往往期望做到前后端分离，也就是后端开发人员往往需要输出大量的服务接口，接口的提供方无论是是Java还是PHP等语言，往往会要花费一定的精力去写接口文档，比如A接口的地址、需要传递参数情况、返回值的JsON数据格式以及每一个字段说明、当然还要考虑http请求头、请求内容等信息。随着项目的进度快速高速的迭代，后端输出的接口往往会面临修改、修复等问题，那也意味着接口文档也要进行相应的调整。接口文档的维护度以及可读性就大大下降。

既然接口文档需要花费精力去维护，还要适当的进行面对面交流沟通，我们何不想一个办法，第一：可以不用写接口文档；第二：前端与后端沟通接口问题的时候，后端是否可以提供一个URL，在这个URL中罗列出所有可以调用的服务接口，并在每个服务接口中罗列出参数的说明，返回值的说明，第三：后端接口如果能模拟调用就所有问题都解决了。本文我们重点讲解一下Sringboot中集成Swagger2框架。

1.1. 添加Swagger2依赖

在项目的pom.xml文件中增加如下的依赖。

<dependency> <groupID>io.springfox</groupID> <artifactID>springfox-swagger2</artifactID> <version>2.7.0</version></dependency><dependency> <groupID>io.springfox</groupID> <artifactID>springfox-swagger-ui</artifactID> <version>2.7.0</version></dependency>

首先，我们需要建立一个启动类，代码如下：

@SpringBootApplicationpublic class Application { public static voID main(String[] args) { SpringApplication.run(Application.class,args); }}

然后在上述类的同级目录中新建swagger2的配置类如下所示：

@Configuration@EnableSwagger2public class Swagger2 {  @Bean  public Docket createRestAPI() {    return new Docket(documentationType.SWAGGER_2)        .APIInfo(APIInfo())        .select()        .APIs(RequestHandlerSelectors.basePackage("com.shareniu.web"))        .paths(PathSelectors.any())        .build();  }  private APIInfo APIInfo() {    return new APIInfoBuilder()        .Title("跟着分享牛学习Springboot源码分析系列课程")        .description("更多Spring Boot相关文章请关注分享牛的博客")        .termsOfServiceUrl("http://www.shareniu.com/")        .contact("牛牛")        .license("copyright 2017-2018 分享牛")        .version("1.0")        .build();  }}

@Configuration制定了spring要加载这个类，@EnableSwagger2注解要开启Swagger功能。

上述中的APIInfo最终都会展现在前端，我们使用了扫描包的方式配置配置，也就是RequestHandlerSelectors.basePackage。在这个包以及子包中的控制器最终都是生成api文档。（除了被@APIIgnore注解指定的请求）。

1.2. 新增文档说明

上述的类声明之后，我们其实就可以直接调用了，但是为了增加文档的可读性，我们还是需要在接口中增加一些说明，我们先写一个控制器如下所示：

@RestController@RequestMapPing(value="/users")public class UserController {  static Map<Long,User> users = Collections.synchronizedMap(new HashMap<Long,User>());  static {   User user = new User();   user.setAge(18);   user.setID(1L);   user.setname("aa");   users.put(1L,user);  }  @APIOperation(value="获取所有用户列表",notes="")  @RequestMapPing(value={""},method=RequestMethod.GET)  public List<User> getUserList() {    List<User> r = new ArrayList<User>(users.values());    return r;  }  @APIOperation(value="创建新的用户",notes="根据User对象创建用户")  @APIImplicitParam(name = "user",value = "用户详细实体user",required = true,dataType = "User")  @RequestMapPing(value="",method=RequestMethod.POST)  public String postUser(@Requestbody User user) {    users.put(user.getID(),user);    return "success";  }  @APIOperation(value="获取用户详细信息",notes="根据url的ID来获取用户详细信息")  @APIImplicitParam(name = "ID",value = "用户ID",dataType = "Long")  @RequestMapPing(value="/{ID}",method=RequestMethod.GET)  public User getUser(@PathVariable Long ID) {    return users.get(ID);  }  @APIOperation(value="更新用户详细信息",notes="根据url的ID来指定更新对象")  @APIImplicitParams({      @APIImplicitParam(name = "ID",dataType = "Long"),@APIImplicitParam(name = "user",dataType = "User")  })  @RequestMapPing(value="/{ID}",method=RequestMethod.PUT)  public String putUser(@PathVariable Long ID,@Requestbody User user) {    User u = users.get(ID);    u.setname(user.getname());    u.setAge(user.getAge());    users.put(ID,u);    return "success";  }  @APIOperation(value="删除已存在的用户",notes="根据url的ID来指定删除对象")  @APIImplicitParam(name = "ID",method=RequestMethod.DELETE)  public String deleteUser(@PathVariable Long ID) {    users.remove(ID);    return "success";  }}

 @APIOperation：用来描述该接口的作用。可以通过该注解说明接口的职责、返回头信息、方法的请求方式（"GET","head","POST","PUT","DELETE","OPTIONS" and "PATCH"）、协议（ http,https,ws,wss）、http状态码。
@APIImplicitParam：用来给参数增加说明。可以设置参数的名称、是否是必填项、参数的描述信息、是否只读等。

上述代码提交之后，启动springboot，访问http://127.0.0.1:8080/swagger-ui.html，如下图所示： 

上图分为两个部分，上部分是通过Swagger2类配置出来的，下半部分是UserController类中的接口文档。
这里我们以/user为例进行说明：

点击/user如下图所示： 

上图黄色的地方表示，该接口返回的样例数据。也就是User的数据结构。Response Content Type：接口返回的头信息。点击Try it out。如下所示： 

该接口返回的baody、code码、响应头已经成功返回了。

总结

以上所述是小编给大家介绍的Springboot中集成Swagger2框架的方法，希望对大家有所帮助，如果大家有任何疑问请给我留言，小编会及时回复大家的。在此也非常感谢大家对编程小技巧网站的支持！

总结

以上是内存溢出为你收集整理的Springboot中集成Swagger2框架的方法全部内容，希望文章能够帮你解决Springboot中集成Swagger2框架的方法所遇到的程序开发问题。

如果觉得内存溢出网站内容还不错，欢迎将内存溢出网站推荐给程序员好友。