Tag Archive for ddd

Mapeo, DTO’s y ViewModels en ASP.NET MVC

Los DTO’s –Data Transfer Objects- (algunos los llaman ViewModels/EditModels según el uso para el que existan) nacen por una razón específica: El modelo de lo que ves en la vista no representa directamente tu modelo de negocio. Mi ejemplo tradicional siempre ha sido el formulario de Login/Usuario/Contraseña.

Con el pasar del tiempo mi postura hacia este tema ha sido variada y se ha hecho bastante flexible. Por ejemplo, si tu modelo y tu aplicación es lo suficientemente sencilla y sabes que luego de eso jamás se va a modificar ni cambiar entonces es suficientemente fácil quedarte con el modelo y permearlo hacia la vista y vice versa, eso es precisamente lo que hace la generación Rails/Django/Whatever y lo que solemos hacer con MonoRail y Castle ActiveRecord, ¿la razón? simple, el modelo es sencillo, el dominio es sencillo y no es un proyecto complicado.

Para bien o para mal, en el entorno en que muchos se mueven no se ven cosas tan estáticas y los modelos y reglas de negocio son mucho más complejos siendo generalmente nuestros modelos de negocio , de hecho, si trasladamos eso a una visión de diseño orientado a servicio las cosas cambian aún más (ni hablemos de una "DDD shop"), lugares donde vemos que esta regla se revienta es en sistemas empresariales al estilo CRM/ERP o las siglas que sean…

En el contexto de una aplicación MVC se sobreentiende que el viewmodel es un concern de la vista, por lo tanto esta restringido a los conceptos de presentación. Recordemos también que un controller también es un concern de la vista (si, para aquellos que siguen creyendo que el controlador es la lógica de negocio, les vuelvo a romper el corazón en este momento), un buen lugar para que vivan los viewmodels es dentro de la aplicación MVC, surge el problema entonces, ¿cómo mapeo de un modelo de negocio al modelo de la vista?, bueno, les presento un par de ideas.

Usando el mapper como un servicio

Podemos usar un mapper automático como nuestro intermediario en el controlador entre el modelo de dominio y el viewmodel y de esta manera separar e injectar el mapper en el controlador

public class OrdersController : BaseController {
    readonly IOrdersRepository _ordersRepository;
    readonly IOrdersMapper _mapper;

    public OrdersController(IOrdersRepository ordersRepository, IOrdersMapper mapper) {
        _ordersRepository = ordersRepository;
        _mapper = mapper;
    }

    public ViewResult List() {
        var orders = _ordersRepository.FindAll();
        View(_mapper.Map(orders));
    }
}

Usando un Application Service

En este caso el Application Service se encarga de tomar las decisiones y luego retornar hacia el controlador los resultados, en este caso el controlador no sabe nada de la entidad original del dominio ni sobre el repositorio original, este es sumamente flexible cuando nuestro dominio original suele cambiar drásticamente o tomar decisiones muy complejas para delegárselas al controlador. En este caso es posible que a su vez el mapper sea inyectado y sea una dependencia del servicio. De hecho, podría ser que el servicio no use un mapper para nada, si no que simplemente arme el resultado usando varias uniones de otros resultados sobre la marcha (usando LINQ por ejemplo).

public interface IOrdersService {
    IEnumerable<OrderView> GetOrders();
}

public class OrdersController : BaseController {
    readonly IOrdersService _orderService;
    public OrdersController(IOrdersService orderService) {
        _orderService =  orderService;
    }

    public ViewResult List() {
        var orders = orderService.GetOrders();
        View(orders);
    }
}

Delegando el mapeo a un ModelBinder y ActionFilter

Debo admitir que aunque este es uno de mis resultados o formas favoritas de hacerlo en una aplicación MVC, lo siento a mi criterio demasiado “opionated” (entiéndase, fumado o cargado). En este escenario no es responsabilidad directa ni de un mapper ni de un servicio el retornar los resultados esperados, si no de un Model Binder junto con un ActionFilter en ASP.NET MVC. El controlador luciría algo así:

public class OrdersController : BaseController {
    readonly IOrdersRepository _ordersRepository;

    public OrdersController(IOrdersRepository ordersRepository) {
        _ordersRepository = ordersRepository;
    }

    [Automap(typeof(Order), typeof(OrderView)]
    public ViewResult List() {
        var orders = _ordersRepository.FindAll();
        View(orders);
    }
}

Este último caso es bastante flexible pero involucra que conozcamos bien que es un Model Binder y un ActionFilter, claro, nada que un par de minutos al frente de Visual Studio no pueda solucionar :)

