AspNet6InDepth

Aprendiendo ASP.NET 6 en profundidad

1. Descripción general de ASP.NET 6

   • Historia y trasfondo
   • Estrategia de versiones
   • Instalación
   • Estructura del proyecto
   • SDK de .NET

2. Fundamentos de ASP.NET 6

   • Armado de la aplicación API ASP.NET 6 mediante .NET SDK
   • Analizando el archivo Program.cs
   • inyección de dependencia
     • Registrar objeto como vida única
     • Registrar objeto como duración de alcance
     • Registrar objeto como vida transitoria
   • Middlewares
     • Descripción general
     • Crear middlewares personalizados
       • Implementando la interfaz IMiddleware
       • Inyectando el objeto RequestDelegate
       • Escriba middlewares en línea usando app.Use , app.Map , app.MapWhen , app.UseWhen y app.Run
     • app.UseStaticFiles();
     • app.UseCors();
     • Agregar middleware Correlationid
     • Agregue middleware de excepción global no controlada y devuelva la respuesta estándar ProblemDetails
   • Configurar host
   • Configuraciones
     • Leer configuraciones desde appsettings.{environment}.json y la interfaz IConfiguration
     • Patrón de opciones
       • Vincular la configuración a C# POCO fuertemente tipado mediante la interfaz IOptions<T>
       • Vincule la configuración que puede recargarse en tiempo de ejecución a C# POCO fuertemente tipado usando la interfaz IOptionsSnapshot<T> o IOptionsMonitor<T>
   • Comprender HttpContext , HttpContext.Request y HttpContext.Response
   • Enrutamiento de atributos
     • Vincular múltiples rutas a un controlador usando el atributo Route
     • Pasar parámetros a métodos de acción utilizando parámetros de ruta
     • Verbos de acción HttpGetAttribute , HttpPostAttribute , HttpPutAttribute , HttpPatchAttribute y HttpDeleteAttribute
   • Encuadernación de modelos
     • Enlace de modelo de las siguientes fuentes
       • FromQuery : obtiene valores de la cadena de consulta
       • FromRoute : Obtiene valores de los datos de la ruta.
       • FromForm : obtiene valores de los campos del formulario publicados
       • FromBody : obtiene valores del cuerpo de la solicitud.
       • FromHeader : Obtiene valores de encabezados HTTP
   • Manejar respuestas usando IActionResult<T> o ActionResult<T>
   • Manejar la negociación de contenido usando el encabezado Accept
     • Enviar respuesta XML si el encabezado Accept está configurado en application/xml
     • Enviar respuesta JSON si el encabezado Accept está configurado en application/json
   • Control de versiones en API .NET6
   • Manejar solicitudes de tipo HTTP Patch
   • Validación del modelo
     • Uso de atributos de anotación de datos
       • Compare : valida si dos propiedades en un modelo coinciden.
       • EmailAddress : Valida si una propiedad tiene formato de correo electrónico.
       • Phone : Validar si una propiedad tiene formato de número de teléfono.
       • Range : valide si el valor de una propiedad se encuentra dentro de un rango específico.
       • RegularExpression : valida si el valor de una propiedad coincide con una expresión regular especificada.
       • Required : Validar si un campo no es nulo.
       • StringLength : valida si el valor de una propiedad de cadena no excede un límite de longitud especificado.
       • Url : Valida si una propiedad tiene formato URL.
     • Validación de FluentValidation utilizando métodos Fluent
   • Cliente HTTP
     • Creando IHttpClientFactory básico usando IHttpClientFactory.CreateClient();
     • Cliente Http con nombre
     • Cliente Http escrito
     • Agregue DelegatingHandler a clientes HTTP para ejecutar lógica común
     • Manejar excepciones HTTP usando la biblioteca Polly
   • Filtros
   • Comprimir el cuerpo de respuesta
     • Agregue compresión de respuesta usando el algoritmo gzip
   • Globalización y localización
   • Limitación de tasa
     • Limitación de velocidad mediante el paquete nuget AspNetCoreRateLimit con proveedor de memoria.
     • Limitación de velocidad mediante el paquete nuget AspNetCoreRateLimit y AspNetCoreRateLimit.Redis con el proveedor Azure Cache para Redis.
   • Explotación florestal
     • Comprender los niveles de registro
     • Registrar usando métodos de extensión ILogger<T>
       • mensajes de nivel de seguimiento de registro logger.LogTrace
       • mensajes de nivel de depuración de registro logger.LogDebug
       • logger.LogInformation mensajes de nivel de información de registro
       • logger.Warning mensajes de nivel de advertencia del registro
       • logger.Error de nivel de error de registro de errores
       • logger.Critical de nivel crítico de registro crítico
     • Iniciar sesión con el SDK Azure AppInsights
   • Servicios alojados
     • Implementar servicios alojados utilizando la interfaz IHostedService
     • Implementar servicios en segundo plano anulando la clase BackgroundService
   • Mapeo de objetos de un tipo a otro usando el paquete nuget Automapper
   • Patrón mediador
     • Implemente servicios débilmente acoplados utilizando el paquete nuget MediatR
   • Pavonearse
     • Instale Swashbuckle.AspNetCore nuget para agregar compatibilidad con Swagger OpenAPI
     • Agregar información y descripción de API
     • Agregar etiquetas de resumen para metadatos de nivel API
     • Agregar OperationIds a las API del grupo
     • Enriquecer los metadatos de la operación
     • Enriquecer metadatos de respuesta
     • Enriquecer metadatos de parámetros
     • Enriquecer metadatos del cuerpo de solicitud
     • Enriquecer metadatos del esquema
     • Agregar metadatos de etiqueta
     • Cambie el prefijo de ruta swagger para servir swagger.json desde el nivel raíz
     • Omitir las API para que sean visibles en Swagger
     • Genere múltiples documentos Swagger
   • Controles de salud

