Mapeando Relacionamentos entre Entidades JPA. Prof. Fellipe Aleixo

Transcrição

1 Mapeando Relacionamentos entre Entidades JPA Prof. Fellipe Aleixo

2 Relacionamento entre Entidades É natural em um modelo de domínio termos relacionamento entre classes conceituais Como os relacionamentos do modelo de objetos são mapeados para o modelo relacional? Importante lembrar como duas tabelas são relacionadas no modelo relacional Uma mesma coluna é definida em duas tabelas, os valores dessa coluna definem o relacionamento JPA permite mapear tais relacionamentos

3 Tipos de Relacionamento 1. Unidirecional de um para um Ex.: um usuário com um endereço 2. Bidirecional de um para um Ex.: um empréstimo com uma devolução 3. Unidirecional de um para muitos Ex.: um usuário com um número de telefone 4. Bidirecional de um para muitos Ex.: uma editora com um livro

4 Tipos de Relacionamento 5. Unidirecional de muitos para um Ex.: um empréstimos com um atendente 6. Unidirecional de muitos para muitos Ex.: uma reserva com um livro 7. Bidirecional de muitos para muitos Ex.: um autor com um livro

5 Relacionamento Unidirecional de Um para Um Exemplo: um usuário possui um endereço O usuário conhece o endereço, mas o endereço não conhece a qual usuário pertence

6 Relacionamento Unidirecional de Um para Um Modelo de Programação: Navegação em apenas uma via um dos beans de entidade define uma propriedade que permite que ele obtenha o outro bean por relacionamento No nosso exemplo, a classe Usuario existirão os métodos getendereco() e setendereco() para acessar a entidade Endereco Vejamos a seguir o mapeamento necessário na classe Usuario

