Rodrigogml: /* Constantes Vs. Métodos */

2022-11-17T15:55:40Z

Constantes Vs. Métodos

← Edição anterior		Edição das 15h55min de 17 de novembro de 2022
Linha 45:		Linha 45:
	Para evitar que o MetaObject seja instanciado o tempo todo, cada Meta Object tem uma constante chamada "VO" que carrega uma instância estática do objeto. A maneira correta de utilizar o MetaObject seria a seguinte (de acordo com o exemplo de PersonVO citado acima):		Para evitar que o MetaObject seja instanciado o tempo todo, cada Meta Object tem uma constante chamada "VO" que carrega uma instância estática do objeto. A maneira correta de utilizar o MetaObject seria a seguinte (de acordo com o exemplo de PersonVO citado acima):

	{{java\|Utilização do MetaObject por Métodos\|<syntaxhighlight lang="java">		{{java\|Utilização do MetaObject por Métodos\|
			<syntaxhighlight lang="java">
	PersonVO_.VO.fullName() //Retorna a String "fullName"		PersonVO_.VO.fullName() //Retorna a String "fullName"
	PersonVO_.VO.parent().path() //Retorna a String "parent"		PersonVO_.VO.parent().path() //Retorna a String "parent"
	PersonVO_.VO.parent().fullName() //Retorna a String "parent.fullName"		PersonVO_.VO.parent().fullName() //Retorna a String "parent.fullName"
	</syntaxhighlight>}}		</syntaxhighlight>
			}}

	A sintaxe citada acima é que é definida por métodos. É a melhor e mais simples maneira de se referenciar os atributos ou suas cadeiras de atributos.		A sintaxe citada acima é que é definida por métodos. É a melhor e mais simples maneira de se referenciar os atributos ou suas cadeiras de atributos.

