Executa um comando de consulta JPQL e retorna uma lista de objetos da classe instanciada. Para executar outros comandos, utilize o bloco Executar JQPL.

Open

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.

Open

A imagem a seguir exibe o componente grade com os alunos registrados e suas notas.

Open

Nesta página