3. Acceso a datos en la aplicación API ASP.NET 6

   • Acceso a datos mediante Micro ORM Dapper y PostgreSQL

     • instalar npgsql
     • Instalar Dapper Micro ORM
     • Instalar Azure Data Studio
     • Configurar la base de datos Azure para PostgreSQL
     • Exponga las API CRUD utilizando Dapper MicroORM exponiendo los siguientes puntos finales
       • Paginación compensada /api/Persons?page=1&limit=10
       • Paginación del conjunto de claves /api/Persons?searchAfter=4499b79a-c710-45e4-ba87-083d22c4d6ad_2023-04-17T12:00:25&limit=10
       • Obtener soltero por id /api/Persons/b1333cad-9d7c-4a64-8823-db8c9aa55646
       • Crear /api/Persons
       • Actualización /api/Persons/b1333cad-9d7c-4a64-8823-db8c9aa55646
       • Eliminando /api/Persons/b1333cad-9d7c-4a64-8823-db8c9aa55646

   • Acceso a datos utilizando EF Core 6 ORM y PostgreSQL

     • Instalar EF Core 6
     • Instalar Azure Data Studio
     • Configurar la base de datos Azure para PostgreSQL
     • Agregue DbSet<T> a las tablas del modelo en la base de datos
     • Analizar DbContext
     • Crear patrón de repositorio con métodos de extensión DbContext
     • Agregar configuraciones para agregar restricciones a las tablas de la base de datos
     • Agregar datos de semilla
     • Agregar migraciones mediante scripts de migración de EF Core y la opción idempotent
     • Exponga las API CRUD mediante EF Core ORM exponiendo los siguientes puntos finales
       • Paginación compensada /api/Employees?page=1&limit=10
       • Paginación del conjunto de claves /api/Employees?searchAfter=4499b79a-c710-45e4-ba87-083d22c4d6ad_2023-04-17T12:00:25&limit=10
       • Obtenga soltero por id /api/Employees/b1333cad-9d7c-4a64-8823-db8c9aa55646
       • Crear /api/Employees
       • Actualización /api/Employees/b1333cad-9d7c-4a64-8823-db8c9aa55646
       • Eliminando /api/Employees/b1333cad-9d7c-4a64-8823-db8c9aa55646

