JEE Rest JSON OPENAPI SWAGGER
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:
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:
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