Input JSON

Output Swift

Cos'è JSON in Swift?

Stai costruendo un'app iOS o macOS che chiama una REST API? Riceverai JSON — ma Swift ha bisogno di structs Codable espliciti per decodificarlo in modo sicuro. Scrivere quegli structs a mano per ogni endpoint API è ripetitivo e soggetto a errori. Questo strumento genera automaticamente structs Swift dal tuo JSON, completi di conformità Codable. Incolla semplicemente una risposta di esempio e otterrai tipi pronti per JSONDecoder immediatamente.

La conversione viene eseguita nel tuo browser. Puoi impostare il nome della struct e abilitare Usa Codable e Tipi Opzionali. Nulla viene inviato a un server. I tipi generati sono un punto di partenza per progetti iOS, macOS o Swift lato server.

Quando JSON in Swift è utile

Quando sviluppi app iOS o macOS che consumano REST API, genera qui struct Codable. Usa JSONDecoder per il parsing. Incolla una risposta di esempio per ottenere modelli tipizzati.

Come usare questo strumento

1

Incolla o carica JSON

Incolla il tuo JSON nell'editor sinistro o carica un file. Usa Esempio per dati di esempio. Imposta il Nome Struct radice nella configurazione. Abilita Usa Codable per la conformità Codable e Tipi Opzionali per i campi opzionali.

2

Rivedi i tipi generati

Il pannello di destra mostra struct o classi Swift. Gli oggetti annidati diventano tipi annidati. Usa JSONDecoder().decode(YourType.self, from: data) per il parsing. Aggiungi CodingKeys se le chiavi JSON differiscono dai nomi delle proprietà. Per JSON non valido, usa prima il Validatore JSON.

3

Copia o scarica

Usa Copia o Scarica. Per formattare prima il JSON, usa il Formattatore JSON. Per la validazione, usa il Validatore JSON.

Esempi JSON in Swift

Ecco un esempio di generazione di struct Swift da un oggetto JSON.

Esempio: Record abbonato

Input JSON:

Input

Output Swift generato:

Output

Quando JSON in Swift è utile

Quando sviluppi app iOS o macOS che consumano REST API, hai bisogno di tipi Swift per il payload della risposta. Incollare qui una risposta di esempio ti dà struct Codable da usare con URLSession o Alamofire. Swift lato server (Vapor, Kitura) beneficia dello stesso flusso di lavoro.

Domande frequenti

Cos'è un struct Codable in Swift?

Codable è un typealias per Encodable & Decodable. Un struct Codable può essere convertito da/verso JSON usando il JSONDecoder e JSONEncoder integrati di Swift. È il modo moderno e consigliato per gestire JSON nelle app iOS e macOS. Vedi la guida Codable di Apple.

Come decodifico JSON in Swift?

Crea un struct Codable che corrisponda al tuo JSON, poi chiama JSONDecoder().decode(YourType.self, from: data). Genera lo struct qui — incolla il tuo JSON e copia il risultato nel tuo progetto Xcode.

Struct vs classe per i modelli JSON in Swift?

Gli structs sono tipi valore e sono preferiti per DTO e modelli JSON in Swift — sono più semplici, thread-safe e funzionano bene con Codable. Usa le classi quando hai bisogno di semantica di riferimento o ereditarietà.

I miei dati JSON vengono inviati a un server?

No. La generazione di structs viene eseguita interamente nel tuo browser. Il tuo JSON non lascia mai il tuo dispositivo, quindi è sicuro per chiavi API o payload sensibili.

Posso usarlo con Alamofire?

Sì. Il responseDecodable(of: YourType.self) di Alamofire funziona con qualsiasi tipo Codable. Genera lo struct qui e collegalo direttamente al tuo handler di risposta Alamofire.

Strumenti correlati

Swift Codable. JSONDecoder. Specifica JSON. RFC 8259. MDN.