JSON para Rust
Gere structs Rust com derives serde a partir de uma amostra JSON. Os nomes dos campos se tornam snake_case e recebem uma renomeação serde quando diferem da chave JSON; campos opcionais e anuláveis viram tipos Option, e valores de tipos mistos viram serde_json::Value. A saída deriva Debug, Clone, PartialEq, Serialize e Deserialize.
Perguntas frequentes
Como os objetos aninhados são nomeados?
Cada objeto aninhado vira seu próprio tipo Rust, nomeado com base na chave que o contém em PascalCase; assim, address vira Address. Objetos dentro de arrays recebem a forma singular da chave do array; por exemplo, users vira User. Objetos com campos exatamente iguais compartilham o mesmo tipo.
Quando um campo é opcional?
Quando um array contém vários objetos e uma chave está ausente em alguns deles, esse campo é opcional: ele vira um Option e é ignorado ao serializar um None. Uma chave presente em todas as amostras é obrigatória. Um único objeto não tem outros com que ser comparado, então todas as suas chaves são obrigatórias.
Como os valores nulos são tratados?
Uma chave que é nula em algumas amostras e tem valor em outras vira um Option do tipo. Se uma chave for sempre nula, a ferramenta não consegue determinar seu tipo real, então ela vira Option<serde_json::Value>; cole uma amostra com um valor real para obter um tipo preciso.
Quais tipos numéricos são usados?
Números inteiros se tornam i64, e números fracionários se tornam f64. Um campo que contém ambos se torna f64. Substitua i64 por u32, u64 ou outro tipo se você souber o intervalo.
O que acontece com chaves que não são nomes válidos?
Os nomes dos campos são convertidos para snake_case e recebem #[serde(rename = "...")] com a chave original sempre que diferem dela. Nomes que são palavras reservadas Rust, como type, recebem um sublinhado no final e uma renomeação, para que a struct continue lendo a chave original.
Meu JSON é enviado ou armazenado?
O JSON é enviado ao servidor apenas para gerar o código desta solicitação e não é armazenado. O gerador lê somente a estrutura e os tipos de valor da sua amostra; por isso, você pode substituir valores confidenciais por marcadores do mesmo tipo antes de colá-la.