Ir para o conteúdo principal

Executores

Objetivo

Foi desenvolvida uma forma de facilitar a execução de packages, querys e functions no banco de dados. Visando uma maior produtividade e exito na migração das rotinas ja existentes no STM VB.

Os executores se encontram disponiveís na biblioteca Cebi.Stm.Executor que já está instalada nos módulos do stm web.

Váriavel Global

Todos os executores, necessitam da carga de váriavel global, elas já são instanciadas em todas as nossas controllers

Querys

O Executor de query é o mais simples, voce deverá montar a consulta sql em uma string, e passar essa consulta como parametro no construtor do executor:

Esse executor possuí 2 métodos:

  • GetSingle<<T></T>T>
  • GetList<<T></T>T>

    O primeiro, irá retornar apenas 1 linha do resultado da query, indicado para consultas por chaves primárias.

    Já o segundo, retorna todas as linhas.

Em ambos os métodos, deverá ser informada a classe de retorno no parametro T da execução
Os campos da classe devem ter o mesmo nome dos campos de retorno. Deverá também ser informado no método a carga de variável global.

Packages

Para a execução de packages, no nosso construtor passamos 2 parametros:
  • Nome da Pkg a ser executada
  • Se o retorno é um record set

O uso ou não do record set será informado pela equipe, por ser um parametro opcional, se não for informado no construtor, seu valor sera "false"

o Executor, tem uma propriedade chamada "Parametros", de tipo "List< object >", que deve ser mapeada da seguinte maneira:

Deverá ser informado na instancia da classe o tipo de dado do parametro.
Os parametros também devem estar na mesma ordem da package no banco de dados

Métodos de Execução
  • ExecuteVoid Esse método não tem nenhum tipo de retorno, apenas executa a pkg.
  • GetList<<T>T> Esse método retorna uma lista do objeto do tipo informado no parametro T
  • GetNextSeq Esse método, é utilizado para obter a proxima sequence do modulo desejado, retornando um valor do tipo "int"

Todos os métodos devem receber a variavel global como parametro

Functions

As functions funcionam de forma parecida das packages, as diferenças são:

  • Váriavel de Retorno:

    Em sua instancia, deverá ser informada na variavel "Retorno" o tipo de dado oracle que a function retorna:

  • Parametros Devem ser informados da mesma forma que nas packages.

  • Retorno de Execução Deverá ser informado no parametro de tipo T qual o tipo do retorno da function, exemplo:

    O método deve receber a variavel global como parametro