SpringBoot整合Swagger2代码实例

首先遵循SpringBoot的三板斧

成都创新互联是一家集网站建设,芒康企业网站建设,芒康品牌网站建设,网站定制,芒康网站建设报价,网络营销,网络优化,芒康网站推广为一体的创新建站企业,帮助传统企业提升企业形象加强企业竞争力。可充分满足这一群体相比中小企业更为丰富、高端、多元的互联网需求。同时我们时刻保持专业、时尚、前沿,时刻以成就客户成长自我,坚持不断学习、思考、沉淀、净化自己,让我们为更多的企业打造出实用型网站。

第一步添加依赖



  io.springfox
   springfox-swagger2
     {version}


  io.springfox
     springfox-swaggerui
  {version}

第二步添加注解

@EnableSwagger2 //启动SwaggerUI,在启动类或Swagger配置类上添加该注解

第三步写配置

@Configuration
@EnableSwagger2
public class SwaggerConfig {

  @Bean
  public Docket api() {

/*
    //可以添加多个header或参数
    ParameterBuilder aParameterBuilder = new ParameterBuilder();
    aParameterBuilder
        //参数类型支持header, cookie, body, query etc
        .parameterType("header")
        //参数名
        .name("user-token")
        //默认值
        .defaultValue("t122222")
        .description("用户登录凭证")
        //指定参数值的类型
        .modelRef(new ModelRef("string"))
        //非必需,这里是全局配置
        .required(false).build();
    List aParameters = new ArrayList<>();
    aParameters.add(aParameterBuilder.build());
*/

    return new Docket(DocumentationType.SWAGGER_2)
//    return new Docket(DocumentationType.SPRING_WEB)
        .apiInfo(apiInfo())
        .pathMapping("/")
        .select()// 选择那些路径和api会生成document
        .apis(RequestHandlerSelectors.any())// 对所有api进行监控
        // 不显示错误的接口地址
        .paths(Predicates.not(PathSelectors.regex("/error.*")))// 错误error路径不监控
        .paths(Predicates.not(PathSelectors.regex("/actuator.*")))// 错误error路径不监控
        .paths(PathSelectors.regex("/.*"))// 对根下所有路径进行监控
        .paths(PathSelectors.any())  // 对所有路径进行监控
        // 自行修改为自己的包路径
//        .apis(RequestHandlerSelectors.basePackage("com.happyloves.zc.service.account.api"))
        .build()
//        .globalOperationParameters(aParameters)
        .enable(true);
  }

  private ApiInfo apiInfo() {
    return new ApiInfoBuilder()
        .title("API接口")
        .description("API接口文档")
        //服务条款网址
//        .termsOfServiceUrl("https://www.google.com")
        .version("1.0")
//        .contact(new Contact("啦啦啦", "url", "email"))
        .build();
  }
}

扩展:swagger-bootstrap-ui是springfox-swagger的增强UI实现,为Java开发者在使用Swagger的时候,能拥有一份简洁、强大的接口文档

体验项目地址码云:https://gitee.com/xiaoym/swagger-bootstrap-ui

GitHub: https://github.com/xiaoymin/Swagger-Bootstrap-UI

在线体验:http://swagger-bootstrap-ui.xiaominfo.com/doc.html

代码集成示例

SpringBoot在线demo地址:https://gitee.com/xiaoym/swagger-bootstrap-ui-demo

Spring Mvc在线demo地址:https://gitee.com/xiaoym/swagger-bootstrap-ui-demo/tree/master/swagger-bootstrap-ui-demo-mvc

添加依赖



com.github.xiaoymin
swagger-bootstrap-ui
1.9.6

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持创新互联。


文章标题:SpringBoot整合Swagger2代码实例
本文来源:http://bzwzjz.com/article/ghhcgp.html

其他资讯

Copyright © 2007-2020 广东宝晨空调科技有限公司 All Rights Reserved 粤ICP备2022107769号
友情链接: 重庆网站制作 成都网站建设公司 手机网站制作 网站设计制作 重庆网站制作 重庆网站建设 网站建设 手机网站建设套餐 成都网站设计 成都网站制作 成都网站制作 成都网站建设 定制网站设计 网站设计 网站建设费用 app网站建设 手机网站制作 成都网站建设 网站建设公司 成都网站设计 营销型网站建设 网站制作