Bonjour

J'ai un projet jee (Wildfly)

je cherche à documenter les schémas json de mes DTO

J'ai annoté avec swagger les services Rest et j'obtient bien la doc openapi 3.0.1
pour chaque service j'ai bien une référence au DTO consommé et/ou produit.
J'ai ensuite dans la doc la définie json schéma de ces DTO

Mais j'aimerais pouvoir préciser des informations sur certaines propriétés des ces DTO

Swagger importe Jackson qui fournis les annotations
@JsonProperty et @JsonPropertyDescrition

Code java : Sélectionner tout - Visualiser dans une fenêtre à part
1
2
3
4
 
   @JsonProperty(required=true, defaultValue="no name")
   @JsonPropertyDescrition("nom de la route conforme à la norme iso-1986-9456-F")
   String name;

cela fonction pour le "required" mais pas pour la descrition le json est
Code javascript : Sélectionner tout - Visualiser dans une fenêtre à part
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
 
{
"required": [
               "name"
            ],
            "type": "object",
            "properties": {
               "id": {
                  "type": "integer",
                  "format": "int32"
               },
...
               "name": {
                  "type": "string"
...
            }}

comment obtenir la description ?

merci
A+JYT