Web api, más allá del 'hola mundo'
1 recomendación397 vistas
El documento habla sobre cómo organizar proyectos de WebApi más allá de los ejemplos básicos "Hola Mundo". Aborda temas como inyección de dependencias, autenticación y autorización, documentación del API, versionado, pruebas unitarias e integración y más. Proporciona enlaces a repositorios de GitHub con ejemplos de implementación de estas técnicas.
Web api, más allá del 'hola mundo'
- 2. WebApi, más allá del “Hola mundo” 19/10/2017
- 3. Hugo Biarge Development Advisor at Plain Concepts [email protected] @hbiarge
- 4. www.plainconcepts.com MADRID Paseo de la Castellana 163, 10º 28046 Madrid T. (+34) 91 5346 836 BILBAO Ledesma 10-bis, Planta 3 dpto 2 48001 Bilbao T. (+34) 94 6073 371 BARCELONA Av. Josep Tarradellas 10, 6º 1ª 08029 Barcelona T. (+34) 93 3607 114 SEVILLA Avenida de la innovación s/n Edificio Renta Sevilla, 3º A 41020 Sevilla DUBAI Dubai Internet City. Building 1 73030 Dubai. EAU T. (+971) 4 551 6653 LONDON Impact Hub Kings Cross 24B York Way, N1 9AB London. UK SEATTLE 1511, Third Ave Seattle WA 98101. USA T. (+1) 206 708 1285
- 5. Agenda Organización de proyectos Inyección de dependencias Autenticación y autorización Documentación del api Versionado Implementación de los métodos de acción (CQRS) Test de integración y unitarios https://github.com/hbiarge/WebApi-Sample
- 7. Organización de proyectos Api como proyecto de librería de clases • Reutilizable en múltiples hosts • Perdemos tooling
- 8. Inyección de dependencias DependencyResolvers • Elige tu contenedor de IoC Conoce la raíz de composición de WebApi Cómo gestiona IDisposable tu contenedor? Piensa en el ciclo de vida de tus dependencias
- 9. Autenticación y autorización Diferencia entre 401 y 403 • Sobrescribe la implementación por defecto ClaimsPrincipal tiene más información que los roles • Utiliza los claims que necesites para tomar decisiones sobre autorización https://github.com/DavidParks8/Owin-Authorization
- 10. Documenta tu API Swagger • Estandar de facto Gran ecosistema • Genaradores de código para clientes (C#, TypeScript, JS, …) https://github.com/domaindrivendev/Swashbuckle
- 11. Versiona tu API Permite evolucionar más fácilmente un API pública con clientes Diferentes estrategias • Url/query string • Media Type https://github.com/Microsoft/aspnet-api-versioning
- 12. Implementación de los métodos de acción Separación de lecturas y escrituras • CQRS Comands and queries • Micro-ORM en las queries • DDD en los comandos MediatR • Bus en memoria https://github.com/jbogard/MediatR
- 13. Testea tu API Muy fácil montar integración • TestServer de Owin • TestServer es un host más de tu API • End-2-End con base de datos Haz test unitarios donde corresponda • No pruebes la infraestructura • Prueba la lógica
- 15. www.plainconcepts.com MADRID Paseo de la Castellana 163, 10º 28046 Madrid T. (+34) 91 5346 836 BILBAO Ledesma 10-bis, Planta 3 dpto 2 48001 Bilbao T. (+34) 94 6073 371 BARCELONA Av. Josep Tarradellas 10, 6º 1ª 08029 Barcelona T. (+34) 93 3607 114 SEVILLA Avenida de la innovación s/n Edificio Renta Sevilla, 3º A 41020 Sevilla DUBAI Dubai Internet City. Building 1 73030 Dubai. EAU T. (+971) 4 551 6653 LONDON Impact Hub Kings Cross 24B York Way, N1 9AB London. UK SEATTLE 1511, Third Ave Seattle WA 98101. USA T. (+1) 206 708 1285