MetaObject - Histórico de revisão

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

2019-05-19T20:41:23Z

Constantes Vs. Métodos

@@ Linha 43: / Linha 43: @@
 = Constantes Vs. Métodos =
-Para evitar que o MetaObject seja instanciado o tempo todo, cada Meta Object tem uma contante chamada "VO" que carrega uma instância estática do objeto. A maneira correta de utilizar o MetaObject seria a seguinte (seguindo o exemplo de PersonVO citado acima):
+Para evitar que o MetaObject seja instanciado o tempo todo, cada Meta Object tem uma contante 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):
-<pre>
+{{java|Utilização do MetaObject por Métodos|<syntaxhighlight lang="java">
-PersonVO_.VO.dad() //retornaria a String "dad"
+PersonVO_.VO.fullName() //Retorna a String "fullName"
 = Escrevendo o MetaObject =

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

2019-05-19T20:26:31Z

Constantes Vs. Métodos

← Edição anterior		Edição das 20h26min de 19 de maio de 2019
Linha 43:		Linha 43:
	= Constantes Vs. Métodos =		= Constantes Vs. Métodos =

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

			<pre>
			PersonVO_.VO.dad() //retornaria a String "dad"

	= Escrevendo o MetaObject =		= Escrevendo o MetaObject =

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 da 'Meta Dados' é "A informação da Informa...'

2019-05-19T20:22:27Z

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 da 'Meta Dados' é "A informação da Informa...'

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 da 'Meta Dados' é "A informação da Informação". Por exemplo, se você tem a informação do tipo texto "Eu amo o BIS". 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 BIS tem seus 'Meta Objects', que tem a finalidade de descrever seus próprios objetos. No caso, são utilizados para descrever cada um dos BISVO do sistema.

= O Problema =

Em várias partes do BIS Framework há processos automatizados com métodos que tratam as classes BISVO (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 "dad.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 seria o '''PersonVO_''', salvos um "do lado do outro".

Este objeto tem métodos co 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 'dad' que retorna outro PersonVO, o PersonVO_ terá um método chamado 'dad()', 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>dad().fullName()</pre>

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

Imagine agora que você queira o caminho de 'dad' e não de um atributo dentro de dad. E dad 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>dad().path()</pre>

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

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 =

= 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 BIS conta com um Plugin para Eclipse que sempre que vc '''escrever uma clase cujo nome termine com VO e que estenda BISVO''', ele gera automaticamente a classe do lado do VO.

Para instalar e fazer o '''BISMetaObjectGenerator''' verifique a página de instalação do ambiente do BIS: [[Preparação dos Ambientes]].