java - 重用复杂的 spring-fox swagger 注释

Question

我正在使用 spring-fox2 @ApiImplicitParam 注释使 swagger-ui 显示一个框，用于在请求中包含授权 header :

@ApiImplicitParams({
        @ApiImplicitParam(
                name="Authorization",
                value="authorization header containing the bearer token",
                paramType = "header"
        )
})
public void someControllerMethod() {
    ...
}

这工作正常，但我需要为 Controller 中的每个方法使用此授权 header 。复制和粘贴这是代码味道。我可以为此定义某种快捷方式注释吗？是否有不同的方式告诉 swagger-ui 为授权 header 创建输入字段？

谢谢!

Answer 1

解决您问题的另一种方法是根本不使用注释。而是使用摘要 add global operation parameters见#22。您可以将标题添加到摘要中的所有操作。

这种方法的缺点可能是您最终可能会配置多个摘要，以便您预先选择(请参阅#4、#5、#6)将这些参数添加到哪些操作。