java - Spring boot可复用springdoc-openapi参数注解

Question

我有几个 Controller 类，它们都需要 header 参数。为了记录 swagger，我将此 @Parameter 注释添加到我的所有端点:

    @Parameter(in = ParameterIn.HEADER, description = "some description", name = "some name", content = @Content(schema = @Schema(allowableValues = {VALUE1, VALUE2, VALUE3, VALUE4})))
    @GetMapping
    public void method(@RequestHeader .....) {
    //some code here
    }

问题是我不喜欢在所有 Controller 方法上重复相同的注释的想法。这里有一个很好的干净的解决方案来提供可重用的注释吗？

Answer 1

所以部分修复是创建我自己的自定义界面，如下所示:

@Target({PARAMETER, METHOD, FIELD, ANNOTATION_TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Inherited
@Parameter(in = ParameterIn.HEADER, description = "some description", name = "some name", content = @Content(schema = @Schema(allowableValues = {VALUE1, VALUE2, VALUE3, VALUE4})))
public @interface MyCustomAnnotation {
}

这样我就可以重用它并保存一些代码。问题是某些值不同时。例如，如果端点之间的 allowedValues 不同，我就无法重用该端点。我不知道如何将一些参数传递给自定义注释以覆盖默认值...