如何避免一般的 Swagger 警告？

【问题标题】：How to avoid general Swagger Warnings?如何避免一般的 Swagger 警告？
【发布时间】：2015-12-31 05:50:59
【问题描述】：

我将在http://editor.swagger.io/#/ 中验证我的 swagger (v2) 文档，但我收到了关注警告消息。

{ “一般大摇大摆警告”：[ { "swaggerObject": "#/definitions/Future«object»", "message": "定义已定义但未使用：#/definitions/Future«object»" } ] }

【问题讨论】：

尝试使用替代类型规则。您可以看到这个 post 和 SpringFox documentation 第 2.1.3 节 #10 的示例。

标签： spring swagger-ui swagger-2.0 springfox

【解决方案1】：

您的场景与我在评论中发布的示例链接略有不同，因为您没有使用嵌套的 ResponseEntity。所以你的实现会更像这样：

import static springfox.documentation.schema.AlternateTypeRules.newRule;

...

    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
                .alternateTypeRules(
                        newRule(typeResolver.resolve(Future.class),
                                typeResolver.resolve(WildcardType.class)))
                ;
    }

【讨论】：