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:
Classe da TabelaA 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
É 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.
Nenhum comentário