ProWebAPI

Este documento detalla la implementación de una API ASP.NET Core robusta y estandarizada utilizando ProWebAPI. Cubre aspectos clave como la integración de Swagger, la inyección de dependencia, las respuestas estandarizadas, el control de versiones, la validación de solicitudes, la compatibilidad con OData v4, el manejo global de excepciones y EF Core con UnitOfWork. La guía proporciona instrucciones paso a paso para cada componente.

ProWebAPI

ASP.NET Core API con todos los estándares adecuados

Estándares implementados

Pavonearse

Instalar arrogancia

Configurar DI

Respuesta estándar para API

Respuesta estándar

Versionado

Instalar la biblioteca Nuget

Agregar al contenedor de dependencia

Decora los controladores según la necesidad.

Validador de solicitudes

Instalar la biblioteca Nuget

Registrar validadores en DI

En el espacio de nombres 'RequestDto', agregue los validadores junto con dto

Construir un filtro de validación

Registre el filtro y desactive [ApiController] intercepción automática de solicitudes incorrectas 400

AppSettings.json

Configurar ajustes de aplicaciones para bases de datos

Crear 2 configuraciones de ENTORNO

OData v4

Para admitir OData Instale los paquetes NuGet

Agregar al servicio DI para OData

Configurar OData

Anule el atributo [EnableQuery] con [EnableOData] para detectar errores y devolver una respuesta estándar

Decora el método de acción.

Consulta por URL

Controlador de excepciones globales

Crear el software intermedio

Crear un método de extensión para el creador de aplicaciones

Registrar el middleware

Carcasa de respuesta

Permitir mayúsculas y minúsculas para miembros (que estarán en pascal para accesorios) para que el resultado de la consulta de OData no entre en conflicto con mayúsculas y minúsculas.

EF Core + Unidad de trabajo

Agregar bibliotecas de clases de soporte

Instale los paquetes necesarios en ProWeb.Data

Para ejecutar migraciones

ESTABLEZCA ProWeb.Data como [Proyecto de inicio] y ejecute migraciones