Ir para o conteúdo principal

API's e Serviços

Desenvolvimento Back-End

Mapeamento de Tabelas

Para esse projeto, não usaremos o Entity Framework, usaremos ADO.NET puro para reaproveitar as rotinas já existentes no STM (VB)

Dito isso, não teremos entidades, repositorios, ef config e etc

Para mapeamento, deve ser criado uma classe com exatamente os mesmos nomes e tipos de dados existentes na tabela (usar PL/SQL para consultar)

Exemplo:

Tabela no PL/SQL

Classe da Tabela

A Classe deverá ser criada em: \Domain\TableMaps

Criação da API e Rotas Essenciais

Para garantir o funcionamento das nossas API's, utilizaremos esse padrão em suas criações.

  • Uma váriavel do tipo "VariavelGlobal" que deverá ser instanciada no construtor da nossa classe, através do método: "GetVariavelGlobal.Executar()"
  • Uma váriavel do tipo string, chamada "_pkg" que irá armazenar o nome da package que armazena as rotinas do módulo em questão.

Essas variáveis são essenciais para o funcionamento dos nossos executores genéricos.

Todos os serviços de executores necessitam da variável global para funcionar

Rotas
  • Campos Mapeados

É necessária uma rota para obter os campos do sistema mapeados, isso acontecerá através de um service de estrutura padrão, como no exemplo a seguir:

No primeiro método, usaremos de um SELECT na tabela em questão, através da chave primária do registro, usando nosso executor de querys.

Já no segundo, usaremos do nosso serviço "MapearCamposConsulta", passando a nossa classe. o retorno do "Executar" e a sigla da nossa tabela.

Essa rota deverá existir em todas as API's

  • Pesquisa

    Rota utilizada para realizar pesquisas na nossa tela de "lista", deverá ser criado um serviço que utiliza de querys para encontrar os dados desejados, como no exemplo a seguir:

    Os filtros e consulta deverão ser alterados conforme necessidade.

  • Inclusão

    Deverá seguir o padrão, recebendo o objeto a ser incluido. A próxima seq. deve ser obtida através do service do exemplo e mapeada a PK do objeto que recebemos, para então realizar a inclusão.