Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Executar procedure retornando dados

Executa os comandos de uma procedure previamente criada no banco de dados e retorna uma lista de dados da mesma.

Parâmetros de Entrada

NomeTipoDoc
Parâmetro 1StringInforma o namespace da entidade nome do pacote (namespace) que contém a procedureentidade
Parâmetro 2StringNome da procedure no banco de dados
Parâmetro 3Objeto(Opcional) Campo para informar os dados dos parâmetros da procedure
Parâmetro 4String(Opcional) Informa Informe o nome da classe Java que deseja para retornar a lista da procedurede objetos com os campos definidos ou deixe em branco para retornar listas com os valores dos registros.

Retorno

Retorna uma lista de dados.

Compatibilidade

blockly_server.pngServidor

Diagrama de dados dos exemplos

Neste tutorial estamos utilizando o diagrama abaixo (Figura 1).


Image AddedFigura 1 - Diagrama de dados

Exemplo 1

Ao criar uma procedure, como mostrado na Figura 1.1, a função executar 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 (caso tenha parâmetro) e o endereço da classe para que essa procedure irá retorne a lista (caso deseje).

Image Removed

Figura 1.1 - Procedure criada

Image Removed

nesse caso, os dados referentes aos campos titulo e genero da entidade Music).


Image Added

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, por padrão é utilizado a classe gerada pelo diagrama gerada dentro de entity.


Image Added

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 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 retornado uma lista de objetos com os atributos titulogenero contidos, e na mesma ordem, na classe (Music2.java - Figura 2) e também na procedure (minhas_musicas - Figura 1.1).


Informações

No nosso exemplo, criamos a classe Music2.java dentro do namespace app2.


Image Added

Figura 2 - Classe Java utilizada no segundo exemplo


Bloco de código
languagejava
themeConfluence
titleClasse Java Music
package app2;


/**
 * Classe que representa ...
 * 
 * @author Wesley Miranda De Oliveira
 * @version 1.0
 * @since 2022-08-24
 *
 */
 
public class Music2 {

	/**
	 * Construtor
	 **/
	public Music2 (){
	}

	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). O resultado final obtido será um array de objetos com os títulos e gêneros das músicas que estão cadastradas como favoritas.


Image Added

Figura 2.1 - Executando a procedure informando a classe de retorno

Figura 1.2 - Executando a procedure


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.


Nesta página

Índice