Spring + Springfox + Header参数

Question

@RequestMapping(...)
public Foo getFoo(@HeaderParam("header") final String header) {
    ...
}

像上面那样添加一个@HeaderParam方法参数，springfox将获取它，当我查看swagger-ui时，它有一个用于标头的字段。这正是我想要的。有没有一种方法可以让springfox在一组方法中包含这个头参数，而不需要在方法本身中包含参数？我们真正要做的是一个使用头的servlet过滤器，我们希望通过swagger-ui轻松地设置它。

Answer 1

您可以在摘要定义中使用globalOperationParameters。例如

new Docket(...)
            .globalOperationParameters(
        Arrays.asList(new ParameterBuilder()
            .name("header")
            .description("Description of header")
            .modelRef(new ModelRef("string"))
            .parameterType("header")
            .required(true)
            .build()))

有关详细信息，请参阅文档中的#22。

Answer 2

对于同样的问题，又有一个解释答案：

@Bean
    public Docket api() {
        //Adding Header
        ParameterBuilder aParameterBuilder = new ParameterBuilder();
        aParameterBuilder.name("headerName").modelRef(new ModelRef("string")).parameterType("header").required(true).build();
        List<Parameter> aParameters = new ArrayList<Parameter>();
        aParameters.add(aParameterBuilder.build());
        return new Docket(DocumentationType.SWAGGER_2).select()
                .apis(RequestHandlerSelectors.any()).paths(PathSelectors.any()).build().apiInfo(apiInfo()).pathMapping("").globalOperationParameters(aParameters);
    }