Executa um comando de consulta JPQL e retorna uma lista de objetos da classe instanciada. Para executar outros comandos, utilize o bloco Executar JQPL.
Figura 1 - Bloco Executar Consulta JPQL
Compatibilidade
- Bloco servidor: cronapi.database.Operations.executeQuery()
Retorno
Retorna uma lista de objetos que representa a consulta realizada.
Parâmetros
Entidade
Referência da entidade da consulta a ser realizada. Deve seguir a estrutura: <nome_do_pacote
>.entity.
<nome_da_classe
> .
- Posição: 1
- Inglês: Entity
- Tipo: Texto / String
- Exemplo: "
app.entity.Aluno
"
Consulta SQL
Comando de consulta JPQL a ser utilizado. Caso seja necessário o uso de parâmetros na consulta realizada, estes devem seguir a estrutura: <:parametro
> .
- Posição: 2
- Inglês: Query
- Tipo: Texto / String
- Exemplo: "
select a from Aluno a where a.nota >= :nota
"
Parâmetros para consulta
Parâmetro opcional a ser utilizado caso a consulta realizada tenha parâmetros. O nome do parâmetro utilizado na consulta deve ser adicionado ao bloco criar mapa com. É importante que o nome do parâmetro adicionado a este bloco seja o mesmo informado na consulta JPQL.
- Posição: 3
- Inglês: Query params
- Tipo: Mapa / Map
- Exemplo: uso do bloco criar mapa com
Exemplo
A função abaixo apresenta um exemplo de uso do bloco Executar Consulta JPQL. A consulta será realizada a partir da entidade "Aluno". No parâmetro Consulta SQL, inserimos o comando "select a from Aluno a where a.nota >= :nota
", que irá retornar os registros dos alunos que possuem nota maior ou igual ao parâmetro ":nota
".
Em seguida, no Parâmetros para consulta, inserimos o bloco criar mapa com e nele inserimos o mesmo parâmetro "nota" informado ao final da consulta. Por fim, o bloco de repetição irá imprimir, por meio do bloco Obter campo do, os nomes dos alunos com notas maiores ou iguais a 9. A Figura 2.1 exibe os alunos registrados.
Figura 2 - Exemplo de uso do bloco Executar Consulta JPQL
A imagem a seguir exibe o componente grade com os alunos registrados e suas notas.
Figura 2.1 - Alunos registrados e suas notas