BISDAO Legacy - Histórico de revisão

Rodrigogml: Rodrigogml moveu a página BISDAO para BISDAO Legacy sem deixar um redirecionamento: Nova página do BISDAO criado para a v10

2018-07-23T14:41:51Z

Rodrigogml moveu a página BISDAO para BISDAO Legacy sem deixar um redirecionamento: Nova página do BISDAO criado para a v10

← Edição anterior	Edição das 14h41min de 23 de julho de 2018
(Sem diferença)

Rodrigogml: /* Mapeamentos JPA */

2017-07-04T20:13:54Z

Mapeamentos JPA

@@ Linha 57: / Linha 57: @@
 === Composição ===
 === Associação ===
@@ Linha 67: / Linha 93: @@
 {{java|CompanyVO|<syntaxhighlight lang="java">
 @ManyToOne(cascade = CascadeType.REFRESH, fetch = FetchType.LAZY, optional = true)
 @JoinColumn(name = "idcore_locationcity")
 private LocationCityVO locationcityvo = null;
 </syntaxhighlight>}}

Rodrigogml: /* ManyToOne */

2017-06-30T15:39:05Z

ManyToOne

← Edição anterior		Edição das 15h39min de 30 de junho de 2017
Linha 66:		Linha 66:
	[[File:AssManyToOne.jpg\|center\|frame\|ManyToOne entre CompanyVO.locationcityvo e LocationCityVO]]		[[File:AssManyToOne.jpg\|center\|frame\|ManyToOne entre CompanyVO.locationcityvo e LocationCityVO]]

	{{java\|~~Exemplo ManyToOne~~\|<syntaxhighlight lang="java">		{{java\|CompanyVO\|<syntaxhighlight lang="java">
	@BISMetaRelationshipField(caption = "Município", required = false, relationship = RelationshipTypes.ASSOCIATION)		@BISMetaRelationshipField(caption = "Município", required = false, relationship = RelationshipTypes.ASSOCIATION)
	@ManyToOne(cascade = CascadeType.REFRESH, fetch = FetchType.LAZY, optional = true)		@ManyToOne(cascade = CascadeType.REFRESH, fetch = FetchType.LAZY, optional = true)

Rodrigogml: /* Tratamento do Relacionamentos das Entidades */

2017-06-30T15:35:25Z

Tratamento do Relacionamentos das Entidades

@@ Linha 20: / Linha 20: @@
 Este tópico relaciona o comportamento do BISDAO com às entidades relacionadas à entidade principal. Mas lembre-se que não cabe ao BISDAO realizar validações, o objeto que chega aqui deve estar pronto para ser persistido, para validar consulte o [[BISValidator]].
-O BISDAO se orienta pelas annotations do JPA e do [[BISMeta]], logo seu correto funcionamento depende da informação correta informada nessas annotations. Veja a sessão de exemplos nesta página.
+O BISDAO se orienta pelas annotations do JPA e do [[BISMeta Annotations]], logo seu correto funcionamento depende da informação correta informada nessas annotations. Veja a sessão de exemplos nesta página.
 === Inserção ===
@@ Linha 51: / Linha 51: @@
 Para evitar isso sempre que obtiver um objeto para manipulação e para atualização no banco de dados '''''sempre''''' utilize o método '''findForUpdate()''' disponibilizado pelo BISDAO. Este método fará uma varredura automática no objeto e retornará sempre o objeto completo. De forma que se submetido logo em seguida para atualização nenhuma alteração será feita.}}

Rodrigogml: /* Tratamento do Relacionamentos das Entidades */

2017-06-29T22:51:39Z

Tratamento do Relacionamentos das Entidades

← Edição anterior		Edição das 22h51min de 29 de junho de 2017
Linha 17:		Linha 17:

	== Tratamento do Relacionamentos das Entidades ==		== Tratamento do Relacionamentos das Entidades ==

			Este tópico relaciona o comportamento do BISDAO com às entidades relacionadas à entidade principal. Mas lembre-se que não cabe ao BISDAO realizar validações, o objeto que chega aqui deve estar pronto para ser persistido, para validar consulte o [[BISValidator]].

			O BISDAO se orienta pelas annotations do JPA e do [[BISMeta]], logo seu correto funcionamento depende da informação correta informada nessas annotations. Veja a sessão de exemplos nesta página.

			=== Inserção ===

			Ao inserir uma nova entidade no banco de dados o BISDAO simplesmente fará a inserção em cascata de todos as entidades de composição, e a associação dos IDs das entidades associadas.


			=== Atualização ===

			A atualização é uma operação um tanto mais delicada pois já temos informações persistidas no banco de dados e temos de garantir que nenhum "lixo" ficará no banco ao persistir um objeto. Inclusive desfazer relacionamentos que antes existiam e agora não existem mais, e em caso de relacionamentos de composição que deixaram de existir deve excluir os objetos filhos (deletar os objetos órfãos). Assim:

			* O BIS atualizará os atributos da entidade como de costume;
			* Atributos com relacionamento de '''composição''':
			** Caso o objeto no banco ainda '''não tenha''' um relacionamento, deixamos o JPA criar a nova entidade;
			** Caso o objeto no banco já '''tenha''' um relacionamento, e:
			*** O novo objeto tem um relacionamento, verificamos:
			**** Se ambos têm o mesmo ID, deixamos seguir para que o JPA atualize o mesmo objeto;
			**** Se não tem ID, excluímos o objeto do relacionamento atual do banco e deixamos que o JPA insira o novo;
			**** Se o ID for diferente, CriticalException, já que IDs não são aceitos para inserir um novo objeto!
			* Atributos com relacionamento de '''associação''':
			** CriticalException caso o objeto não tenha um ID definido.


			Todos os relacionamentos do tipo '''composição''' serão analisados e persistidos recursivamente conforme as regras acima.


			{{stop\|findForFullUpdate\|Note que a ausência de relacionamento é tratado pelo BISDAO como "sem relacionamento" e não como "não mexer neste relacionamento". Por isso ao enviar um objeto para o BISDAO todos os relacionamentos de composição devem ser carregados recursivamente, já os relacionamentos de associação devem ser informados no mínimo com o ID do objeto.

			Assim, se carregar um objeto de forma incompleta e o enviar para atualizar, o BISDAO removerá as associações e ainda excluirá as composições não mais utilizadas. Um carregamento incompleto pode ocorrer por exemplo se o objeto que seja atualizado em diversas partes do sistema sofre mudanças em seus relacionamentos e em algum ponto do sistema se esquece de atualizar o método que busca o objeto no banco, causando não só um BUG como perda de dados do cliente.

			Para evitar isso sempre que obtiver um objeto para manipulação e para atualização no banco de dados '''''sempre''''' utilize o método '''findForUpdate()''' disponibilizado pelo BISDAO. Este método fará uma varredura automática no objeto e retornará sempre o objeto completo. De forma que se submetido logo em seguida para atualização nenhuma alteração será feita.}}

Rodrigogml em 22h23min de 29 de junho de 2017

2017-06-29T22:23:19Z

← Edição anterior		Edição das 22h23min de 29 de junho de 2017
Linha 1:		Linha 1:
	O ~~BISFrameWork~~ oferece uma estrutura de persistência combinada com os recursos da JPA para simplificar, ou mesmo evitar, a camada de persistência dos módulos. Essa estrutura prevê métodos para insert, update, delete e "find".		O BISKernel oferece uma estrutura de persistência combinada com os recursos da JPA para simplificar, ou mesmo evitar, a camada de persistência dos módulos. Essa estrutura prevê métodos para insert, update, delete e "find".

	Seu funcionamento compreende os seguintes itens:		Seu funcionamento compreende os seguintes itens:
	* '''[[BISVO]]''' - Um herdeiro de BISVO que represente a entidade ~~de persistência~~. O objeto a ser manipulado no banco de dados.		* '''[[BISVO]]''' - Um herdeiro de BISVO que represente a entidade principal a ser persistida. O objeto a ser manipulado no banco de dados.
	* '''[[BISMO]]''' - MatchObject para os métodos de ''find''. O MatchObject representa um objeto de filtro para a busca no banco de dados.		* '''[[BISMO]]''' - MatchObject para os métodos de ''find''. O MatchObject representa um objeto de filtro para a busca no banco de dados.
	* '''[[BISOrderBy]]''' - Objeto usado nos métodos de find que retornam mais de 1 item para descrever a ordem dos objetos.		* '''[[BISOrderBy]]''' - Objeto usado nos métodos de find que retornam mais de 1 item para descrever a ordem dos objetos.
	* '''[[BISVO_]]''' - O MetaObject deve ser utilizado para indicar os ''~~atirbutos~~'' que queremos que o método de find busque automaticamente para popular cada objeto. Normalmente os métodos de ''find'' já trazem o VO ~~completamente~~ populado, mas ~~em casos de~~ relacionamento marcados como '''Lazy''' o JPA ~~não os trás automaticamente~~. Quando o carregamento deste objeto for desejado o herdeiro do [[BISVO_]] correspondente ao herdeiro do [[BISVO]] passado no construtor do BISDAO deve ser utilizado para indicar o caminho das propriedades que obrigatoriamente devem ser populadas. Em geral, se uma propriedade de um VO é solicitada todas as outras propriedades do mesmo VO que estão na mesma tabela serão poluladas automaticamente.		* '''[[BISVO_]]''' - O MetaObject deve ser utilizado para indicar os ''atributos'' que queremos que o método de find busque automaticamente para popular cada objeto. Normalmente os métodos de ''find'' já trazem o atributos do VO populado, mas não os atributos das entidades relacionadas (relacionamento marcados como '''Lazy''' no JPA). Quando o carregamento deste objeto for desejado o herdeiro do [[BISVO_]] correspondente ao herdeiro do [[BISVO]] passado no construtor do BISDAO deve ser utilizado para indicar o caminho das propriedades que obrigatoriamente devem ser populadas. Em geral, se uma propriedade de um VO é solicitada todas as outras propriedades do mesmo VO que estão na mesma tabela serão poluladas automaticamente.


Linha 11:		Linha 11:


	{{nota\|Extensão da BISDAO\|Normalmente não é necessário ~~herdar a~~ BISDAO em outra classe. Bastando a instância-la e passando a classe adequada em seu construtor os métodos padrões do BISDAO já se tornam acessíveis.		{{nota\|Extensão da BISDAO\|Normalmente não é necessário estender BISDAO em outra classe. Bastando a instância-la e passando a classe adequada em seu construtor os métodos padrões do BISDAO já se tornam acessíveis.

	Ainda assim, é possível ~~herdar~~ BISDAO em uma classe específica para a criação de métodos mais específicos que interagem diretamente com o JPA. Em geral estes métodos só serão necessários para ganhos de performance para métodos de consulta ou atualização do banco de dados.}}		Ainda assim, é possível estender BISDAO em uma classe específica para a criação de métodos mais específicos que interagem diretamente com o JPA. Em geral estes métodos só serão necessários para ganhos de performance para métodos de consulta ou atualização do banco de dados.}}


	{{nota\|Objetos em Cadeia\|Se ContactVO contiver outros objetos (VOs) com informações, como por exemplo uma coleção de AddressVO, a camada de persistência criada para o ContactVO pode ser utilizado para realizar as operações em cadeia. Para isso precisa apenas fazer os mapeamentos do ~~JPA entre os objetos.}}~~		== Tratamento do Relacionamentos das Entidades ==


	{{stop\|Objetos em Cadeia\|Para o mesmo exemplo citado acima, um ContactVO que tenha uma coleção de AddressVO, não se deve persistir em cadeia caso o AddressVO seja um objeto autonomo, que seja cadastrado sozinho e tenha sua própria camada de persistência.
	Isto é, se AddressVO for utilizado apenas por este contato, se for apenas parte do ContactVO e não for manipulado em saparado do ContactVO, este deve ser persistido junto, em cadeia pelo Hibernate, afinal, a validação do objeto assim como toda sua manipulação deverá estar implementada nos métodos de manipulação do ContactVO.
	No entanto, se AddressVO é um objeto independente, que pode ser compartilhado entre outros ContactVO, cadastrado e manipulado independente do ContactVO, e para isso ter sua própria camada de persistência, ele nunca deve ser persistido junto com o ContactVO nem com outro objeto que faça referêcia. Para persisti-lo deve ser chamado o CRUD equivalente para fazer as validações e preparações necessárias antes de persisti-lo.}}

Rodrigogml em 17h09min de 7 de setembro de 2015

2015-09-07T17:09:11Z

Mostrar alterações

Rodrigogml: Rodrigogml moveu a página Persistência para BISDAO sem deixar um redirecionamento

2015-09-07T16:44:49Z

Rodrigogml moveu a página Persistência para BISDAO sem deixar um redirecionamento

← Edição anterior	Edição das 16h44min de 7 de setembro de 2015
(Sem diferença)

Rodrigogml em 00h50min de 20 de março de 2015

2015-03-20T00:50:03Z

← Edição anterior		Edição das 00h50min de 20 de março de 2015
Linha 88:		Linha 88:

	//Ordenando por uma coluna de for descendente		//Ordenando por uma coluna de for descendente
	BISOrderBy.getBISOrderbyInstance(AbbreviationMO.ORDERBY_PRIORITY, false)		BISOrderBy.getBISOrderbyInstance(AbbreviationMO.ORDERBY_PRIORITY, false);

	//Ordenando por duas colunas		//Ordenando por duas colunas
	BISOrderBy.getBISOrderbyInstance(AbbreviationMO.ORDERBY_PRIORITY, false).addOrderbyItem(AbbreviationMO.ORDERBY_OCCURENCE)		BISOrderBy.getBISOrderbyInstance(AbbreviationMO.ORDERBY_PRIORITY, false).addOrderbyItem(AbbreviationMO.ORDERBY_OCCURENCE);
	</syntaxhighlight>}}		</syntaxhighlight>}}

