ProWebAPI

Este documento detalha a implementação de uma API ASP.NET Core robusta e padronizada usando ProWebAPI. Abrange aspectos importantes como integração Swagger, injeção de dependência, respostas padronizadas, controle de versão, validação de solicitação, suporte OData v4, tratamento de exceções globais e EF Core com UnitOfWork. O guia fornece instruções passo a passo para cada componente.

ProWebAPI

API ASP.NET Core com todos os padrões adequados

Padrões implementados

Arrogância

Instalar o Swagger

Configuração DI

Resposta padrão para API

Resposta padrão

Versionamento

Instale a biblioteca Nuget

Adicionar ao contêiner de dependência

Decore os controladores com base na necessidade

Solicitar Validador

Instale a biblioteca Nuget

Cadastrar validadores no DI

No namespace 'RequestDto', adicione os validadores junto com dto

Construir um ValidationFilter

Registre o filtro e desative [ApiController] interceptação automática de 400 Bad Request

AppSettings.json

Configurar appsettings para bancos de dados

Crie 2 configurações de AMBIENTE

OData v4

Para oferecer suporte ao OData, instale o NuGetpackages

Adicionar ao serviço DI para OData

Configurar OData

Substitua o atributo [EnableQuery] por [EnableOData] para detectar erros e retornar resposta padrão

Decore o Método de Ação

Consulta por URL

Manipulador de Exceção Global

Crie o Middleware

Crie um método de extensão para o construtor de aplicativos

Registre o middleware

Caixa de resposta

Permitir maiúsculas e minúsculas de membros (que estarão em maiúsculas e minúsculas para adereços) para que o resultado da consulta OData não entre em conflito com maiúsculas e minúsculas

EF Core + UnitOfWork

Adicione bibliotecas de classes de suporte

Instale os pacotes necessários no ProWeb.Data

Para executar migrações

DEFINIR ProWeb.Data como [Projeto de inicialização] e executar migrações