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