Debo admitir que el caso de usar un Application Service me parece más natural si nuestra aplicación es simplemente un front end a una infraestructura orientada más hacia servicios que hacia un modelo directo de consumo (entiéndase, cosas como un ERP/CRM que probablemente usemos sus interfaces por otro lado y no solamente en nuestra aplicación de “CRUD”) y es mucho más flexible para casos en que necesitamos aislar completamente la “orquestración” del resultado del “despliegue” del resultado, suena extraño al principio pero se me ocurren bastantes casos donde esto se puede presentar.

Debo hacer notar que estas observaciones son meramente orientadas al contexto de una aplicación en ASP.NET MVC y no directamente se pueden trasladar a una aplicación o a un Tier en WCF, en este caso lo único que debemos compartir entre servicios es su esquema, no sus objetos.

Como siempre, espero sus comentarios o críticas al respecto, siempre son bienvenidas, recuerden, estamos en este barco del aprendizaje todos juntos como marineros.

¡Saludos!

UPDATE: Mi amigo José Romaniello me comenta del uso de una interface estilo IMapper en vez de una especializada para mapeo (como lo es IOrdersMapper), este patrón de uso lo considero igual al uso de una especializada, por lo tanto no la incluyo.

UPDATE 2: No incluyo implementaciones definidas de como crear estos mappers, para esto se puede hacer de forma directa o usando una herramienta de mapeo de clases como Automapper, pero eso lo dejo para otro post futuro.

El espejismo de la separación por “capas”

Algo que comúnmente escucho en el círculo de desarrolladores (especialmente de .Net) es la frase “esto va en la capa de datos” o un “esta regla de negocio esta en la capa de negocio” y hasta un “mira, esta hecho pero aún no están bien separadas las capas”.

Esta palabrita, “capas”, es una de esas buzzwords de arquitectura microsoftica que nos han quedado grabadas en el cerebro, y que debido a que ha sido usada por tanto tiempo, ya la decimos instintivamente y hasta llegamos a creer que si un developer no habla en “capas” no es de respetar.

Comencemos a analizar lo que nos venden cuando hablamos de “capas”. Por lo general la terminología de capas se aplica a la típica arquitectura jerárquica de tres niveles, denotando responsabilidades diferentes y niveles de acceso variables en cada una de ellas, siendo la más conocida de todas la arquitectura de “tres capas”: Data Layer, Business Layer, Presentation Layer.

IC351011

Personalmente creo que este tipo de “ensamblaje” cobra bastante sentido si desarrollabas hace más de 5 años atrás, es decir, los ORM eran “escasamente” conocidos, los DataSet’s reinaban en el mundo de Ado.Net, los webservices no eran más que una extensión de la ASP.NET framework, el desarrollo en Windows y Web se limitaba en su gran extensión a arrastrar y soltar controles sobre un lienzo y crear un test era cosa de escribir en un papel y decirle a alguien que “probara la aplicación”… ¡ahhh, épocas lejanas aquellas! (bueno, creo que mucho de lo que menciono aquí aún esta presente en la lucha hasta el sol de hoy, pero ese es otro tema).

Actualmente muchos siguen desarrollando de esa manera, algunos han llevado esto aún más lejos y se han atrevido a hablar de arquitecturas de dos capas y hasta de n-capas… Hay libros, guías (como esta) y muchísimos posts en internet conversando de como usar Nhibernate o la Entity Framework en un entorno de n capas, como concurso, mientras más capas tenga tu aplicación, mayor será tu “mérito”.

He llegado a entender a aquellos defensores de las arquitecturas por capas, y en base a ello he formulado un conjunto de opciones por las cuales aún hablamos acerca de “capas”

  • Han tanta lógica en la base de datos que hay que distinguir las reglas embebidas en la base de datos de aquellas embebidas en cualquier otro lugar, por lo tanto, hablamos de las reglas de la “capa de datos”
  • La base de datos es mi salvador, por lo tanto debo separarla y distinguirla del resto de código “mortal” de la aplicación
  • La presentación de los datos es tan compleja, que bueno, el codebehind es inmenso y merece tener su propia “capa” debido al tamaño
  • Sigo usando DataSets o procedimientos almacenados que son leídos por DataReaders y al final debo manipularlos para sacar los datos de una factura, consumidor o lo que sea, por lo tanto tengo que distinguir esas responsabilidades en su propia “capsula”
  • No sé que rayos es un Tier y a falta de mejor palabra le llamo Layer

