Buenas prácticas para usar MinimalAPI en ASP.NET Core

https://restofmycloud.com/events/buenas-practicas-para-usar-minimalapi-latinonetonline

Transcript

2. { "name": "Lautaro Carro", "username": "@lauchacarro ", "award": "Microsoft MVP ", "certifications": [“AZ-900", “AZ-204"] "activities": ["Latino .NET Online", "Rest Of My Cloud"] }
3. TEMAS ❑ La historia de MinimalAPI ¿Cómo surgió? ❑ Repasar Arquitectura Tradicional de 3 Capas ❑ Implementar las Mejores Practicas ❑ Conclusiones
4. ¿Qué es MinimalAPI? ❑Minimal API es un enfoque ligero y moderno para construir APIs, introducido en .NET 6. ❑ Su objetivo es permitirte escribir APIs rápidas, limpias y concisas sin la necesidad de controladores (Controllers), clases adicionales ni mucha configuración.
5. La historia de MinimalAPI
6. .NET Minimalista ❑ Quitaron la clase Startup.cs ❑ Program.cs sin declaraciones de clase ❑ Los usings pueden ir en un archivo global ❑ Los namespaces ya no necesitan llaves/Brackets ❑ Simplificaron el desarrollo de WebApis con MinimalApi
7. Las criticas a Microsoft ❑ Se decía que MinimalApi es una copia de NodeJs ❑ Se decía que Microsoft quería retener a los devs para que no migren a otra tecnología. ❑ Al principio con MinimalApi no lograbas hacer todo lo que se podía hacer con Controllers
8. Arquitectura Tradicional de 3 Capas
9. Arquitectura Tradicional (3 Capas) Presentación (UI/Api/Consola) Aplicación (Lógica de negocio) Infraestructura (DB, Servicios Ext)
10. Practica 1: Versionado de Apis
11. Grupo de Endpoints ❑ Son una forma de agrupar endpoints relacionados bajo una raíz común, ❑ Permite realizar configuraciones compartida. ❑ Se pueden anidar grupos dentro de grupos ❑ Son una gran opción para versionado de apis
12. Grupo de Endpoints /Api /v1 /Products Create Product Update Product Get All Products
14. Practica 2: Mantener estilo Minimalista
15. IEndpointRouteBuilder VS RouteHandlerBuilder Característica IEndpointRouteBuilder RouteHandlerBuilder Tipo Interfaz para agregar rutas Clase para configurar un endpoint mapeado Contexto de uso Nivel global o grupal Nivel individual de cada endpoint Se usa para Crear y registrar rutas o grupos de rutas Agregar configuraciones a un endpoint Métodos comunes MapGet, MapPost, MapGroup, MapControllers, etc. RequireAuthorization, WithOpenApi, WithName, etc. Fluidez/Encadenamiento No encadena llamadas Sí, permite llamadas encadenadas (fluent API) Uso común en Minimal API Definir estructura general y agrupar rutas Configurar detalles como autenticación, Swagger, validaciones
17. Practica 3: Sola una linea de código
18. Patrón Result ❑ El patrón Result encapsula el resultado de una operación, incluyendo su éxito o error. ❑ Evita el uso excesivo de excepciones para controlar errores esperados. ❑ Generalmente contiene una propiedad IsSuccess y un mensaje o dato asociado. ❑ Facilita código más limpio y predecible al manejar flujos de éxito y fallo de forma explícita.
19. Patrón Result
20. Patrón Result
22. Conclusiones
23. CONCLUSIONES ❑ MinimalAPI esta construido con Métodos de Extensión. Necesitamos de los mismos para poder trabajar con estos endpoints. ❑ El objetivo de mantener todo minimalista es que solo se preocupen por la lógica de negocio y no en como crear los endpoints ❑ Con MinimalApi podes hacer exactamente lo mismo o más que con Controllers…. Solo que más sencillo
24. MUCHAS GRACIAS