Rodrigogml em 23h49min de 19 de março de 2015

2015-03-19T23:49:22Z

← Edição anterior		Edição das 23h49min de 19 de março de 2015
Linha 12:		Linha 12:
	Para exemplificar, imaginemos que o objeto em questão seja um "contato". Obviamente devemos ter o VO que o representa, se o objeto for batizado como "Contact" o nome do VO será ContactVO. Assim, para implementar a camada de persistência deste objeto devemos criar as seguintes classes e intarface:		Para exemplificar, imaginemos que o objeto em questão seja um "contato". Obviamente devemos ter o VO que o representa, se o objeto for batizado como "Contact" o nome do VO será ContactVO. Assim, para implementar a camada de persistência deste objeto devemos criar as seguintes classes e intarface:

	* '''ContactMO:''' é o ~~Match Object~~ utilizado nos métodos de busca automatizados do objeto. Este Objeto não precisa ter nenhum método, atributo ou construtor no seu interior a princípio. Seus atributos e métodos só precisam ser criados posteriormente de acordo com a necessidade de se realizar buscas do objeto.		* '''ContactMO:''' é o [[MatchObject]] utilizado nos métodos de busca automatizados do objeto. Este Objeto não precisa ter nenhum método, atributo ou construtor no seu interior a princípio. Seus atributos e métodos só precisam ser criados posteriormente de acordo com a necessidade de se realizar buscas do objeto.
	{{java\|ContactMO\|<syntaxhighlight lang="java5">		{{java\|ContactMO\|<syntaxhighlight lang="java5">
	public class ContactMO extends BISDefaultMO {		public class ContactMO extends BISDefaultMO {