2.13.8 SE/Diseño de API y Modelado

Temas:
Core

• Principios de diseño de API
  1. Consistencia
     1. Las API consistentes son más fáciles de aprender y menos propensas a errores
     2. La consistencia es tanto interna (entre diferentes partes de la API) como externa (siguiendo patrones comunes de API)
  2. Capacidad de composición (composability)
  3. Documentación de contratos
     1. Las operaciones de la API deben describir su efecto en el sistema, pero generalmente no su implementación
     2. Precondiciones, postcondiciones e invariantes
  4. Capacidad de expansión (expandability)
  5. Reporte de errores
     1. Los errores deben ser claros, predecibles y accionables
     2. La entrada que no coincida con el contrato debe producir un error
     3. Los errores que pueden gestionarse de manera confiable sin reportarse deben gestionarse
• Identificar y codificar invariantes de datos e invariantes temporales
• Modelos estructurales y de comportamiento de diseños de software

Aprendizaje esperado (Learning Outcomes):
Core:

1. Diseñar una API para un solo componente de un sistema de software grande, incluyendo la identificación y documentación de las invariantes, el contrato y las condiciones de error de cada operación [Diseñar]
2. Evaluar una descripción de API en términos de consistencia, capacidad de composición y capacidad de expansión [Evaluar]
3. Expandir un diseño existente para incluir una nueva funcionalidad [Crear]