RFWDAO - Histórico de revisão

Rodrigogml: /* Relacionamento Atributo do Objeto x Coluna do BD */

2025-11-11T12:27:24Z

Relacionamento Atributo do Objeto x Coluna do BD

← Edição anterior		Edição das 12h27min de 11 de novembro de 2025
Linha 145:		Linha 145:
	== Relacionamento Atributo do Objeto x Coluna do BD ==		== Relacionamento Atributo do Objeto x Coluna do BD ==

	Para que um atributo do objeto seja relacionado corretamente com uma coluna da tabela (especificada na Annotation @RFWDAOAnnotation) é necessário que o atributo tenha uma @[[RFWMetaAnnotations]]. Nela constarão várias informações sobre o atributo, incluindo a coluna. '''Caso o nome da coluna não seja especificado, o RFWDAO assume que o nome da coluna é exatamente o mesmo nome do atributo''', ou seja, caso o mesmo nome seja utilizado na coluna do banco quando no atributo do objeto, não é necessário especificar o atributo coluna na Annotation. Isso deixa o código ~~menos poluído~~.		Para que um atributo do objeto seja relacionado corretamente com uma coluna da tabela (especificada na Annotation @RFWDAOAnnotation) é necessário que o atributo tenha uma @[[RFWMetaAnnotations]]. Nela constarão várias informações sobre o atributo, incluindo a coluna. '''Caso o nome da coluna não seja especificado, o RFWDAO assume que o nome da coluna é exatamente o mesmo nome do atributo''', ou seja, caso o mesmo nome seja utilizado na coluna do banco quando no atributo do objeto, não é necessário especificar o atributo coluna na Annotation. Isso deixa o código mais limpo.

	= Mapeamento do Relacionamento =		= Mapeamento do Relacionamento =

Rodrigogml: /* Outras Estruturas */

2024-08-24T17:22:08Z

Outras Estruturas

← Edição anterior		Edição das 17h22min de 24 de agosto de 2024
Linha 527:		Linha 527:

	Note que este é só um exemplo e que deve ser adaptado as necessidades da aplicação.		Note que este é só um exemplo e que deve ser adaptado as necessidades da aplicação.

			= Métodos do RFWDAO =

			== findListEspecial ==

			Este método permite que consultas sejam feitas no banco de forma mais direta. Fugindo do formato de entidade RFWVO, e permitindo que sejam aplicadas funções diretas do banco de dados, como SUM, DISTINCT, MAX, etc., além de cláusulas como GroupBy, OffSet e Limit sem chegar ao nível de escrever o SQL diretamente.

			{{java\|Exemplo de uso da função MAXIMUM\|<syntaxhighlight lang="java">

			// Utilize o RFWField para referenciar as colunas e funções do SQL e definir as 'colunas' que serão recuperadas do banco
			RFWField[] fields = new RFWField[2];
			fields[0] = RFWField.count();
			fields[1] = RFWField.field(LocationCityVO_.vo().locationStateVO().acronym());

			// A mesma estrutura permite que sejam definidas as 'colunas' de agrupamento.
			RFWField[] groupBy = new RFWField[1];
			groupBy[0] = RFWField.field(LocationCityVO_.vo().locationStateVO().id());

			// O objeto RFWOrderBy permite que sejam definidas as opções do orderBy
			RFWOrderBy orderBy = RFWOrderBy.createInstance(LocationCityVO_.vo().locationStateVO().acronym());

			// Podem ser definidos ainda um offSet e um limite de linhas a serem retornados
			Integer offSet = 0;
			Integer limit = 500;

			List<Object[]> list = dao.findListEspecial(fields, null, orderBy, groupBy, offSet, limit);

			</syntaxhighlight>}}


			Observe que esse método retorna uma lista de objetos. Cada item da lista representa um registro (linha) retornado da consulta do banco de dados. Já o array Object[] representam as colunas que foram solicitadas, no exemplo acima devemos ter dois valores: count(*) e acronym. '''Os tipos dos dados retornados dependerá exclusivamente do tipo de coluna definido no banco de dados e as definições do JDBC utilizado'''. O conteúdo é recuperado do banco de dados diretamente com o método '''getObject(...)''' do RecordSet e nenhuma manipulação do RFWDAO é realizada depois da consulta.


			Em casos de objetos que utilizam conversões, como as definidas pela annotation '''@RFWDAOConverter''', ou encriptação como '''@RFWMetaEncrypt''' precisaram ter seu tratamento realizado manualmente depois de obtido o resultado.


	= Outras Estruturas =		= Outras Estruturas =

Rodrigogml: /* Função DISTINCT */

2024-08-24T12:15:03Z

Função DISTINCT

← Edição anterior		Edição das 12h15min de 24 de agosto de 2024
Linha 592:		Linha 592:
	// Defina o campo utilizando a função SUM, passando o nome da coluna que deseja somar		// Defina o campo utilizando a função SUM, passando o nome da coluna que deseja somar
	RFWField[] fields = new RFWField[] {		RFWField[] fields = new RFWField[] {
	RFWField.distinct(UserVO_._sector);		RFWField.distinct(UserVO_._sector)
	};		};

Rodrigogml: /* Função MAX */

2024-08-24T12:13:04Z

Função MAX