4. Almacenamiento en caché de respuestas en la aplicación API ASP.NET 6

   • Agregar almacenamiento en caché de memoria usando IMemoryCache
   • Agregue almacenamiento en caché distribuido mediante Azure Cache para Redis y StackExchange.Redis

5. Seguridad en la aplicación API ASP.NET 6

   • Agregar autenticación

     • Comprender Claim , ClaimsIdentity y ClaimsPrincipal
     • Implementar autenticación básica
     • Implementar autenticación de cookies
     • Implementar autenticación JWT (personalizada)
       • Hash de contraseñas de texto sin formato utilizando el algoritmo BCrypt y el nuget BCrypt.Net-Next
       • Genere JWT usando System.IdentityModel.Tokens.Jwt
       • Agregue las siguientes API
         • /api/Account/Register para registrar el usuario
         • /api/Account/Login para iniciar sesión como usuario y generar el conjunto inicial de token de acceso y token de actualización
         • /api/Account/Token para actualizar el token de acceso usando el token de actualización enviado
         • /api/Account/Revoke para revocar el token de actualización

   • Agregar autorización

     • Implementar autorización basada en roles
     • Implementar autorización basada en políticas
       • Comprender los "requisitos" de las políticas e implementar la interfaz IAuthorizationRequirement
       • Anule HandleRequirementAsync para crear un requisito de política personalizado
       • Registre el requisito personalizado en Program.cs

   • Estudio de caso: agregar autenticación JWT y autorización de rol mediante Auth0

     • Comprender OAuth2
     • Comprender las terminologías de OAuth2
     • Comprender los flujos de OAuth
       • Flujo implícito
       • Flujo de credenciales del cliente
       • Flujo de código de autenticación
     • Crear aplicación en Auth0
     • Establecer URL de redireccionamiento en Auth0
     • Asegure todos los puntos finales de API usando Auth0
     • Definir permisos en la API y realizar autorizaciones de políticas.

6. Manejo de cargas y descargas de archivos

   • Cargas de archivos
     • Manejar la carga de archivos únicos o múltiples
     • Almacene el archivo cargado localmente en wwwroot folder
     • Almacenar el archivo cargado en contenedores de Azure Blob Storage
   • Descargas de archivos
     • Transmitir archivo CSV a la respuesta
     • Transmita el archivo Excel .xlsx a la respuesta

7. Pruebas

   • Pruebas unitarias

     • Agregar pruebas unitarias usando xUnit.net
     • Comprensión de [Fact] y [Theory]
     • Inicializar datos de prueba usando el constructor
     • Datos de prueba de limpieza utilizando el método Dispose
     • Crear pruebas parametrizadas
       • Pasar parámetros primitivos usando [InlineData]
       • Pase parámetros primitivos y complejos usando [MemberData]
       • Pase parámetros primitivos y complejos usando [ClassData]
     • Comparta el contexto de prueba en la misma clase usando IClassFixture
     • Comparta el contexto de prueba entre varias clases usando ICollectionFixture
     • Simular un servicio de dependencia usando Moq
     • Verifique si se llamó al servicio simulado usando Verify() o VerifyAll()

   • Pruebas de integración

     • Cree una fábrica de aplicaciones web personalizada heredando WebApplicationFactory<TStartup>
     • Utilice la base de datos EF Core In Memory para pruebas de integración
     • Escribir pruebas de integración para API usando xUnit.net

8. Comunicación síncrona entre servicios mediante gRPC y HTTP2

   • Cree una API de puerta de enlace y una API interna que se comuniquen entre sí de forma sincrónica mediante gRPC

9. Comunicación asincrónica entre servicios mediante colas de mensajes

   • Cree una API de puerta de enlace y API internas (función de Azure) que se comuniquen entre sí de forma asincrónica mediante Azure Service Bus.

10. Alojamiento de la aplicación API ASP.NET 6

    • Hospede la aplicación API ASP.NET 6 usando IIS y publicación de carpetas
    • Hospede la aplicación API ASP.NET 6 mediante Azure App Service y publicación manual