Como sea, pronto conversaremos de porqué el concepto de “capa” está un poco pasado de moda y las opciones que tenemos a la mano para reemplazar la ya vieja arquitectura por capas por una mucho más holística basada en modelos de comportamiento y responsabilidades modeladas a base del dominio y no por imaginación de un arquitecto.

Como siempre, estoy abierto a comentarios en la zona de comentarios, twitter, mail o cualquier otro medio por el cual esporádicamente puedan encontrarme.

¡Hasta la próxima!

Repository, IQueryable y otras hierbas

Desde hace varios días hay una thread muy interesante acerca de separación de responsabilidades, repositorio, validación y otras hierbas en la lista de correo d Alt.Net Hispano, antes de continuar, les recomiendo una merecida lectura.

El punto expuesto por José Romaniello y que a su vez toma como base las enseñanzas de Fabio Maulo no puede estar más cargado de razón. Anteriormente como menciona Carlos Peix, cuando Fowler y Eric Evans en su libro DDD definieron Repository no existía el concepto de IQueryable y creo que no muchos se lo veían venir, así que simplemente si asociamos que Repository es una abstración superior del acceso a datos y este se debe comportar como una colección en memoria (mezclando las definiciones de Fowler y Evans) y coincidimos en que en la .Net Framework las colecciones pueden extenderse a IQueryable, es fácil razonar que por definición un repositorio finaliza implementando IQueryable<T> (mera jalada mi filosofía y asociación, pero para filósofo preguntémosle mejor a @ajlopez!)

Bien, sin embargo exponer IQueryable<T> directamente tiene un par de problemas e implicaciones, principalmente relacionados con la semántica de la colección y el acceso a ella. Estoy desacuerdo que la definición o diferencia entre dao y repository es cada vez más difusa, de hecho, comparto la visión de usar un Dao y exponer el acceso a los datos a través de ella, ahora bien, la pregunta del millón se traduce en la siguiente, cómo debe lucir mi Dao? Quizás algo similar a como lo expone Fabio y José:

public interface IDao<T> {
    IQueryable<T> Retrieve(Expression<Func<T, bool>> predicate);
    IQueryable<T> Count(Expression<Func<T, bool>> predicate);
}

¿Un momento, porqué exponer IQueryable<T> y no IEnumerable<T>? O sea, no estoy dándole a mis consumidores demasiado poder en lo que pueden lograr o hacer?

En el punto de exponer IQueryable<T> y IEnumerable<T> y así evitar problemas posteriores tiene defensores y enemigos por todos lados. Personalmente estoy deacuerdo con exponer IQueryable<T> en el repositorio e inclusive exponer un método para facilitarte el query de los elementos (y no hacerlo “directamente” usando una consulta LINQ inline). Verás, el meollo de todo es evitar andar abriendo clases como si fueramos cirujanos.

Si exponemos métodos como “GetUserById(5)” y este a su vez expone IEnumerable<T> esta bien (para ese uso en *específico*) pero recordemos que por lo general un repositorio será expuesto para múltiples usos (o sea, no solamente para obtener usuarios con ese Id, ¿qué tal si luego quieres obtener la lista de usuarios? ¿y si quieres filtrarla?, ni hablemos del problema eterno del pagineo…

Bien, he aquí cuando se nota la utilidad de la separación de concerns de presentación con todo lo demás, por ejemplo, recordemos que el Controller es un _concern de presentación_ así mismo como es la vista (si, señores, como vengo dicíendolo por mucho tiempo, el controller *no es* la lógica del negocio, simplemente es la lógica del presentador).

Ok, llevemos esto más allá, es probable que tengamos “casos de uso” de lógica relacionada a la presentación, no a la del negocio, por ejemplo, el típico concern de búsqueda de elementos, las opciones de búsqueda, filtrado, son conerns meramente de la lógica relacionada a la presentación, eso involucra entonces que debemos permitir que nuestro controller (o presenter, dependiendo del patrón de presentación usado) directamente actúe contra la dao? muchos proponentes dicen que no debe ser así (y ellos mismos hasta se contradicen si los estudian detenidamente). Más de alguien me contestará que simplemente realizar la consulta mediante Specification es suficiente (pueden tomar como ejemplo el proyecto de mi amigo Romaniello ;) pero a mi criterio seguimos exponiendo IQueryable hacia la vista final, algo que a mi concepto no me agrada para nada.

Es ahí cuando entra en acción el concepto de Application Services (no confundir con Domain Services), un Application Service se encarga de verselas contra el mundo “externo” ajeno al dominio (entiendase, lo que el mundo externo consumirá del dominio) mientras que el Domain Service vela por la coordinación de operaciones dentro del dominio. Simple :) [Jimmy Bogard tiene un excelente artículo al respecto, se los recomiendo]

