Вы можете добавить глобальные рабочие параметры в вашей конфигурации Docket
, как это было сделано в последней строке - .globalOperationParameters(operationParameters())
,
Я показываю более широкую конфигурацию, но вы должны сосредоточиться на этом вопросе только на последней строке.
@Bean
public Docket swaggerPlugin() {
return new Docket(DocumentationType.SWAGGER_2)
.select()
.paths(PathSelectors.any())
.apis(Predicates.or(
RequestHandlerSelectors
.basePackage(....),
RequestHandlerSelectors
.basePackage(....)))
.build().directModelSubstitute(LocalDate.class, String.class)
.genericModelSubstitutes(ResponseEntity.class)
.apiInfo(apiInfo())
.securitySchemes(Lists.newArrayList(apiKey()))
.securityContexts(Arrays.asList(securityContext()))
.globalOperationParameters(operationParameters());
}
private List<Parameter> operationParameters() {
List<Parameter> headers = new ArrayList<>();
headers.add(new ParameterBuilder().name("HEADER_1")
.description("HEADER_1 DESC")
.modelRef(new ModelRef("string")).parameterType("header")
.required(false).build());
headers.add(new ParameterBuilder().name("HEADER_2")
.description("HEADER_2 DESC")
.modelRef(new ModelRef("string")).parameterType("header")
.required(false).defaultValue("0").build());
return headers;
}
Как показано, значение по умолчанию также может быть предоставлено.Кроме того, эти два заголовка будут отображаться в интерфейсе Swagger, поскольку текстовые поля и значения можно вводить вручную для каждого запроса.