5

Qual é a maneira correta ou a melhor prática para representar os relacionamentos de um recurso em json? Como exemplo, tenho as tabelas contrato, representante e empresa e os relacionamentos contrato N:1 representante e empresa 1:N representante.

Qual das 3 maneiras seguintes seria a recomendada? Note que na terceira os campos precisam ter um complemento no nome (ex: nome_empresa) e isso é um pouco mais trabalhoso, estou usando desta forma por não usar nenhum ORM.

EDIT: Neste exemplo eu estou querendo consultar um contrato pelo endpoint /contratos/1

Exemplos:

1:

{
    "contrato_id": 1,
    "numero": 123456,
    "representante": {
        "representante_id": 2,
        "nome": "João"
        "empresa": {
            "empresa_id": 3,
            "nome": "Empresa",
        }
    }
}

2:

{
    "contrato_id": 1,
    "numero": 123456
    "representante": {
        "representante_id": 2,
        "nome": "João"
    },
    "empresa": {
        "empresa_id": 3,
        "nome": "Empresa",
    }
}

3:

{
    "contrato_id": 1,
    "numero": 123456
    "representante_id": 2,
    "nome_representante": "João"
    "empresa_id": 3,
    "nome_empresa": "Empresa"
}
5
  • Para que possamos acessar a url você precisa publicar em alguma hospedagem pública, não possuímos acesso ao seu localhost na porta 3000. Commented 14/03/2017 às 12:52
  • Ah, era só pra colocar o endpoint e acabei colocando o endereço inteiro. Corrigido. Commented 14/03/2017 às 12:58
  • Esse endpoint já retorna os dados como JSON? Commented 14/03/2017 às 13:03
  • Sim, está retornando como no terceiro exemplo. Commented 14/03/2017 às 13:04
  • 1
    Está retornando "flat". Essa estrutura do JSON vai seguir a estrutura definida pelo seu backend, hierarquizado de acordo com a sua modelagem de dados. Commented 14/03/2017 às 13:06

2 Respostas 2

7

O correto é o objeto empresa possuir um array de objetos representante, que por sua vez possui um array de objetos contrato:

{
    "empresa": {
        "empresa_id": 1,
        "nome": "Empresa 1",
        "representantes": [{
            "representante_id": 1,
            "nome": "João",
            "contratos": [{
                "contrato_id": 1,
                "numero": 123456
            }, {
                "contrato_id": 2,
                "numero": 654321
            }]
        }, {
            "representante_id": 2,
            "nome": "José",
            "contratos": []
        }]
    }
}
4
  • E quando eu buscar por um contrato específico? Não seria melhor representar ao contrário, trazendo um contrato e dentro dele o representante e a empresa? Commented 14/03/2017 às 12:56
  • Essa pesquisa ficaria a cargo do seu backend, não? Acho que ainda não entendi completamente o seu cenário. Commented 14/03/2017 às 13:04
  • Sim. Por exemplo, quando buscar um contrato, o backend devolve um json com seus dados e dentro deles os dados dos outros recursos relacionados, neste caso, representante e empresa. Quando alguém buscar um contrato é essencial trazer também o nome do representante e da empresa. Então a minha dúvida é qual a forma "correta" de representar os relacionamentos neste json. Utilizando um ORM ele gera um json como no segundo exemplo. Commented 14/03/2017 às 13:12
  • 1
    Entendi. Nesse caso, a navegação ocorre ao contrário: um contrato possui um objeto representante, que possui um objeto empresa. Dessa forma, acredito que a opção 2 seja a mais correta no seu cenário. Commented 14/03/2017 às 13:22
4

Fernando, pensando em acoplamento, acredito que o ideal seria ter 3 conjuntos de informações interligadas.

Imagine que depois quando você precisar alterar informações das entidades Empresa / Cliente / Contrato isso seria menos custoso.

{
    "contrato":{
        "1": {
            "numero": 123456,
            "representante_id": 2,
            "empresa_id": 3
        }
    },
    "representante":{
        "2": {
            "nome": "João"
        }
    },
    "empresa":{
        "3": {
            "nome": "Empresa"
        }   
    }
}
3
  • Entendi. Utilizando o ORM bookshelf.js para node.js ele gera desta forma, com exceção do id, que fica dentro da própria entidade. Desta forma parece fazer mais sentido. Commented 14/03/2017 às 12:57
  • Você não poderia utilizar o bookshelf.js no seu projeto? Commented 14/03/2017 às 13:02
  • Poderia sim, estou refatorando para utilizá-lo, mas surgiu a dúvida se tem algum padrão ou boa prática para seguir. Assim, eu poderia representar da melhor forma um recurso em json independente da ferramenta utilizada. Commented 14/03/2017 às 13:29

Você deve fazer log-in para responder a esta pergunta.

Esta não é a resposta que você está procurando? Pesquise outras perguntas com a tag .