Recentemente solicitamos um serviço para uma empresa parceira, para consultar algumas pessoas. O serviço foi concebido do zero, para atender uma demanda particular do sistema nosso. Este é um serviço Rest simples, usando JSON como retorno.
Porém, o resultado do serviço disponibilizado me chamou a atenção. Veja um exemplo:
{
"73317882484": {
"nome": "Joaquim"
},
"55968857463": {
"nome": "Maria"
}
}
Embora seja um Json válido, o desenvolvedor entendeu que o campo de CPF seria uma espécie de chave para agrupar as demais informações da pessoa. Então, ao invés dele criar um campo "cpf"
com o valor do CPF, ele adotou o próprio CPF como nome do campo. Também, ao invés de criar um array para cada registro, foi devolvido um objeto só.
Tudo indica que o Json retornado foi manipulado, sem ajuda de framework para ser gerado, pois ficaria esquisito mapear este Json para uma classe Java (por exemplo) sem conhecer todos os possíveis retornos de CPF. Enfim, não faz muito sentido.
Eu esperava, como mencionei antes, algo assim:
[
{
"cpf: "73317882484"
"nome": "Joaquim"
},
{
"cpf: "55968857463"
"nome": "Maria"
}
]
A pergunta é: como explicar que o formato mencionado antes não é o adequado para um retorno?
Não achei nenhum tipo de referência sobre este assunto. Em uma breve leitura dinâmica pela RFC também não achei nada associado a isto.
Map<String, Pessoa>
ou algo similar a isso