Rodrigogml: Criou página com 'Meta Object é o '''Objeto do Objeto'''! Mais fácil que isso só dois disso!!! Se não entendeu continue lendo... A definição de 'Meta Dados' é "A informação da Informação". Por exemplo, se você tem a informação do tipo texto "Eu amo o RFW". Essa informação contém outras informações, como "tamanho", "charset", "língua", etc.. Essas informações (dados) da própria informação são chamadas de 'Meta Dados'. De forma similar o RFW tem seus 'Meta Object...'

2022-11-17T15:39:47Z

Criou página com 'Meta Object é o '''Objeto do Objeto'''! Mais fácil que isso só dois disso!!! Se não entendeu continue lendo... A definição de 'Meta Dados' é "A informação da Informação". Por exemplo, se você tem a informação do tipo texto "Eu amo o RFW". Essa informação contém outras informações, como "tamanho", "charset", "língua", etc.. Essas informações (dados) da própria informação são chamadas de 'Meta Dados'. De forma similar o RFW tem seus 'Meta Object...'

Página nova

Meta Object é o '''Objeto do Objeto'''! Mais fácil que isso só dois disso!!! Se não entendeu continue lendo...

A definição de 'Meta Dados' é "A informação da Informação". Por exemplo, se você tem a informação do tipo texto "Eu amo o RFW". Essa informação contém outras informações, como "tamanho", "charset", "língua", etc.. Essas informações (dados) da própria informação são chamadas de 'Meta Dados'.

De forma similar o RFW tem seus 'Meta Objects', que tem a finalidade de descrever seus próprios objetos. No caso, são utilizados para descrever cada um dos RFWVO do sistema.

= O Problema =

Em várias partes do RFW há processos automatizados com métodos que tratam as classes RFWVO (ou suas herdeiras), no entanto sua implementação não conhece especificamente cada objeto. É possível orientá-lo a obter o atributo correto a partir de uma String de parâmetros.

Por exemplo, imagine que estamos montando um relatório de clientes. Os dados seriam uma coleção de PersonVO. Para montar o relatório queremos que o Framework crie uma coluna com o atributo "fullName". E que dentro de PersonVO, temos a referência para outro PersonVO que indica seu pai, no atributo "dad". E queremos outra coluna com o nome completo do pai.

Ao passar os caminhos para o framework por String seriam "fullName" e "parent.fullName".

'''O problema''' de passar por String é que se o atributo deixar de existir ou qualquer alteração/refactory que mude o atributo, ou ainda qualquer tipo de erro de digitação, fará com que o código compile normalmente mas não funcione. E mesmo que ele seja testado na hora, alterações futuras podem fazer com que o código deixe de funcionar em outras partes do sistema. Tupo por não haver validação dos atributos dentro da String.

'''Para resolver isso existe o MetaObject.''' O Meta object é um objeto espelho do VO, que descreve o VO e seus métodos e atributos. De forma que ele monta a String a ser passada somente durante o RunTime. Durante o tempo de compilação ele mantém métodos que deixam de existir caso o atributo deixe de existir. O que fará com que o código "quebre" já com erros de compilação.

= Funcionamento =

O MetaObject por padrão '''tem o mesmo nome que o VO a qual ele descreve e é salvo no mesmo package, com a única diferença que leva um sufixo '_''''. Ou seja, caso tenhamos um '''PersonVO''' no sistema, o seu MetaObject será o '''PersonVO_''', salvos "um do lado do outro".

Este objeto tem métodos com o exato nome do atributo do VO que ele representa. Por exemplo, se o PersonVO tem um atributo 'fullName', o PersonVO_ terá um método 'fullName()', que retornará a String 'fullName' como desejado para passar para o Framework.

Nos casos em que o atributo retorne outro VO, como no nosso exemplo do PersonVO com o atributo 'parent' que retorna outro PersonVO, o PersonVO_ terá um método chamado 'parent()', que dessa vez não retorna uma String, mas sim o MetaObject do objeto retornado no VO. No nosso caso o próprio PersonVO_. E então conseguiríamos obter o caminho para o atributo 'fullname' do objeto retornado a partir do retorno de 'dad'. O código ficaria assim:

<pre>parent().fullName()</pre>

O que retornaria a String "parent.fullName", como esperado pelo Framework. E com a vantagem que esse código "quebra" se parent ou fullname deixarem de existir em PersonVO.

Imagine agora que você queira o caminho de 'parent' e não de um atributo dentro de parent. E parent não retorna a String, retorna outro MetaObject de PersonVO. Nestes casos, pode-se chamar o método path(). Que força o retorno do caminho até aquele ponto, sem obter um atributo dentro do MetaObject retornado. Por exemplo:

<pre>parent().path()</pre>

Essa código retornará a String "parent".

A partir deste funcionamento podemos obter e descrever o caminho para qualquer propriedade de um VO independente de quantas referências ou "níveis de cadeia" um VO tenha dentro do outro.

= Constantes Vs. Métodos =

Para evitar que o MetaObject seja instanciado o tempo todo, cada Meta Object tem uma constante chamada "VO" que carrega uma instância estática do objeto. A maneira correta de utilizar o MetaObject seria a seguinte (de acordo com o exemplo de PersonVO citado acima):

{{java|Utilização do MetaObject por Métodos|<syntaxhighlight lang="java">
PersonVO_.VO.fullName() //Retorna a String "fullName"
PersonVO_.VO.parent().path() //Retorna a String "parent"
PersonVO_.VO.parent().fullName() //Retorna a String "parent.fullName"
</syntaxhighlight>}}

A sintaxe citada acima é que é definida por métodos. É a melhor e mais simples maneira de se referenciar os atributos ou suas cadeiras de atributos.

Porém, há ainda as constantes de atributos. As constantes sequem a seguinte sintaxe:

{{java|Utilização do MetaObject por Constantes|<syntaxhighlight lang="java">
PersonVO_._fullName //Constante com a String "fullName"
PersonVO_._dad //Retorna a String "dad"
</syntaxhighlight>}}

Para um atributo direto do VO (que não retorne outro VO), não há diferença entre um método e outro. Isto é "PersonVO_.VO.fullName()" ou "PersonVO_._fullName" tem exatamente o mesmo resultado. Mas note que nessa sintaxe a constante '_parent' retorna diretamente a String "parent" ao invés do MetaObject do objeto retornado pelo atributo 'parent' original do VO. '''Isso impossibilita que seja montada uma cadeia completa com atributos aninhados!'''

Se o acesso por constantes tem menos funcionalidades, para que existem ambos? Em alguns casos a referência ao atributo precisa ser uma constante final. Como por exemplo a referência de atributos dentro de Annotations. Nestes casos a utilização do método não pode ser utilizado, pois o java entende que o retorno de um método não será constante.

Mas e se na annotation eu precisar referenciar um atributo aninhado? Como obter o caminho completo? A resposta é que não tem como obter diretamente. Mas mesmo assim recomendamos a utilização dos MetaObjects. Por exemplo para obter o mesmo resultado de "PersonVO_.VO.parent().fullName()" (que seria "parent.fullName") teríamos de utilizar o seguinte código:

{{java|Utilização do MetaObject por Constantes|<syntaxhighlight lang="java">
PersonVO_._parent + "." + PersonVO_._fullName
</syntaxhighlight>}}

Desta forma temos o mesmo resultado utilizando apenas os acessos de constantes. Embora mais trabalhoso, e ainda passível de se montar um caminho de atributos inválidos, o código continuará "quebrando" caso alguma das propriedades mude ou deixe de existir. Melhorando a qualidade do código evitando BUGs e erros.

= Escrevendo o MetaObject =

Bom, tudo isso é legal, mas é muito trabalhoso ter que ficar escrevendo e editando o MetaObject a cada vez que faço uma alteração no VO.

FATO! Por isso o RFW conta com um Plugin para Eclipse que sempre que se você '''escrever uma clase cujo nome termine com VO e que estenda RFWVO''', ele gera automaticamente a classe do lado do VO.

Para instalar e fazer o '''[[RFWMetaObjectGenerator]]''' verifique a página do projeto do PlugIn.

MetaObject - Histórico de revisão

Rodrigogml: /* Constantes Vs. Métodos */