JSON to Go: structs que desempacotam na primeira tentativa

A forma gerada

Um conversor transforma cada objeto JSON em uma estrutura, cada array em uma fatia e infere um tipo Go por valor. Objetos aninhados tornam-se tipos nomeados em vez de blobs anônimos, o que mantém legível a assinatura do seu código de decodificação:

                type Container struct {
  Name  string `json:"name"`
  Image string `json:"image"`
  Ports []struct {
    ContainerPort int `json:"containerPort"`
  } `json:"ports"`
}
              

As tags `json` são a parte importante. O decodificador de Go não diferencia maiúsculas de minúsculas ao combinar nomes de campos, mas `containerPort` e `ContainerPort` não se alinham sem uma tag, e qualquer chave que não seja um identificador Go válido — `app.kubernetes.io/name`, por exemplo — não pode ser correspondida sem uma.

Números, nulos e as duas armadilhas clássicas

• Números — a inferência produz `int` para valores inteiros, mas JSON não tem tipo inteiro. Um campo que é `3` hoje pode ser `3.5` amanhã, então IDs e dinheiro são mais seguros como `float64`, `string` ou `json.Number` dependendo de suas necessidades.
• Nulos — uma chave que pode ser `null` deve ser um ponteiro (`*string`) para que você possa diferenciar “ausente” de “vazio”.
• Timestamps — uma string RFC 3339 é decodificada corretamente em `time.Time`; um número de época Unix não, então mantenha-os como `int64` e converta explicitamente.
• Campos desconhecidos — `json.Decoder` ignora extras por padrão; use `DisallowUnknownFields` quando preferir falhar ruidosamente.

Gere a partir de duas ou três respostas quando puder. Os campos que às vezes faltam tornam-se ponteiros, e essa decisão é muito mais fácil de tomar a partir de evidências do que de memória.

Da estrutura ao código de trabalho

Com as estruturas instaladas, a decodificação é de três linhas e o compilador impõe os caminhos de acesso a partir daí. Um padrão comum é decodificar na estrutura gerada e, em seguida, mapear em seu tipo de domínio para que a forma JSON possa mudar sem se propagar pelo aplicativo. Marque o arquivo gerado com o endpoint de onde ele veio e regenere quando a resposta mudar, em vez de editá-lo manualmente - o código gerado editado manualmente é a versão que ninguém se atreve a gerar novamente mais tarde.

Gerar localmente

As cargas úteis a partir das quais vale a pena gerar estruturas Go geralmente são respostas API reais, e as respostas reais carregam tokens e dados do cliente. Uma conversão JSON to Go baseada em navegador mantém a carga útil na guia — sem upload, sem questão de retenção — o que torna a geração de dados de produção uma etapa normal, em vez de uma exceção de política.