Executa os comandos de uma procedure previamente criada no banco de dados e retorna uma lista de dados da mesma.
Parâmetros de Entrada
Nome
Tipo
Doc
Parâmetro 1
String
Informa o nome do pacote (namespace) que contém a entidade
Parâmetro 2
String
Nome da procedure no banco de dados
Parâmetro 3
Objeto
(Opcional) Campo para informar os dados dos parâmetros da procedure
Parâmetro 4
String
(Opcional) Informe o nome da classe Java para retornar a lista de objetos com os campos definidos ou deixe em branco para retornar listas com os valores dos registros.
Retorno
Retorna uma lista de dados.
Compatibilidade
Servidor
Exemplo 1
Ao criar uma procedure, como mostrado na Figura 1.1, a função Executar procedure retornando dados (Figura 1.2) faz a sua chamada, passando o namespace que se encontra a entidade, o nome da procedure e o valor do parâmetro através de uma lista. Ao final, ele irá retornar um array com os dados do comando executado (nesse caso, os dados referente aos campos titulo e gênero da entidade Música).
Figura 1.1 - Procedure criada
Na figura abaixo o bloco retorna uma lista com várias sub-listas que contém os valores dos campos requisitado na procedure.
Figura 1.2 - Executando a procedure
Exemplo 2
Nesse exemplo, ao informar a classe de retorno da procedure, ele irá retornar uma lista de objetos, com os respectivos campos (definidos na classe) e seus valores (Figura 2.1). A classe pode ser gerada pelo diagrama ou criada manualmente, mas ela deve conter os campos da procedure (conforme mostrado no bloco de programação) na mesma ordem - ou seja, a ordem dos campos definidos na classe Java devem ser iguais aos campos retornados pela procedure. No exemplo da figura 2.1, foi criado os valores título e genero na classe Java nessa respectiva ordem pois a procedure retorna os valores titulo e genero da entidade Musica.
Classe Java Music
package goh;
/**
* Classe que representa ...
*
* @author Deborah Carvalho
* @version 1.0
* @since 2020-09-15
*
*/
public class Music {
/**
* Construtor
**/
public Music (){
}
public String titulo;
public String genero;
}
Quando informado uma classe no último parâmetro, o retorno da procedure será convertido em uma lista de objetos (Figura 2.1).
Figura 2.1 - Executando a procedure informando a classe de retorno
Sobre procedure
Procedure é um conjunto de comandos em SQL que podem ser executados de uma só vez, como em uma função. Ele armazena tarefas repetitivas e aceita parâmetros de entrada para que a tarefa seja efetuada de acordo com a necessidade individual.