Mapeamentos JPA - Histórico de revisão

Rodrigogml: /* Campos Date */

2017-06-29T21:12:17Z

Campos Date

← Edição anterior		Edição das 21h12min de 29 de junho de 2017
Linha 26:		Linha 26:

	Campos 'temporais' precisam ter sempre sua precisão definida. No exemplo abaixo:		Campos 'temporais' precisam ter sempre sua precisão definida. No exemplo abaixo:
	* '''venda''' - terá seu tempo completo salvo no banco: Data + Hora
	* '''horasaida''' - terá apenas seu tempo salvo no banco de dados.
	* '''feriado''' - salvará apenas o dia, sem a hora.


	{{java\|Precisão da Data\|<syntaxhighlight lang="java">		{{java\|Precisão da Data\|<syntaxhighlight lang="java">
			// venda - terá seu tempo completo salvo no banco: Data + Hora
	@Temporal(TemporalType.TIMESTAMP)		@Temporal(TemporalType.TIMESTAMP)
	private Date venda = null;		private Date venda = null;

			// horasaida - terá apenas seu tempo salvo no banco de dados.
	@Temporal(TemporalType.TIME)		@Temporal(TemporalType.TIME)
	private Date horasaida = null;		private Date horasaida = null;

			// feriado - salvará apenas o dia, sem a hora.
	@Temporal(TemporalType.DATE)		@Temporal(TemporalType.DATE)
	private Date feriado = null;		private Date feriado = null;

Rodrigogml: /* Mapeamento de Atributos */

2015-05-04T04:17:19Z

Mapeamento de Atributos

← Edição anterior		Edição das 04h17min de 4 de maio de 2015
Linha 10:		Linha 10:
	{{nota\|Annotation @Basic\|Mesmo não sendo necessário inserir nenhuma annotation para os casos mencionados acima costumo colocar a anotação @Basic (que é exatamente o mesmo que não colocar notação alguma) só para deixar explicito para quem lê o código que aquele atributo está mapeado no banco.}}		{{nota\|Annotation @Basic\|Mesmo não sendo necessário inserir nenhuma annotation para os casos mencionados acima costumo colocar a anotação @Basic (que é exatamente o mesmo que não colocar notação alguma) só para deixar explicito para quem lê o código que aquele atributo está mapeado no banco.}}


			{{nota\|Ignorar Atributo\|Em alguns momentos pode ser necessário fazer com que o JPA ignore algum atributo que exista na entidade mas que não queremos que seja persistido, como algum atributo apenas auxiliar para o funcionamento mas que dispensa persistência.
			Neste caso devemos anotar o atributo com a annotation '''@Transient'''!}}

	=== Nome da Coluna ===		=== Nome da Coluna ===

Rodrigogml: /* Campos da Date */

2015-05-04T04:14:40Z

Campos da Date

← Edição anterior		Edição das 04h14min de 4 de maio de 2015
Linha 20:		Linha 20:
	</syntaxhighlight>}}		</syntaxhighlight>}}

	=== Campos da Date ===		=== Campos Date ===

	Campos 'temporais' precisam ter sempre sua precisão definida. No exemplo abaixo:		Campos 'temporais' precisam ter sempre sua precisão definida. No exemplo abaixo:

Rodrigogml: /* Mapeamento de Atributos */

2015-05-04T00:19:53Z

Mapeamento de Atributos

← Edição anterior		Edição das 00h19min de 4 de maio de 2015
Linha 5:		Linha 5:
	== Mapeamento de Atributos ==		== Mapeamento de Atributos ==

			Desde que a entidade (VO) esteja definida como @Entity o JPA tentará mapear automaticamente qualquer atributo da entidade no banco de dados. O JPA consegue mapear sozinho os atributos mais comuns como String, Integer, Float, Long, Boolean, etc. que não precisam de nenhuma transformação.


			{{nota\|Annotation @Basic\|Mesmo não sendo necessário inserir nenhuma annotation para os casos mencionados acima costumo colocar a anotação @Basic (que é exatamente o mesmo que não colocar notação alguma) só para deixar explicito para quem lê o código que aquele atributo está mapeado no banco.}}


			=== Nome da Coluna ===

			Se nenhum nome de coluna for especificado o JPA tentará procurar uma coluna com o nome exato do atributo. Se não for o caso será necessário especificar uma annotation para indicar para o JPA esse mapeamento. No exemplo abaixo mapeamos o atributo "name" do VO à coluna "st_nome" do banco de dados.

			{{java\|Nome da Coluna do Banco\|<syntaxhighlight lang="java">
			@Column(name="st_nome")
			private String name = null;
			</syntaxhighlight>}}

			=== Campos da Date ===

			Campos 'temporais' precisam ter sempre sua precisão definida. No exemplo abaixo:
			* '''venda''' - terá seu tempo completo salvo no banco: Data + Hora
			* '''horasaida''' - terá apenas seu tempo salvo no banco de dados.
			* '''feriado''' - salvará apenas o dia, sem a hora.


			{{java\|Precisão da Data\|<syntaxhighlight lang="java">
			@Temporal(TemporalType.TIMESTAMP)
			private Date venda = null;

			@Temporal(TemporalType.TIME)
			private Date horasaida = null;

			@Temporal(TemporalType.DATE)
			private Date feriado = null;
			</syntaxhighlight>}}

	== Mapeamento Entre Objetos ==		== Mapeamento Entre Objetos ==