Digamos entonces que tenemos algo simple y sencillo, nuestra interface de búsqueda del servicio de búsqueda que utiliza nuestro controller

interface SearchService {
    IEnumerable<ItemResult> SearchItems(SearchParameters parameters);
}

Como veran se expone la mínima interface necesaria para ver los elementos finales de la búsqueda (en este caso una colección simplemente necesita IEnumerable<T>, de hecho, es probable que el elemento retornado no tenga nada que ver con la entidad consultada dentro del servicio usando un repositorio (de hecho podría ser que tengamos que consultar varias entidades y hacer varios cambios antes de retornar la entidad). ¿Qué pasa entonces con conceptos como pagineo y/o límites? como vemos IEnumerable<T> no expone conceptos como Count (y menos otros como TotalCount o Limit-Offset), porqué entonces no aprovechamos que ahora hablamos de un concepto totalmente diferente y que involucra solamente presentación, que tal si retornamos IPageable<T> ?

interface IPageable<T> : IEnumerable<T> {
    int TotalCount { get; }
    int Limit { get; }
    int Offset { get; }
    int Max { get; }
}

En resumidas cuentas, hacer que el repositorio sea flexible funciona, pero no debemos permitir permear conceptos de dominio y mezclarlos con conceptos de presentación, no vaya a ser que terminemos al final con un super repositorio con 50 métodos.

Como siempre comentarios al respecto, soy todo oídos (u ojos, whatever!) ¡Hasta luego!

No uses la base de datos como tu modelo

Bueno no se si realmente el título del post esta relacionado con el contenido, en realidad este post debería llamarse: “Mantenibilidad vs. el Point and Click Developer”. Una de las cosas con las que me enfrento día a día por mi apoyo a NHibernate es la típica pregunta: “Pero NHibernate no tiene un ‘arrastrar la tabla y soltar sobre el designer’ como DbLinq”

Esta pregunta realmente es algo compleja de responder, usualmente respondo algo como: “Si basas tu dominio en tu esquema de base de datos entonces simplemente quedas atado a tu esquema de datos”. Claro, siempre me regresan una increíble cantidad de respuestas y comentarios indicándome que “No hay tiempo” algo como “Modelar un dominio?”

En este caso en específico quiero hablar de “dominio” como las pocas o muchas reglas de negocio que hay o existen dentro de una aplicación. Mi fanatismo por NHibernate se basa no en que es “la última moda”, sino en la flexibilidad que tiene para no atarme a la base de datos, sino “adaptarme” a ella. Verán, esto lo explico de una manera bien sencilla: Con un arrastrar y soltar de la tabla de la base de datos a la aplicación y que me “autogenere” las entidades estoy atado al esquema de la base de datos, NO a las reglas de negocio existentes; con diseñar mis entidades de dominio (objetos que se aplicarían en las reglas de negocio) y luego atarlos a la base de datos, mis reglas de negocio, mis entidades de dominio, mi funcionalidad NO esta atado a cambios en el esquema, y no tendría porqué cambiar mi esquema de datos al cambiar reglas de datos. Ante esto alguien me respondió una vez: “Pero la mayoría de veces ya tienes la base de datos, no tienes ni siquiera permiso para modificarla”, pues respondo que en este caso el tener un buen ORM te facilita las cosas, ya que tus cambios en el negocio no se reflejan en tu contenedor de datos.

Algunos pueden abogar: “pero no hay tiempo para entregar una aplicación a tiempo si nos ponemos a ver ese tipo de cosas”, pues probablemente no si te la piden de hoy para mañana pero el tradeoff creo que vale la pena. Hace un tiempo vivía bajo el espejismo de “La entrega es lo importante, hay que hacerlo a toda costa y si hay que sacrificar que el codigo es un desorden vale la pena para la entrega”, pero después de varios años y proyectos he aprendido gran parte de la lección, lo importante al final es la mantenibilidad ya que no importa CUANTO hemos trabajado en una aplicación para su entrega, lo ÚNICO inminente es que al cliente se le ocurrirán cambios. Creo que todos hemos escuchado historias como: “Me dijeron que iba a ser temporal esta aplicación y ya lleva años modificándose” o quien no conoce el típico caso de la aplicación de Access que creció y ahora es un eterno martirio modificarla?

Mi último caso que pasé en carne propia sucedió ya hace varios meses: un cliente me pidió una app relativamente sencilla, pedía unos datos, usaba un par más, enviaba un par de correos e interactuaba con una simple app en Silverlight a través de un servicio WCF. Nada complicado en los requerimientos iniciales. Se firmó el contrato y decidí comenzar probando la ASP.NET MVC (en ese tiempo estaba en el CPT5 recuerdo). Aunque no era mi primera vez con una MVC Framework, era mi primera vez con una app Silverlight de ese tipo (sorry, no puedo dar mas detalles :P ), y como los controladores eran suficientemente sencillos y el tiempo de entrega eran simplemente 5 días, decidí saltarme todos mis principios y “trabajas” y hacerlo con DbLinq y una DB sencilla de datos (los datos de la DB eran sumamente simples, un esquema pequeño sin mucho problema). La aplicación se entregó en el tiempo requerido y todo funcionaba rebien…. ¿Que pasó al final? los requerimientos cambiaron, la aplicación no fue tan “temporal” como habian propuesto y las reglas de negocio comenzaron a cambiarse… Al final de todo, una pesadilla de mantenimiento durante los siguientes dos meses…. Morajela:NUNCA usar KISS como una excusa para no hacer bien las cosas.

Si tu aplicación es simple, sencilla y no requiere mucha “ciencia”, esta bien, usa DbLinq, la Entity Framework, NHibernate o lo que quieras usar para conectarte a la base de datos (esta bien, si quieres hasta puedes usar SqlCommands o los horribles DataSets), pero JAMAS dejes que tu base de datos dictamine como debe ser tu aplicación.

Espero sus comentarios al respecto, creo que sobre esto hay mucha tela que cortar.

Modelos, Bound Context y mejor que sobre a que falte

Trabajando en el modelado de una aplicación basado en casos de uso y modelo entregado por el cliente, uno suele notar algunas cosas, que sin querer y sin ser “experto” en el modelo de negocio puede darse cuenta que simplemente no estan bien.

Me topo con un “simple” sistema de registro, a simple vista parecería ser simple, pero tiene una sutileza, según lo explica el cliente

  • Existe una data “común” y “básica” para todos (cosas como nombre, edad, sexo, etc..)
  • Si el usuario es tipo “A” entonces debemos preguntar cierta data extra
  • Si el usuario es tipo “B” debemos preguntar entonces esta otra data
  • Si el usuario es tipo “C” entonces preguntamos esta otra cosa…. y así sucesivamente.

Cuando se modela esto uno piensa correctamente en cosas como herencia y polimorfismo, y si el lector pensó también en esto, esta totalmente en lo correcto. Lo que me llama la atención erea que en toda la data “extra” habían ciertas preguntas como:

  • Deporte, Lugar, Hobbie favoritos
  • Le gusta X, Y ó Z?

Como esto se repite en “TODOS” los casos, lo más obvio sería agregarlo en la clase base verdad? ERROR!

Luego de analizar un poco más el problema me topo con dos inconvenientes:

  1. Los objetos “base” o “abstractos” pasan a ser mega objetos inmensos, demasiadas propiedades, demasiadas dependencias. Los objetos concretos son sencillos con solo pocas características dentro de cada uno de ellos.
  2. La data “extra” solicitada no es usada en NINGUN lugar de la lógica de negocio. El cliente necesita tomarla para “futuras estadísticas”.

Lo interesante es que la data extra aunque no es usada y esta contemplada para “futuras estadísticas” esta debe ser OBLIGATORIAS al contestar y registrarse en la aplicación. Esto claramente me recuerda un pensamiento popular entre nosotros:

Mejor que sobre a que falte

¿Qué nos quedaba hacer? Simplemente no podemos obviar al cliente y decidir que “conocemos mejor que él” el negocio. No sería (for the sake of the model) crear una clase abstracta llena de muchísimas propiedades, no sería nada producente. Es cuando el recuerdo del libro de Erick Evans llega a mi mente e ilumina ese momento:Bounded Context.

Bounded Context son “mini aplicaciones” o “módulos” que funcionan independientemente, en donde sus entidades de negocio existen por si solas, donde posee sus propios servicios, entities, root aggregates y demás, PERO que interactua con otros “Bounded Contexts” de forma “normal” através de un “Context Map”.

En este caso en específico creo que la solución es simple y sencilla. No contaminar las entidades abstractas base (que en nuestro caso es un root aggregate, lo que lo hace más delicado) y trabajar la data “extra” como otra entidad perteneciente a un Bounded Context aledaño.

¿Qué opinan ustedes?