Rodrigogml: Criou página com 'O RFWMO é um MatchObject, isto é, ele carrega informações para descobrir objetos equivalentes. Em outras palavras ele permite um filtro de objetos baseados em seus atributos. Seu principal uso é feito pelo RFWDAO para a consulta de objetos persistidos. De acordo com o nome do atributo criado no VO, o RFWDAO será capaz de retornar os objetos desejados sem mais linhas de código além do nome do atributo e seus métodos GET e SET. Por exemplo, imaginando qu...'

2023-07-11T18:46:54Z

Criou página com 'O RFWMO é um MatchObject, isto é, ele carrega informações para descobrir objetos equivalentes. Em outras palavras ele permite um filtro de objetos baseados em seus atributos. Seu principal uso é feito pelo RFWDAO para a consulta de objetos persistidos. De acordo com o nome do atributo criado no VO, o RFWDAO será capaz de retornar os objetos desejados sem mais linhas de código além do nome do atributo e seus métodos GET e SET. Por exemplo, imaginando qu...'

Página nova

O RFWMO é um MatchObject, isto é, ele carrega informações para descobrir objetos equivalentes. Em outras palavras ele permite um filtro de objetos baseados em seus atributos. Seu principal uso é feito pelo [[RFWDAO]] para a consulta de objetos persistidos.

De acordo com o nome do atributo criado no VO, o [[RFWDAO]] será capaz de retornar os objetos desejados sem mais linhas de código além do nome do atributo e seus métodos GET e SET.

Por exemplo, imaginando que tenhamos os objetos ContactVO para representar um contato. E que um dos atributos presente no VO seja uma String "name". Para buscar os VOs pelo conteúdo do seu atributo "name" exatamente, devemos criar uma instância do RFWMO e definir que queremos que "name" seja igual ao valor desejado:

{{java|Exemplo Criação RFWMO para filtrar pelo valor do atributo "name"|
<syntaxhighlight lang="java">
RFWMO mo = new RFWMO();
mo.equals(ContractVO_.VO.name(), "João de Barros");
</syntaxhighlight>}}

A lista de comandos aceitos estão no tópico abaixo, e podem ser verificadas de forma mais atualizada no próprio JavaDoc dos métodos do RFWMO.

{{stop|Utilização do MetaObject [[RFWVO_]]|Para efeitos de compatibilidade e qualidade do sistema não passe uma String diretamente. Utilize o pattern do MetaObject [[RFWVO_]] para definir os atributos no RFWMO.}}

= VOs em Cadeia =

O MO pode fazer buscas com filtros baseado nas informações próprias e de outros VOs que estejam dentro deles. Por exemplo, imagine o objeto ContactVO novamente. Imagine que dentro dele temos um atributo chamado "address" que é um AddressVO. E que por sua vez tem um atributo chamado "city" que é do tipo CityVO e dentro deste VO o nome da cidade é salva no atributo "name".

Agora, queremos obter todos os ContactVO cujo nome comecem com "Rodrigo", e que a cidade seja igual a "Campinas". Para realizar a busca com essas duas condições precisamos passar no MO os dois atributos:

{{java|Exemplo Criação RFWMO para filtrar pelo valor do atributo "name"|
<syntaxhighlight lang="java">
RFWMO mo = new RFWMO();
mo.like(ContractVO_.VO.name(), "Rodrigo%");
mo.equals(ContractVO_.VO.cityvo().name(), "Campinas");
</syntaxhighlight>}}

Combinando ambas as condições no mesmo MO e usando qualquer um dos métodos de busca da camada de persistência devemos obter os objetos que satisfazem ambas as condições.

= Lista de Comandos do MO =

{{nota|Atributos definidos como null|Qualquer atributo definido como NULL é desconsiderado para o filtro de comparação no [[RFWDAO]]. Para buscar objetos que tenham algum atributo nulo ou não nulo, utilize respectivamente os comandos isNull e isNotNull de acordo com o desejado.}}

{|class="wikitable" style="text-align:center; width:100%;"
!colspan="3"|Comandos do MO
|-
! Comando
! Classe do Parametro
! Detalhes
|-
|equal
|<Mesmo do VO>
| style="text-align:left;" | Utiliza o modo de comparação equals do java ou o = do banco de dados. Faz com que um objeto tenha de ser exatamente igual à outro.
|-
|notEqual
|<Mesmo do VO>
| style="text-align:left;" | Inversão do modo de comparação equals. Faz com que o objeto tenha que ser diferente do definido.
|-
|greaterThanOrEqualTo
|<Mesmo do VO>
| style="text-align:left;" | Compara dois valores numéricos. Faz com que o valor dos VOs retornados sejam maiores ou iguais ao o valor definido no MO.
|-
|greaterThan
|<Mesmo do VO>
| style="text-align:left;" | Compara dois valores numéricos. Faz com que o valor dos VOs retornados sejam maiores que os valor definido no MO.
|-
|lessThanOrEqualTo
|<Mesmo do VO>
| style="text-align:left;" | Compara dois valores numéricos. Faz com que o valor dos VOs retornados sejam menores ou iguais ao o valor definido no MO.
|-
|lessThan
|<Mesmo do VO>
| style="text-align:left;" | Compara dois valores numéricos. Faz com que o valor dos VOs retornados sejam menores que os valor definido no MO.
|-
|isNull
|<Nenhum>
| style="text-align:left;" | Se definido retorna os objetos cujo atributo esteja nulo.
|-
|isNotNull
|<Nenhum>
| style="text-align:left;" | Se definido retorna os objetos cujo atributo '''não''' esteja nulo.
|-
|like
|String
| style="text-align:left;" | Este comando é semelhante ao 'like" do banco de dados. Busca os atributos que se encaixam em um determinado padrão. Utiliza as mesmas mascaras do MySQL: % para indicar uma cadeia qualquer de caracteres, e _ para indicar um único carácter qualquer. Só funciona para conteúdos do tipo String.
|-
|in
|Collection<<Mesmo do VO>>
| style="text-align:left;" | Recebe uma lista de objetos da mesma classe que o atributo do VO. Retorna o VO se o valor do VO estiver na lista passada, ou seja, se o valor for igual a qualquer um dos itens da lista.
|-
|notIn
|Collection<<Mesmo do VO>>
| style="text-align:left;" | Recebe uma lista de objetos da mesma classe que o atributo do VO. Retorna o VO se o valor do VO NÃO estiver na lista passada, ou seja, se o valor for diferente de todos os itens da lista.
|}

