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

Nesta página