Generatore classe Ruby → JSON Schema

Input Codice Ruby

Caricamento editor…

Output JSON Schema

Impostazioni

Seleziona quale classe 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 classi Ruby per produrre JSON Schema istantaneamente.

Supporta dichiarazioni attr_accessor/attr_reader, classi annidate e metodi ignorati.

Come convertire classi Ruby in JSON Schema – guida passo‑passo

Questo convertitore online classe Ruby → 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 Ruby

    • 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 Classe 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 costrutti Ruby sono supportati?

Il parser si concentra su classi che espongono attributi tramite dichiarazioni attr_reader/attr_accessor. Ogni attributo diventa una proprietà nello schema. Metodi e altro codice Ruby vengono ignorati, così puoi incollare classi modello in sicurezza.

Come vengono tipizzati gli attributi?

Poiché Ruby è dinamico, gli attributi vengono impostati a `string` nello schema. Puoi affinare i tipi fornendo default letterali; aggiornamenti futuri leggeranno commenti di tipo. Per ora lo strumento fornisce uno schema strutturale rapido per DTO.

Perché usare questo strumento?

Quando condividi oggetti di dominio Ruby o DTO in stile ActiveModel con altri team, un JSON Schema aiuta a documentare payload e validare contratti. Questo convertitore gira interamente nel browser.

Come ottengo payload JSON mock?

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

Generatore classe Ruby → JSON Schema | JSONSwiss