Swagger2 添加HTTP head参数

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

[html] view plain copy

1. window.swaggerUi = new SwaggerUi({  
2.             discoveryUrl: "http://pathtomyservice.com/resources",  
3.                 headers: { "testheader" : "123" },  
4.                 apiKey: "123",  
5.                 apiKeyName: "Api-Key",  
6.                 dom_id:"swagger-ui-container",  
7.                 supportHeaderParams: true,  
8.                 supportedSubmitMethods: ['get', 'post', 'put', 'delete'],  
9.                 onComplete: function(swaggerApi, swaggerUi){  
10.                     if(console) {  
11.                         console.log("Loaded SwaggerUI");  
12.                         console.log(swaggerApi);  
13.                         console.log(swaggerUi);  
14.                     }  
15.                   $('pre code').each(function(i, e) {hljs.highlightBlock(e)});  
16.                 },  
17.                 onFailure: function(data) {  
18.                     if(console) {  
19.                         console.log("Unable to Load SwaggerUI");  
20.                         console.log(data);  
21.                     }  
22.                 },  
23.                 docExpansion: "none"  
24.             });  

supportHeaderParams默认为false，而我用的是swagger2，不需要配置静态的那些东西，所以我是这样写的：

[java] view plain copy

1. @Bean  
2.     public Docket api(){  
3.         ParameterBuilder tokenPar = new ParameterBuilder();  
4.         List<Parameter> pars = new ArrayList<Parameter>();  
5.         tokenPar.name("x-access-token").description("令牌").modelRef(new ModelRef("string")).parameterType("header").required(false).build();  
6.         pars.add(tokenPar.build());  
7.         return new Docket(DocumentationType.SWAGGER_2)  
8.             .select()  
9.             .apis(RequestHandlerSelectors.any())  
10.             .paths(PathSelectors.regex("/api/.*"))  
11.             .build()  
12.             .globalOperationParameters(pars)  
13.             .apiInfo(apiInfo());  
14.     }  

前四行代码是添加head参数的，前台效果是这样的：

如果有问题请在下面留言