如何避免一般的Swagger警告?

时间:2015-12-31 05:50:59

标签: spring swagger-ui swagger-2.0 springfox

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

  

{              “generalSwaggerWarnings”:[                 {                    “swaggerObject”:“#/ definitions / Future«object»”,                    “message”:“定义已定义但未使用:#/ definitions / Future«object»”                 }              ]           }

1 个答案:

答案 0 :(得分:2)

您的方案与我在评论中发布的示例链接略有不同,因为您没有使用嵌套的 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)))
                ;
    }