java - 如何使用Springfox在swagger2中添加自定义注释？

我正在使用swagger2，我想创建新的@ApiSepecificationInfo批注，这应该在swagger2 doc的自动生成器中考虑(就像我打Gradlw generatordoc一样)

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface ApiSpecificationInfo {
   String name();
   String description();
}

请让我这有可能吗？

最佳答案

您可以通过实现springfox plugins进行自定义注释处理。

如果实现了OperationBuilderPlugin接口(interface)，springfox将为您提供所需的所有信息。

@Component
@Order(SwaggerPluginSupport.SWAGGER_PLUGIN_ORDER)
public class OperationBuilderPluginImpl implements OperationBuilderPlugin {

    @Override
    public void apply(OperationContext context) {
        Optional<ApiOperation> methodAnnotation = context.findAnnotation(ApiSpecificationInfo.class);
        if (methodAnnotation.isPresent()) {
            ApiSpecificationInfo apiSpecificationInfo = methodAnnotation.get();
            // do your processing here
            context.operationBuilder().notes(apiSpecificationInfo.name());
        }
    }

    @Override
    public boolean supports(DocumentationType delimiter) {
        return SwaggerPluginSupport.pluginDoesApply(delimiter);
    }
}

请参阅github以供引用。