7 Relacionamento Unidirecional de Um para Um package public class Usuario implements java.io.serializable { private ENDERECO_ID ) public Endereco getendereco() { return endereco; public void setendereco(endereco novo) { endereco = novo;

8 Relacionamento Unidirecional de Um para Um Interface JoinColumn: Semelhante à Ex.: define a coluna da tabela CLIENTE que referencia a chave primária de tabela ENDERECO JoinColumn { String name() default ; String referencedcolumnname() default ; boolean unique() default false; boolean nullable() default true; boolean insertable() default true; boolean updatable() default true; String columndefinition() default ; String table() default ;

9 Relacionamento Unidirecional de Um para Um Interface OneToOne: OneToOne { Class targetentity() default void.class; CascadeType[] cascade() default {; FetchType fetch() default EAGER; boolean optional() default true; String mappedby() default ; targetentity: entidade com a qual há um relacionamento (descoberto pela propriedade) fetch: carregamento sob demanda ou imediato

10 Relacionamento Unidirecional de Um para Um Interface OneToOne: optional: especifica se o relacionamento pode ser nulo cascade: especifica o mecanismo de propagação de ações (remoções, atualizações, etc.) mappedby: usado para relacionamentos bidirecionais

11 Relacionamento Unidirecional de Um para Um Equivalente em XML: <entity-mappings> <entity class= exemplo.biblioteca.modelo.usuario access= PROPERTY > <attributes> <id name= id > <generated-value/> </id> <one-to-one name= endereco targetentity= exemplo.bilioteca.modelo.endereco fetch= LAZY optional= true > <cascade>all</cascade> <join-column name= ENDERECO_ID /> </one-to-one> </attributes> </entity> </entity-mappings>

12 Relacionamento Unidirecional de Um para Um O mapeamento podem ser feito usando-se valores iguais para as chaves das public class Usuario implements java.io.serializable { private public Endereco getendereco() { return endereco; public void setendereco(endereco novo) { endereco = novo;

13 Relacionamento Unidirecional de Um para Um Mapeamento de relacionamento padrão: package public class Usuario implements java.io.serializable { private Endereco public Endereco getendereco() { return endereco; public void setendereco(endereco novo) { endereco = novo;

14 Relacionamento Bidirecional de Um para Um Em determinados relacionamentos é necessário o conhecimento nos dois sentidos Um empréstimo conhece a devolução associada e a devolução sabe a qual empréstimo ela é referente No banco de dados os esquemas são equivalentes ao relacionamento unidirecional No modelo relacional não há a noção de direção dos relacionamentos

15 Relacionamento Bidirecional de Um para Um Esquema relacional segundo o exemplo: Para mapear o relacionamento entre as entidades Emprestimo e Devolucao, precisamos declarar as respectivas propriedades nas classes bean

16 Relacionamento Bidirecional de Um para public class Emprestimo implements java.io.serializable { private int id; private date dataemprestimo; private boolean ativo; private DEVOLUCAO_ID ) public Devolucao getdevolucao() { return devolucao; public void setdevolucao(devolucao novo) { devolucao = novo;

17 Relacionamento Bidirecional de Um para public class Devolucao implements java.io.serializable { private int id; private date datadevolucao; private Emprestimo devolucao ) public Emprestimo getemprestimo() { return emprestimo; public void setemprestimo(emprestimo novo) { emprestimo = novo;

18 Relacionamento Bidirecional de Um para Um Nos relacionamentos bidirecionais há o conceito de entidade possuidora do relacionamento No exemplo a entidade possuidora do relacionamento é Emprestimo O método setemprestimo() da entidade Devolucao não causa alteração no relacionamento Para alterar o empréstimo ao qual está associada uma devolução: Executaríamos o método setdevolucao() da entidade Emprestimo original passando null E depois executar o método setdevolucao() da nova entidade Emprestimo

19 Relacionamento Bidirecional de Um para Um Mapeamento de relacionamento public class Emprestimo implements java.io.serializable { private int id; private date dataemprestimo; private boolean ativo; private Devolucao public Devolucao getdevolucao() { return devolucao; public void setdevolucao(devolucao novo) { devolucao = novo;

20 Relacionamento Bidirecional de Um para Um Mapeamento de relacionamento public class Devolucao implements java.io.serializable { private int id; private date datadevolucao; private Emprestimo devolucao ) public Emprestimo getemprestimo() { return emprestimo; public void setemprestimo(emprestimo novo) { emprestimo = novo;

21 Relacionamento Unidirecional de Um para Muitos Na prática, um relacionamento de um para muitos unidirecional geralmente é mapeado com uma tabela de junção intermediária

22 Relacionamento Unidirecional de Um para Muitos Para o mapeamento deste tipo de relacionamento é utilizada a OneToMany { Class targetentity() default void.class; CascadeType[] cascade() default {; FetchType fetch() default LAZY; String mappedby() default ;

23 Relacionamento Unidirecional de Um para public class Usuario implements java.io.serializable { private Collection<Telefone> telefones = USUARIO_ID ) public Collection<Telefone> gettelefones() { return telefones; public void setendereco(collection<telefone> nova) { telefones = nova;

24 Relacionamento Unidirecional de Um para public class Telefone implements java.io.serializable { private int id; private String ddd; private String numero; private int tipo; // Construtor padrão requerido public public int getid() { return id;

25 Relacionamento Unidirecional de Um para Muitos Um outro mapeamento possível para este tipo de relacionamento é através de uma tabela de JoinTable { String name() default ; String catalog() default ; String schema() default ; JoinColumn[] joincolumns() default {; JoinColumn[] inversejoincolumns() default {; UniqueContraint[] uniqueconstraints() default {;

26 Relacionamento Unidirecional de Um para public class Usuario implements java.io.serializable { private Collection<Telefone> telefones = USUARIO_TELEFONE, joincolumns={@joincolumn(name= USUARIO_ID ), inversejoincolumns={@joincolumn(name= TELEFONE_ID )) public Collection<Telefone> gettelefones() { return telefones;

27 Relacionamento Unidirecional de Um para Muitos Mapeamento de relacionamento padrão: package public class Usuario implements java.io.serializable { private Collection<Telefone> telefones = new public Collection<Telefone> gettelefones() { return telefones;

28 Relacionamento Unidirecional de Muitos para Um Ocorre quando vários beans de entidade referenciam um único bean de entidade, mas o bean ignora esse relacionamento

29 Relacionamento Unidirecional de Muitos para Um Exemplo: cada empréstimo tem o conhecimento de qual atendente o realizou, mas atendente não necessita conhecer todos os empréstimos que realizou

30 Relacionamento Unidirecional de Muitos para Um Relacionamentos de muitos para um são descritos com a As definições de atributo são semelhantes àquelas da ManyToOne { Class targetentity() default void.class; CascadeType[] cascade() default {; FetchType fetch() default EAGER; boolean optional() default true; No caso do exemplo: será incluída uma propriedade Atendente na entidade Emprestimo

31 Relacionamento Unidirecional de Muitos para Um A entidade Atendente não sofre public class Emprestimo implements java.io.serializable { private int id; private Date dataemprestimo; private ATENDENTE_ID ) public Atendente getatendente() { return atendente; public void setatendente(atendente nova) { atendente = nova; 31

32 Relacionamento Unidirecional de Muitos para Um Mapeamento de relacionamento public class Emprestimo implements java.io.serializable { private int id; private Date dataemprestimo; private boolean ativo; private Atendente public Atendente getatendente() { return atendente; public void setatendente(atendente nova) { atendente = nova;

33 Relacionamento Bidirecional de Um para Muitos Perceba que um relacionamento bidirecional de muitos para um é equivalente ao relacionamento bidirecional de um para muitos Um bean de entidade mantém uma propriedade de relacionamento baseada em coleção de outro bean de entidade Cada bean de entidade na coleção mantém uma referência de volta ao bean agregador Exemplo: é interessante que uma editora conheça os livros que publicou, e que o livro também conheça qual editora que o publicou

34 Relacionamento Bidirecional de Um para Muitos Vejamos o esquema de banco de dados relacional equivalente:

35 Relacionamento Bidirecional de Um para Muitos A programação do lado muitos public class Livro implements java.io.serializable { private int id; private String titulo; private String isbn; private EDITORA_ID ) public Editora geteditora() { return editora; public void seteditora(editora nova) { editora = nova;

36 Relacionamento Bidirecional de Um para Muitos A programação do lado um public class Editora implements java.io.serializable { private int id; private String nome; private Collection<Livro> livros = new editora ) public Collection<Livro> getlivros() { return livros; public void setlivros(collection<livro> novos) { livros = novos;

37 Relacionamento Bidirecional de Um para Muitos Como todo relacionamento bidirecional, deve haver um lado possuidor do relacionamento Atualmente a JPA requer que o lado muitos seja o possuidor do relacionamento Significado dessa limitação no exemplo: Para mudar (e que essa mudança seja refletida no banco de dados) o relacionamento de uma Editorae um Livro deve usar o seteditora() de Livro

38 Relacionamento Bidirecional de Muitos para Muitos Ocorre quando muitos beans mantêm uma propriedade de relacionamento baseada em coleção com um outro bean de entidade E cada bean referenciado nessa coleção mantém uma propriedade de relacionamento baseado em coleção de volta aos beans agregadores Exemplo: um dado livro pode possuir vários autores e um autor pode ter escrito vários livros

39 Relacionamento Bidirecional de Muitos para Muitos Esquema de banco de dados relacional:

40 Relacionamento Bidirecional de Muitos para Muitos Os relacionamentos são logicamente definidos com a ManyToMany { Class targetentity() default void.class; CascadeType[] cascade() default {; FetchType fetch() default LAZY; String mappedby() default ;

41 Relacionamento Bidirecional de Muitos para Muitos A entidade Autor deverá definir uma propriedade coleção de entidades public class Autor implements java.io.serializable { private int id; private String nome; private Set<Livro> livros = LIVRO_AUTOR, joincolumns={@joincolumn(name= AUTOR_ID ), inversejoincolumns={@joincolumn(name= LIVRO_ID )) public Set<Livro> getlivros() { return livros; public void setlivros(set<livro> novos) { livros = novos;

42 Relacionamento Bidirecional de Muitos para Muitos O relacionamento livros é declarado como uma java.uitil.set O tipo Set não armazena objetos duplicados Como ocorre nos demais relacionamentos bidirecionais há um lado possuidor Nesse caso a entidade Autor Como possuidor do relacionamento pode definir a tabela de junção a ser utilizada

43 Relacionamento Bidirecional de Muitos para Muitos Mapeamento de relacionamento padrão na entidade public class Autor implements java.io.serializable { private int id; private String nome; private Set<Livro> livros = new public Set<Livro> getlivros() { return livros; public void setlivros(set<livro> novos) { livros = novos;

44 Relacionamento Bidirecional de Muitos para Muitos A entidade Livro deverá definir uma propriedade coleção de entidades public class LIvro implements java.io.serializable { private int id; private String titulo; private String isbn; private Collection<Autor> autores = new livros ) public Collection<Autor> getautores() { return autores; public void setautores(collection<autor> novos) { autores = novos;

45 Relacionamento Unidirecional de Muitos para Muitos Ocorre quando muitos beans mantêm um relacionamento baseado em coleção com um outro bean Mas, o referido bean na coleção não mantém um relacionamento baseado em coleção de volta aos beans agregadores Exemplo: uma reserva pode ser realizada para vários livros, e embora que um mesmo livro possa ser reservado mais de uma vez ele não precisa conhecer tais reservas

46 Relacionamento Unidirecional de Muitos para Muitos Vejamos o esquema de banco de dados relacional equivalente:

47 Relacionamento Unidirecional de Muitos para Muitos O campo de relacionamento baseado em coleção de Livro é adicionado em public class Reserva implements java.io.serializable { private int id; private Date datareserva; private Usuario usuario; private Set<Livro> livros = RESERVA_LIVRO, joincolumns={@joincolumn(name= RESERVA_ID ), inversejoincolumns={@joincolumn(name= LIVRO_ID )) public Set<Livro> getlivros() { return livros; public void setlivros(set<livro> novos) { livros = novos;

48 Relacionamento Unidirecional de Muitos para Muitos A entidade Livro não é alterada em nada Mapeamento de relacionamento public class Reserva implements java.io.serializable { private int id; private Date datareserva; private Usuario usuario; private Set<Livro> livros = new public Set<Livro> getlivros() { return livros; public void setlivros(set<livro> novos) { livros = reservas ) public Usuario getusuario() { return usuario; public void setusuario(usuario novo) { usuario = novo;

49 Relacionamentos Baseados em Lista Ordenada Podem ser utilizadas as interfaces: List, Set, Map e Collection (java.util.*) para mapear relacionamentos baseados em coleção Particularidades do uso de List: Representa uma coleção não ordenada e que permite duplicatas Pode possibilitar a capacidade adicional de ordenar os elementos da coleção com base em um conjunto específico de critérios Permite declarar uma cláusula JPQL caso não seja especificado: valerá a ordem crescente da chave primária

50 Relacionamentos Baseados em Lista public class Reserva implements java.io.serializable { private int id; private Date datareserva; private Usuario usuario; private List<Livro> livros = isbn ASC RESERVA_LIVRO, joincolumns={@joincolumn(name= RESERVA_ID ), inversejoincolumns={@joincolumn(name= LIVRO_ID )) public List<Livro> getlivros() { return livros; public void setlivros(list<livro> novos) { livros = novos;

51 Relacionamentos Baseados em Mapas Particularidades do uso de Map: O provedor de persistência cria um mapa com chave sendo uma propriedade específica da entidade relacionada e o valor como sendo a própria entidade O atributo name() indica o nome da propriedade da entidade a ser usado como chave no mapa Se o name() não for especificado é usada a chave primária da entidade como chave no mapa

52 Relacionamentos Baseados em public class Usuario implements java.io.serializable { private Map<String, Telefone> telefones = new USUARIO_ID numero ) public Map<String, Telefone> gettelefones() { return telefones; public void setlivros(map<string, Telefone> novos) { telefones = novos;

53 Entidades Desacopladas e FetchType Ao trabalhar com entidades relacionadas devemos lembrar alguns detalhes: 1. quando recuperamos uma dada entidade alguns relacionamentos podem não ter sido inicializados 2. essa entidade pode ser desacoplada quando terminar o contexto de persistência 3. se a propriedade do relacionamento for acessada quando a entidade estiver desacoplada geralmente temos uma exceção ou uma resposta incorreta

54 Propagação de Operações Sobre Entidades em Cascata Nas anotações de relacionamento vimos que existe o atributo cascade() Esse atributo permite configurar que operações realizadas sobre um entidade sejam propagadas em cascata para as entidades associadas Exemplo: ao persistir um Usuario, podemos estar persistindo seu o Endereco e seus Telefones Operações que podem ser propagadas em cascata (CascadeType): ALL, PERSIST, MERGE, REMOVE e REFRESH

55 Propagação de Operações Sobre Entidades em Cascata CascadeType.PERSIST A persistência de uma entidade deverá gerar a persistência das entidades relacionadas Exemplo: persistência de um Usuario CascadeType.MERGE A atualização em uma entidade deverá gerar a atualização das entidades relacionadas O estado da entidade e de suas entidades relacionadas é sincronizado com o banco de dados

56 Propagação de Operações Sobre Entidades em Cascata CascadeType.REMOVE A remoção de uma entidade causa a remoção das entidades relacionadas CascadeType.REFRESH O estado da entidade e de suas entidades relacionadas é atualizado com informações armazenadas no banco de dados CascadeType.ALL Combinação de todas as diretivas anteriores