2015-12-31 1 views
0

Je vais valider ma documentation swagger (v2) en http://editor.swagger.io/#/ mais j'ai suivi le message d'avertissement.Comment éviter les avertissements Swagger généraux?

{ "generalSwaggerWarnings": [ { "swaggerObject": "#/définitions/futur«objet»", "message": « La définition est définie mais n'est pas utilisé: #/définitions/Avenir «objet» » } ] }

+0

Essayez d'utiliser une autre règle de type. Vous pouvez voir un exemple avec ce [post] (https://github.com/swagger-api/swagger-core/issues/498#issuecomment-205718626) et le SpringFox [documentation] (https: //springfox.github. io/springfox/docs/current/# dépendances) Section 2.1.3 # 10. –

Répondre

2

Votre scénario est un peu léger différent des exemples de liens que j'ai posté dans mon commentaire puisque vous n'utilisez pas le imbriquée ResponseEntity. Donc, votre implémentation ressemblerait plus ou moins à ceci:

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))) 
       ; 
    }