← Edição anterior		Edição das 12h13min de 24 de agosto de 2024
Linha 607:		Linha 607:
	Neste exemplo, o campo `"sector"` é consultado com a função `DISTINCT` aplicada, retornando apenas os nomes únicos encontrados no banco de dados.		Neste exemplo, o campo `"sector"` é consultado com a função `DISTINCT` aplicada, retornando apenas os nomes únicos encontrados no banco de dados.

	=== Função ~~MAX~~ ===		=== Função MAXIMUM ===

	{{java\|Exemplo de uso da função ~~MAX~~\|<syntaxhighlight lang="java">		{{java\|Exemplo de uso da função MAXIMUM\|<syntaxhighlight lang="java">

	// Defina o campo utilizando a função ~~MAX~~, passando o nome da coluna que deseja obter o valor máximo		// Defina o campo utilizando a função MAXIMUM, passando o nome da coluna que deseja obter o valor máximo
	RFWField[] fields = new RFWField[] {		RFWField[] fields = new RFWField[] {
	RFWField.~~max~~(UserVO_._salary)		RFWField.maximun(UserVO_._salary)
	};		};

Linha 628:		Linha 628:
	</syntaxhighlight>}}		</syntaxhighlight>}}

	No exemplo acima, a função `~~MAX~~` é aplicada à coluna do atributo '''UserVO.salary''' para retornar o maior valor encontrado na consulta.		No exemplo acima, a função `MAXIMUM` é aplicada à coluna do atributo '''UserVO.salary''' para retornar o maior valor encontrado na consulta.

	=== Função MIN ===		=== Função MIN ===

Rodrigogml: /* Função MAX */

2024-08-24T12:11:16Z

Função MAX

@@ Linha 608: / Linha 608: @@
 === Função MAX ===
-@TODO
 === Função MIN ===

Rodrigogml: /* Função 'SUM' */

2024-08-24T12:05:32Z

Função 'SUM'

← Edição anterior		Edição das 12h05min de 24 de agosto de 2024
Linha 575:		Linha 575:

	// Realize a consulta sem filtros específicos		// Realize a consulta sem filtros específicos
	List<Object[]> result = ~~facade~~.findListEspecial(~~uuid, SellVO.class,~~ fields, null, null, null, null, null);		List<Object[]> result = dao.findListEspecial(fields, null, null, null, null, null);

	// O resultado conterá a soma de todos os valores da coluna especificada		// O resultado conterá a soma de todos os valores da coluna especificada
Linha 581:		Linha 581:

	</syntaxhighlight>}}		</syntaxhighlight>}}


	=== Função DISTINCT ===		=== Função DISTINCT ===

Rodrigogml: /* Função DISTINCT */

2024-08-24T12:04:57Z

Função DISTINCT

← Edição anterior		Edição das 12h04min de 24 de agosto de 2024
Linha 591:		Linha 591:
	// Exemplo de consulta utilizando DISTINCT para buscar nomes de usuários únicos		// Exemplo de consulta utilizando DISTINCT para buscar nomes de usuários únicos

	RFWField ~~distinctField~~ = RFWField.distinct(~~"name"~~);		// Defina o campo utilizando a função SUM, passando o nome da coluna que deseja somar
			RFWField[] fields = new RFWField[] {
			RFWField.distinct(UserVO_._sector);
			};


	// Montando o Meta Objeto para a consulta		// Montando o Meta Objeto para a consulta
Linha 598:		Linha 602:

	// Realizando a consulta		// Realizando a consulta
	List<Object[]> resultList = ~~facade~~.findListEspecial(~~uuid, UserVO.class, new RFWField[] { UserVO_._sector }~~, mo, null, null, null, null);		List<Object[]> resultList = dao.findListEspecial(fields, mo, null, null, null, null);

	</syntaxhighlight>}}		</syntaxhighlight>}}

Rodrigogml: /* Função DISTINCT */

2024-08-24T12:01:26Z

Função DISTINCT

← Edição anterior		Edição das 12h01min de 24 de agosto de 2024
Linha 595:		Linha 595:
	// Montando o Meta Objeto para a consulta		// Montando o Meta Objeto para a consulta
	RFWMO mo = new RFWMO();		RFWMO mo = new RFWMO();
			//... seus filtros

	// Realizando a consulta		// Realizando a consulta

Rodrigogml: /* Função DISTINCT */

2024-08-24T12:00:50Z

Função DISTINCT

← Edição anterior		Edição das 12h00min de 24 de agosto de 2024
Linha 597:		Linha 597:

	// Realizando a consulta		// Realizando a consulta
	List<Object[]> resultList = facade.findListEspecial(uuid, UserVO.class, new RFWField[] { ~~distinctField~~ }, mo, null, null, null, null);		List<Object[]> resultList = facade.findListEspecial(uuid, UserVO.class, new RFWField[] { UserVO_._sector }, mo, null, null, null, null);

	</syntaxhighlight>}}		</syntaxhighlight>}}

	Neste exemplo, o campo `"~~name~~"` é consultado com a função `DISTINCT` aplicada, retornando apenas os nomes únicos encontrados no banco de dados.		Neste exemplo, o campo `"sector"` é consultado com a função `DISTINCT` aplicada, retornando apenas os nomes únicos encontrados no banco de dados.


	=== Função MAX ===		=== Função MAX ===

Rodrigogml: /* Função 'COUNT' */

2024-08-24T11:59:49Z

Função 'COUNT'

← Edição anterior		Edição das 11h59min de 24 de agosto de 2024
Linha 559:		Linha 559:

	</syntaxhighlight>}}		</syntaxhighlight>}}


			{{nota\|RFWDAO contém a função count()\|Para agilizar, o RFWDAO contém a uma função .count() que tem exatamente essa implementação para simplificar essa consulta.}}

	=== Função 'SUM' ===		=== Função 'SUM' ===