Generatore classe Scala → JSON Schema

Input Codice Scala

Caricamento editor…

Output JSON Schema

Impostazioni

Seleziona quale case class deve essere trattata come root del JSON Schema.

Il parsing avviene interamente nel tuo browser. Il sorgente non lascia mai la pagina.

Incolla le tue case class Scala per produrre JSON Schema istantaneamente.

Supporta Option[T], collezioni, mappe, case class annidate e valori di default.

Come convertire case class Scala in JSON Schema – guida passo‑passo

Questo convertitore online case class Scala → JSON Schema ti aiuta a generare JSON Schema da modelli reali (DTO, struct e classi) per validare payload, condividere contratti e generare JSON mock.

  1. Passo 1 – Incolla il sorgente Scala

    • Incolla i modelli che vuoi documentare nell’editor di sinistra.
    • Includi i tipi referenziati nello stesso snippet in modo che lo schema possa generare le definizioni.
    • Usa il pulsante Esempio per caricare un esempio e vedere il formato atteso.
  2. Passo 2 – Seleziona il Tipo root (se necessario)

    • Se vengono rilevate più definizioni, scegli la root che corrisponde al payload della tua API.
    • Lo schema di output è costruito attorno alla root selezionata e può includere definizioni aggiuntive per i tipi referenziati.
  3. Passo 3 – Controlla l’output JSON Schema

    • Verifica tipi, campi richiesti vs opzionali e strutture annidate di oggetti/array.
    • Cerca definitions e $ref quando i tuoi modelli fanno riferimento ad altri modelli.
    • Copia o scarica lo schema per validazione, documentazione o sviluppo schema‑first.
  4. Passo 4 – Valida o genera JSON mock

    • Fai clic su Genera dati mock per aprire il generatore di mock con lo schema pre‑caricato.
    • Valida payload reali rispetto allo schema per intercettare breaking change in anticipo.
    • Se usi composizione avanzata dello schema (ad esempio anyOf/oneOf/allOf), verifica il risultato con un validatore completo come Ajv.

Nota sul supporto delle keyword dello schema

Gli schemi generati possono includere $ref e possono essere modificati per includere anyOf, oneOf, o allOf. Per schemi complessi, usa un validatore JSON Schema completo e dereferenzia prima della generazione dei mock se necessario.

Strumenti correlati per JSON Schema e generazione di codice

Usa questi strumenti per validare schemi, generare payload mock, formattare esempi JSON e mantenere allineati codice e contratti.

Domande frequenti

Quali tipi Scala sono supportati?

Il convertitore legge case class e classi regolari con parametri nel costruttore. Gestisce Option[T], collezioni (List/Seq/Vector/Array/Set), mappe, valori di default e tipi primitivi di base. Le case class annidate sono supportate se presenti nello stesso snippet.

Come funziona l’inferenza dei tipi?

I tipi primitivi (String, Int, Long, Double, Boolean, BigDecimal, Instant, UUID, ecc.) mappano a primitivi JSON Schema con formati. Le collezioni diventano array, le mappe diventano oggetti e Option[T] rende i campi opzionali. Tipi sconosciuti ricadono su string a meno che non esista un’altra case class con lo stesso nome.

Supporta Scala 3 e sintassi più vecchia?

Sì. Finché la definizione segue la sintassi standard di case class, lo strumento la parserizza. La conversione avviene interamente nel browser, quindi il codice resta privato.

Come creo dati JSON mock?

Dopo aver generato lo schema, fai clic su "Genera dati mock" per aprire il Mock Generator con lo schema pre‑caricato. Configura locale, dimensioni array e campi opzionali per creare payload di esempio istantaneamente.

Generatore classe Scala → JSON Schema | JSONSwiss