= Lógica Booleana entre Operações =

Por ser a mais usada, quando mais de uma condição é definida no MO a operação booleana de concatenação entre as condições padrão é o AND. Mas isso não é fixo e pode ser alterado! Caso queira que trocar o AND por OR utilize o método:<pre>setAppendmethod(APPENDMETHOD appendmethod)</pre> e passe o atributo:<pre>APPENDMETHOD.OR</pre>.
Além de alterar a condição de AND para OR, algumas vezes é necessário combinar ambas. Pra combinar diversas condições mesclando os operadores AND e OR. Como cada MO só permite trabalhar com o AND ou OR por vez, temos que montar os conjuntos em MOs separados e depois junta-los. Por exemplo, imaginemos que temos diversas condições: c1, c2, ..., cN. E queremos o resultado da expressão:
<pre>((c1 AND c2 AND c3) OR c4) AND ((c5 OR c6) AND c7)</pre>

Para este caso temos que montar as expressões em MOs separadas de acordo com os operadores lógicos usados:
* '''MO1:''' Usando o Appendmethod = AND, definimos as condições c1, c2 e c3; [MO1 representa "(c1 AND c2 AND c3)"]
* '''MO2:''' Usando o Appendmethod = OR, definimos a condição c4, e colocamos o '''MO1''' na lista de submos usando o método:<pre>setSubmo(List<RFWMO> submo)</pre> [MO2 representa "(MO1 OR c4)"]
* '''MO3:''' Usando o Appendmethod = OR, definimos o c5 e c6; [MO3 representa "(c5 OR c6)"]
* '''MO4:''' Usando o Appendmethod = AND definimos o c7 e assim como fizemos antes, colocamos o '''MO3''' como submo deste MO; [MO4 representa "(MO3 AND c7)"]
* '''MO5:''' Por fim, usando o Appendmethod = AND, não definimos nenhuma condição adicional, mas temos que definir os '''MO2''' e o '''MO4''' como submos deste MO; [MO5 representa "(MO2 AND MO4)"]

== Otimizando a Consulta ==

Assim como no SQL, utilizando as operações booleanas para otimizar e simplificar as operações. Embora não tenhamos ainda todas as ferramentas necessárias na estrutura do MO (como por exemplo usar o NOT em um submo), algumas operações podemos realizar tranquilamente. Se analisarmos novamente a expressão anterior, podemos usar 1 objeto a menos se tirarmos os paréntesis e deixamos a expressão assim:
<pre>((c1 AND c2 AND c3) OR c4) AND (c5 OR c6) AND c7</pre>

Desta maneira montaríamos os MOs da seguinte maneira:
* '''MO1, MO2 e MO3''' permaneceriam os mesmos;
* No '''MO4''' definiríamos c7 normalmente, mas pasaríamos '''MO3''' e '''MO2''' como submos;
* '''MO5''' não é mais necessário.

Outras lógicas podem ser aplicadas como por exemplo. Analisando a expressão acima no seguinte trecho:
<pre>c5 OR c6</pre>
e supormos que c5 e c6 sejam condições do tipo '''equal'''. A regra de lógica booleana diz que se negarmos os operandos e invertermos o operador booleano teremos a mesma tabela verdade:
<pre>A OR B = !A AND !B</pre>
assim, se c5 e c6 são condições do tipo '''equal''' sua negação é a operação '''not equal''', disponível no MO, vamos chama-las de nc5 e nc6, assim a expressão ficaria assim:
<pre>nc5 AND nc6</pre>
o que deixa a nossa expressão completa da seguinte forma:
<pre>((c1 AND c2 AND c3) OR c4) AND (nc5 AND nc6) AND c7</pre>
observe que os parênteses em volta de nc5 e nc6 são desnecessários agora. E dessa forma podemos eliminar outro objeto (o anterior '''MO3'''), bastando para isso definir as condições c5 e c6 negadas (nc5 e nc6) diretamente no que chamamos de '''MO4'''. Usando a mesma lógica, e supondo quais seriam as condições, seriamos capaz de inverter as lógicas e remover todos os parênteses deixando apenas 1 operando, seja ele AND seja ele OR.

RFWMO - Histórico de revisão