springboot2.x集成swagger的方法示例

<dependency>
  <groupid>io.springfox</groupid>
  <artifactid>springfox-swagger2</artifactid>
  <version>2.9.2</version>
</dependency>
<!-- swagger-ui -->
<dependency>
  <groupid>io.springfox</groupid>
  <artifactid>springfox-swagger-ui</artifactid>
  <version>${swagger.version}</version>
</dependency>

@configuration
@enableswagger2
public class swaggerconfig {
  /**
   * 创建一个docket对象
   * 调用select()方法，
   * 生成apiselectorbuilder对象实例，该对象负责定义外漏的api入口
   * 通过使用requesthandlerselectors和pathselectors来提供predicate，在此我们使用any()方法，将所有api都通过swagger进行文档管理
   * @return
   */
  @bean
  public docket createrestapi() {
    return new docket(documentationtype.swagger_2)
        .apiinfo(apiinfo())
        .select()
        .apis(requesthandlerselectors.any())
        .paths(pathselectors.any())
        .build();
  }

  private apiinfo apiinfo() {
    return new apiinfobuilder()
        //标题
        .title("spring boot中使用swagger2构建restful apis")
        //简介
        .description("")
        //服务条款
        .termsofserviceurl("")
        //作者个人信息
        .contact(new contact("chenguoyu","","chenguoyu_sir@163.com"))
        //版本
        .version("1.0")
        .build();
  }
}

@configuration
public class webmvcconfig implements webmvcconfigurer {
  @override
  public void addresourcehandlers(resourcehandlerregistry registry) {
    // 解决 swagger-ui.html 404报错
    registry.addresourcehandler("/swagger-ui.html").addresourcelocations("classpath:/meta-inf/resources/");
  }
}

<dependency>
  <groupid>com.github.xiaoymin</groupid>
  <artifactid>swagger-bootstrap-ui</artifactid>
  <version>1.9.3</version>
</dependency>

@configuration
public class webmvcconfig implements webmvcconfigurer {
  @override
  public void addresourcehandlers(resourcehandlerregistry registry) {
    // 解决 swagger-ui.html 404报错
    registry.addresourcehandler("/swagger-ui.html").addresourcelocations("classpath:/meta-inf/resources/");
    // 解决 doc.html 404 报错
    registry.addresourcehandler("/doc.html").addresourcelocations("classpath:/meta-inf/resources/");

  }
}