Executar Consulta JPQL

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

Parâmetros de Entrada

Retorno

Uma lista de objetos.

Compatibilidade

Image Removed Servidor

Exemplo 1

A função abaixo executa uma consulta na tabela User, filtrando pelos usuários que possui o campo "emailConfirmed" como "true" e retorna uma lista de itens da entidade app.entity.User. Em seguida imprime o nome desses usuários no console.

Image Removed

Image Added

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.

Image Added

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.

Image Added

Figura 2.1 - Alunos registrados e suas notas