四步五分钟Spring4快速集成Swagger

如果你所在的公司的还没有使用swagger甚至没有听说过swagger，赶快学习一下我的这篇博客吧，五分钟速成，傻瓜式的集成，但就是这么简单的应用一定会让他们震惊到的。

首先对swagger做一个简介吧：swagger是后台开发的神器，也是前后端交流的渠道。你可以用swagger做什么？首先，你以后基本可以告别单元测试了；其次，你不用再写接口文档了，也不需要写完之后再去对文档进行维护了。swagger可以完全模拟http请求，入参出参和实际情况差别几乎为零。说了这些，直接来干货吧！

集成四部曲：

第一步：导入两个依赖吧，如果你不是maven项目，那你去找找jar包吧，记住只需要两个，我看别的教程引入了七八个，简直是浪费。

  io.springfox
  springfox-swagger2
  2.6.1


  io.springfox
  springfox-swagger-ui
  2.6.1

第二步：添加一个类（拷贝下面的即可，注意修改包名，地址）

@EnableWebMvc
@EnableSwagger2
@Configuration
public class SwaggerConfig {

  @Bean
  public Docket createRestApi() {
    return new Docket(documentationType.SWAGGER_2)
 .apiInfo(apiInfo())
 .select()
 .apis(RequestHandlerSelectors.basePackage("com.z*.b*.c*.controller")) 
 // 注意修改此处的包名
 .paths(PathSelectors.any())
 .build();
  }

  private ApiInfo apiInfo() {
    return new ApiInfoBuilder()
 .title("接口列表 v1.1.0") // 任意，请稍微规范点
 .description("接口测试") // 任意，请稍微规范点
 .termsOfServiceUrl("http://url/swagger-ui.html") 
 // 将“url”换成自己的ip:port
.contact("laowu") // 无所谓（这里是作者的别称）
 .version("1.1.0")
 .build();
  }
}

第三步：在mvc的配置的文件中添加下面配置，可能你的文件也许是叫 dispatcher.xml！（照抄即可，完全不需要修改）

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持考高分网。