JSON Swiss

JSON Swiss

Gerador de JSON para Swift

Entrada JSON

Carregando editor…

Swift Gerado

Configuration

Insira dados JSON para gerar structs Swift

Structs com suporte a Codable e type safety

Como converter JSON para Swift – guia passo a passo

Use este gerador JSON para Swift para criar estruturas Codable Swift a partir de amostras JSON para aplicativos iOS/macOS e serviços Swift.

  1. Passo 1 – Cole uma amostra JSON

    • Cole um objeto ou matriz JSON representativo no editor esquerdo.
    • Inclua objetos aninhados, matrizes e campos anuláveis para que os tipos sejam inferidos corretamente.
    • Use Import para carregar JSON de um arquivo, URL ou dados de amostra.

  2. Passo 2 – Escolha as opções de estrutura Swift

    • Defina uma raiz Struct Name (por exemplo Root).
    • Revise como os campos opcionais são mapeados para String? e tipos semelhantes.
    • Confirme a estratégia de mapeamento de chaves quando as chaves JSON não corresponderem às convenções de nomenclatura do Swift.

  3. Passo 3 – Revise o código gerado

    • Verifique nomes de campos, tipos e como matrizes/objetos são modelados.
    • Ajuste opções como Root Type Name, tratamento nulo e estruturas, se disponíveis.
    • Se um campo for inferido incorretamente, ajuste seu JSON de amostra e gere-o novamente.

  4. Passo 4 – Use as estruturas com Codable

    • Adicione as estruturas geradas ao seu projeto e certifique-se de que estejam em conformidade com Codable.
    • Decodifique JSON usando JSONDecoder no tipo raiz.
    • Adicione CodingKeys personalizado ou estratégias de decodificação de data conforme necessário.

  5. Passo 5 – Copiar ou baixar

    • Copie a saída em seu projeto ou baixe-a como um arquivo.
    • Execute seu formatador/linter para corresponder ao seu estilo de código.
    • Adicione bibliotecas de análise/serialização JSON se sua linguagem exigir.

Dicas rápidas

  • Prefira ISO8601DateFormatter/JSONDecoder.dateDecodingStrategy para carimbos de data/hora.
  • Use CodingKeys para conversão de snake_case em camelCase quando necessário.
  • Mantenha as estruturas DTO separadas dos modelos de UI para evitar acoplamento.
Saída de exemplo (simplificada)
// Entrada JSON
{
  "id": 123,
  "name": "Maeve Winters",
  "email": "[email protected]",
  "active": true,
  "roles": ["admin", "editor"],
  "metadata": { "plan": "pro" },
  "createdAt": "2024-03-01T10:15:00Z",
  "score": 99.5,
  "notes": null
}

// Generated Swift models (simplified)
struct Metadata: Codable {
  let plan: String
}

struct Root: Codable {
  let id: Int
  let name: String
  let email: String?
  let active: Bool
  let roles: [String]
  let metadata: Metadata
  let createdAt: String
  let score: Double
  let notes: String?
}

Ferramentas JSON e Swift relacionadas

Explore mais ferramentas JSON e de esquema que funcionam muito bem junto com este gerador JSON para Swift.

Estrutura Swift para JSON e esquema JSON

Converta estruturas Swift existentes em exemplos JSON e esquema JSON para documentos e validação.

Gerador de esquema JSON

Gere um esquema JSON a partir de amostras JSON para validar cargas de API.

Formatador e validador JSON

Formate e valide JSON antes de gerar modelos Swift para evitar problemas de tempo de execução.

Gerador JSON para TypeScript

Gere tipos TypeScript para clientes web que compartilham a mesma API.

Perguntas Frequentes

Quais recursos de Swift são suportados?

O gerador cria structs Swift com boa segurança de tipos, suporta o protocolo Codable para serialização/deserialização JSON, usa tipos optional para valores null e segue convenções de nomenclatura do Swift.

Como o protocolo Codable funciona?

Quando o framework Codable é selecionado, as structs geradas conformam automaticamente ao Codable, permitindo encoding/decoding com JSONEncoder e JSONDecoder.

Como valores optional são tratados?

Valores null no JSON são mapeados para tipos optional (?) em Swift, fornecendo segurança de tipos e exigindo unwrapping explícito, seguindo a abordagem de null safety do Swift.

E quanto ao sistema de tipos do Swift?

O código gerado aproveita o sistema de tipos forte com tipos apropriados (Int, Double, String, Bool, [Any], [String: Any]) e value semantics usando structs como modelos imutáveis.

Gerador de JSON para Swift | JSONSwiss