zoukankan      html  css  js  c++  java
  • Swagger2 添加HTTP head参数

    https://blog.csdn.net/u014044812/article/details/71473226

    大家使用swagger往往会和JWT一起使用,而一般使用jwt会将token放在head里,这样我们在使用swagger测试的时候并不方便,因为跨域问题它默认不能自定义head参数。然后自己去网上找,发现国内大多数的都是写一个Filter接口,然后添加到配置。这样极大的破坏了程序的完整性。想想这相当于维护两套代码。我们只是需要一个简单的小功能,国外大多是修改Swagger的index页面,而我用的是swagger2,不需要配置静态的那些东西。

    所以我在SwaggerConfig.api()方法中添加了前4行代码,然后调用.globalOperationParameters(pars)方法将head参数添加进去:

    @EnableSwagger2
    @EnableWebMvc
    @ComponentScan("com.g.web")
    public class SwaggerConfig {
    @Bean
    public Docket api(){
    //添加head参数start
    ParameterBuilder tokenPar = new ParameterBuilder();
    List<Parameter> pars = new ArrayList<Parameter>();
    tokenPar.name("x-access-token").description("令牌").modelRef(new ModelRef("string")).parameterType("header").required(false).build();
    pars.add(tokenPar.build());
    //添加head参数end


    return new Docket(DocumentationType.SWAGGER_2)
    .select()
    .apis(RequestHandlerSelectors.any())
    .paths(PathSelectors.regex("/api/.*"))
    .build()
    .globalOperationParameters(pars)
    .apiInfo(apiInfo());
    }


    private ApiInfo apiInfo() {
    return new ApiInfoBuilder()
    .title("后台接口文档与测试")
    .description("这是一个给app端人员调用server端接口的测试文档与平台")
    .version("1.0.0")
    .termsOfServiceUrl("http://terms-of-services.url")
    //.license("LICENSE")
    //.licenseUrl("http://url-to-license.com")
    .build();
    }
    }

    然后前台效果是这样的:

     


     

    如果有问题请在下面留言

  • 相关阅读:
    JS实例
    第一章 机器学习基础
    事件与信号
    微信公众号开发实例
    php学记笔记之函数用途
    php漏洞修复 禁用函数
    删除MYSQL账号多于的空用户
    MySql 建表、添加字段、修改字段、添加索引SQL语句写法
    php对二维数据进行排序
    iis支持IPA和APK文件下载
  • 原文地址:https://www.cnblogs.com/liuqiyun/p/11928289.html
Copyright © 2011-2022 走看看