...
As consultas são realizadas em JPQL (Java Persistence Query Language), que é uma linguagem de consulta ORM que atua sobre classes e objetos, diferentemente do SQL que realiza as consultas baseadas em tabelas. Apesar de a diferença estrutural a linguagem JPQL é bem semelhante ao SQL, porém a primeira possui a vantagem de que a mesma consulta pode ser realizada em todos os bancos de dados. O JPQL conta também com o assistente de consulta visual, que é utilizado em blocos de programação e fontes de dados(Vale ressaltar que existem diferenças entre o assistente de consulta do bloco e fonte de dados), e que tem como objetivo facilitar a criação de consultas ao banco de dados, para esse fim o assistente dispõe de uma estrutura que permite a realização de consultas sem a necessidade de escrever o código e sim selecionando as entidades, campos, regras e outros por meio de cliques, além de gerar as consultas o assistente possui algumas outras funcionalidades como as exibidas abaixo:
...
- Estrutura de Consulta - Possui as opções de criação da consulta, como adicionar a entidade desejada, selecionar campos desejados na consulta, criar regras e outros.
- Testar Consulta - Realiza o teste da consulta criada e retorna os dados correspondentes a ela em uma nova janela (A forma de exibição é influenciada pelo modo de consulta escolhido).
- Editar como Texto - Faz a edição da consulta visual em formato de texto (Após alterar uma consulta visual já criada nesse formato, não é possível alterar a consulta novamente em formato visual).
- Visualizar como Texto - Exibe a consulta feita em formato visual em forma de texto.
- Modo de Consulta - Altera a estrutura exibição da consulta, que pode ser por tabelas ou objetos (Figuras 1.1 e 1.2).
- Aplicar dados da requisição - Aplica as requisições (paginação, ordenação e outros) diretamente na consulta (Disponível apenas em consultas via bloco de programação).
- Habilitar Paginação - Realiza a paginação dos dados em uma página de forma automática (Disponível apenas em consultas via bloco de programação).
- Ok OK e Cancelar - Cancela Salva ou salva cancela a consulta.
Figura 1.1 - Exibição de consulta em modo objetos
Figura 1.2 - Exibição de consulta em modo tabela
Estrutura da consulta
Agora vamos entender melhor as opções disponíveis na estrutura da consulta.
Figura 2 - Estrutura visual da consulta
...
1. Entidade:
Permite selecionar as entidades que serão utilizadas na consulta. Na opção entidade selecionamos os "..." e escolhemos a classe que será consultada, já em alias definimos como essa entidade será representada durante as consultas, por exemplo, se desejarmos criar uma consulta para a entidade 'Pessoas' o alias dela seria 'p' (pode ser um nome qualquer), logo tudo que for citar essa classe no futuro irá utilizar 'p' para se referir a 'Pessoas'. Após selecionar a entidade e sua representação deve-se clicar em 'Adicionar' para acrescentar a classe na consulta e se desejar adicionar uma outra entidade na consulta basta repetir o processo.
2. Campos:
É onde são escolhidos os campos que serão retornados na consulta. Se desejar buscar todos os campos da entidade, basta clicar no botão 'Adicionar Todos' que todos os campos serão adicionados a consulta, mas se não desejar adicionar todos os campos é necessário clicar em 'Novo Campo' e selecionar o campo desejado na consulta. Vamos voltar para o nosso exemplo, ao selecionarmos 'p.nome' estamos dizendo que queremos retornar o nome da nossa entidade 'Pessoa'. Outra opção que pode ser definida é a obter, que define o que queremos do campo selecionado, nessa propriedade podemos utilizar Obter (Retorna o valor do campo), MIN (Retorna o menor valor do campo), MAX (Retorna o maior valor do campo), AVG ( Retorna a média aritmética do campo), SUM ( Retorna a soma dos valores do campo), COUNT ( Retorna a quantidade de registros do campo). Vamos exemplificar, suponhamos que em nosso banco de dados possuem 6 pessoas cadastradas, se eu consultar Obter 'p.idade', MIN 'p.idade', MAX 'p.idade', AVG 'p.idade', SUM 'p.idade' e COUNT p.idade iremos receber, respectivamente, a idade de todas as pessoas, a menor idade registrada, a maior idade registrada, a média das idades de todas as pessoas, a soma das idades de todas as pessoas e a quantidade de pessoas cadastradas.
3. Regra:
Aqui é definida a regra da consulta. Para adicionar uma nova regra deve-se clicar em'Nova Regra'e selecionar o campo desejado para o filtro, após isso é necessário selecionar como o campo deverá ser filtrado. As opções para strings são: igual, diferente, contido e não contido, já para números as opções são: menor, menor ou igual, maior, maior ou igual, entre, não entre e no geral as opções são: nulo e não nulo, na próxima etapa é necessário adicionar um nome ao parâmetro de filtro, que pode ter qualquer nome. No nosso exemplo vamos retornar apenas os maiores de 18 anos, logo nossa consulta seria 'p.idade' maior idademinina ( idademinima representa o nome do parâmetro, esse parâmetro é solicitado posteriormente e pode ser atribuído ao valor desejado, nesse caso será 18). É possível também adicionar um grupo de regras, para isso clique em'Novo grupo'e então será possível criar conjuntos de regras isoladas, opção que é útil ao se consultar mais de uma entidade.
4. Agrupar:
Nessa propriedade é possível agrupar os itens por meio de um campo comum. Para utilizar o campo deve-se clicar em 'Novo Campo' e selecionar o campo pelo qual os itens serão agrupados. Em nosso exemplo, as pessoas serão agrupadas por categoria de idade( adultos, idosos, crianças), logo o campo selecionado será 'p.categoriaidade'.
5. Having:
A propriedade having é semelhante a propriedade regra e deve ser utilizada juntamente com a propriedade agrupar, para adicionar deve-se clicar em 'Novo Campo' e selecionar a 'regra' a ser utilizada. As opções são: MIN, MAX, AVG, SUM(a definição de cada opção foi informada no item 2), em nosso exemplo iremos retornar as categorias de idade que possui a média de idade maior que 20, logo nossa consulta será AVG 'p.idade' maior parametroDeMédiaDeIdade. Na consulta anterior serão retornados apenas os grupos que se enquadrarem no filtro.
5. Ordenar:
É definida a ordem de exibição do retorno da consulta que é baseada em um campo, para adicionar basta clicar em 'Novo Campo' e selecionar o campo pelo qual os itens serão ordenados e no campo seguinte definimos se essa ordem será Asc (Crescente) ou Desc (Decrescente) . No nosso ultimo exemplo as pessoas serão exibidas por ordem de idade, logo nossa consulta seria Obter (essa opção foi dissertada na propriedade campos) 'p.idade' Asc, ou seja, os itens relacionados serão exibidos do mais novo para o mais velho
...
.
Passos
No nosso exemplo temos uma classe Cidade na qual será realizada uma consulta visual, para abrir o assistente de consultas clique no ícone de configuração do bloco Abrir consulta.
...
| Aviso | ||
|---|---|---|
| ||
Não é possível realizar consultas entre 3 tabelas ou mais de forma low code. Esse tipo de consulta deve ser feita em modo high code (código). |
Fonte de dados VS Bloco de programaçãoprogramação Âncora Diferença Diferença
Existem algumas diferenças entre o assistente de consulta JPQL da fonte de dados e o do bloco de programação.
...
Blocos que utilizam o assistente visual JPQL
1. Bloco Inserir:
...
Bloco do tipo servidor que adiciona uma nova entidade ao banco de dados por meio do assistente visual do JPQL ( consulte mais detalhes aqui).
2. Bloco Abrir
...
consulta:
...
Bloco do tipo servidor que realiza uma consulta no banco de dados por meio do assistente visual do JPQL (consulte mais detalhes aqui).
3. Bloco
...
Abrir consulta:
...
Bloco do tipo servidor que atualiza uma entidade no banco de dados por meio do assistente visual JPQL (consulte mais detalhes aqui).
4. Bloco
...
Abrir consulta:
...
Bloco do tipo servidor que remove uma entidade do banco de dados por meio do assistente visual JPQL (consulte mais detalhes aqui).