Rodrigogml: Criou página com 'A camada de persistência do BIS é atualmente desenvolvida com base no JPA e uma estrutura própria do BISCore que simplifica a criação de DAOs. A implementação JPA utili...'

2015-03-20T13:59:35Z

Criou página com 'A camada de persistência do BIS é atualmente desenvolvida com base no JPA e uma estrutura própria do BISCore que simplifica a criação de DAOs. A implementação JPA utili...'

Página nova

A camada de persistência do BIS é atualmente desenvolvida com base no JPA e uma estrutura própria do BISCore que simplifica a criação de DAOs. A implementação JPA utilizada atualmente é a nativa do Glassfish: a EclipseLink.

Esta página tem o objetivo de exemplificar os diferentes tipos de mapeamentos entre objetos e tipos diferentes de campos para servir como guia rápido de consulta para os desenvolvedores.

== Mapeamento de Atributos ==

== Mapeamento Entre Objetos ==

{{nota|Elementos Orfãos de Mapeamentos|Note que por padrão o JPA não exclui os elementos que foram simplesmente removidos da lista/coleção do seu pai. Algumas implementações oferecem essa opção, como o próprio Hibernate que oferece a opção "delete-orphan".
No entanto essa opção não funcionará no BIS, pois fora da camada de persistência (DAOs) os objetos já foram completamente desanexados, o que o impede de monitorar e remover os objetos filhos.
A lógica de remoção dos filhos não mais utilizados deve ser realizada no CRUD. Caso contrário o filho permanecerá no banco e anexado ao elemento pai.
É recomendável também que essa análise e exclusão dos filhos não mais utilizados seja feita antes de outras alterações e persistência do objeto pai no banco para evitar inconsistência e "lock".}}

=== OneToMany - carregado em um Map ===
Imagine o objeto SchedulerVO, este tem uma coleção de SchedulerPropertyVO. Como mostram as tabelas abaixo:

[[File:OneToManyDBSchema.jpg|center]]

{{java|SchedulerVO|<syntaxhighlight lang="java5">
@OneToMany(cascade = CascadeType.ALL, orphanRemoval = true, mappedBy = "schedulervo", fetch = FetchType.EAGER)
@MapKey(name = "name")
private Map<String, SchedulerPropertyVO> properties = new HashMap<String, SchedulerPropertyVO>();
</syntaxhighlight>}}

{{java|SchedulerPropertyVO|<syntaxhighlight lang="java5">
@ManyToOne(cascade = CascadeType.REFRESH, optional = false, fetch = FetchType.LAZY)
@JoinColumn(name = "idcore_scheduler")
public SchedulerVO schedulervo = null;
</syntaxhighlight>}}

=== OneToMany - carregado em uma List ===
Imagine o objeto SchedulerVO, este tem uma coleção de SchedulerPropertyVO. Como mostram as tabelas abaixo:

[[File:OneToManyDBSchema.jpg|center]]

{{java|SchedulerVO|<syntaxhighlight lang="java5">
@OneToMany(cascade = CascadeType.ALL, orphanRemoval = true, mappedBy = "schedulervo", fetch = FetchType.EAGER)
private List<SchedulerPropertyVO> properties = new ArrayList<SchedulerPropertyVO>();
</syntaxhighlight>}}

{{java|SchedulerPropertyVO|<syntaxhighlight lang="java5">
@ManyToOne(cascade = CascadeType.REFRESH, optional = false, fetch = FetchType.LAZY)
@JoinColumn(name = "idcore_scheduler")
public SchedulerVO schedulervo = null;
</syntaxhighlight>}}