Générateur Java Class → JSON Schema

Entrée Code Java

Chargement de l’éditeur…

Sortie JSON Schema

Paramètres

Choisissez quelle classe doit être traitée comme racine lors de la génération du schéma.

Le parsing s’exécute entièrement dans votre navigateur. Votre code ne quitte jamais la page.

Collez vos classes Java pour produire du JSON Schema instantanément.

Support des collections, objets imbriqués, Maps et annotations populaires.

Comment convertir classes et records Java en JSON Schema — guide pas à pas

Ce convertisseur en ligne (Java class → JSON Schema) vous aide à générer du JSON Schema à partir de modèles réels (DTOs, structs et classes) pour valider des payloads, partager des contrats et générer du mock JSON.

  1. Étape 1 – Collez votre source Java

    • Collez les modèles à documenter dans l’éditeur de gauche.
    • Incluez les types référencés dans le même snippet afin de générer les definitions.
    • Utilisez le bouton Exemple pour charger un exemple et voir le format attendu.
  2. Étape 2 – Sélectionnez la Classe racine (si besoin)

    • Si plusieurs definitions sont détectées, choisissez la racine qui correspond à votre payload d’API.
    • Le schéma de sortie est construit autour de la racine sélectionnée et peut inclure des definitions supplémentaires.
  3. Étape 3 – Vérifiez la sortie JSON Schema

    • Contrôlez types, champs requis vs optionnels, et structures imbriquées d’objets/arrays.
    • Surveillez definitions et $ref lorsque vos modèles référencent d’autres modèles.
    • Copiez ou téléchargez le schéma pour validation, documentation ou approche schema-first.
  4. Étape 4 – Valider ou générer du mock JSON

    • Cliquez sur Générer des données mock pour ouvrir le générateur de mock avec votre schéma préchargé.
    • Validez des payloads réels avec votre schéma pour détecter tôt les breaking changes.
    • Si vous utilisez une composition avancée (par ex. anyOf/oneOf/allOf), vérifiez le résultat avec un validateur complet comme Ajv.

Note sur le support des mots-clés

Les schémas générés peuvent inclure $ref et peuvent être édités pour ajouter anyOf, oneOf, ou allOf. Pour des schémas complexes, utilisez un validateur JSON Schema complet et dereferencez avant génération de mock si nécessaire.

Outils liés à JSON Schema et à la génération de code

Utilisez ces outils pour valider des schémas, générer des payloads mock, formater des exemples JSON et synchroniser code et contrats.

Questions fréquentes

Quels types de code Java sont supportés ?

Le convertisseur comprend POJOs, classes Lombok, records, builders et DTOs avec objets imbriqués, génériques, arrays, Lists/Sets et Maps. Il lit des annotations comme @JsonProperty, @SerializedName, @JsonInclude et des hints nullable pour aligner nommage et optionnalité.

Quelle est la précision de la détection de types ?

Wrappers (Integer, Double, Boolean…), types temporels Java, enums, Optionals et collections génériques sont mappés vers des équivalents JSON Schema. Si l’info manque (ex. List sans génériques), on affiche un warning et on applique des defaults raisonnables.

Comment générer du mock JSON à partir du schéma ?

Après génération du schéma, cliquez sur "Générer des données mock" pour ouvrir le Générateur de Mock avec le schéma préchargé. Vous pourrez configurer locale, tailles d’array et produire des payloads réalistes.

Comment choisir la classe racine s’il y en a plusieurs ?

Ouvrez les settings et sélectionnez une classe dans le dropdown. Par défaut, la première classe publique est choisie, mais vous pouvez basculer à tout moment sans recharger la page.

Générateur Java Class → JSON Schema | JSONSwiss