现在大家一般都是使用SpringBoot写RESTful接口, 但是在测试带有token的请求的时候, 就有点难受了. 传统的PostMan就有点让人炸毛了. 但是现在Swagger出现了.(SpringBoot简直和Swagger是天作之和)
swagger的整合细节就不在这里说了, 下面进入正题:
@Configuration
public class Swagger2Config {
@Bean
public Docket createRestApi() {
//添加head参数配置start
ParameterBuilder tokenPar = new ParameterBuilder();
List<Parameter> pars = new ArrayList<>();
tokenPar.name("Authorization").description("令牌").modelRef(new ModelRef("string")).parameterType("header").required(false).build();
pars.add(tokenPar.build());
//添加head参数配置end
return new Docket(DocumentationType.SWAGGER_2)
.apiInfo(apiInfo())
.select()
.apis(RequestHandlerSelectors.basePackage("com.cinsc.MainView.ctr"))
.paths(PathSelectors.any())
.build()
.globalOperationParameters(pars);//注意这里
}
private ApiInfo apiInfo() {
return new ApiInfoBuilder()
.title("springboot利用swagger构建api文档")
.description("束手就擒--简单优雅的restfun风格")
.termsOfServiceUrl("https://blog.csdn.net/ssjq123")
.version("1.0")
.build();
}
}
效果图:
多出来一个 Authorization,在里面放token就行了.