{"id":12,"date":"2021-06-03T15:05:56","date_gmt":"2021-06-03T15:05:56","guid":{"rendered":"https:\/\/lafilosofiadelsoftware.wordpress.com\/?p=12"},"modified":"2021-08-23T22:17:39","modified_gmt":"2021-08-24T03:17:39","slug":"clean-architecture-parte-2","status":"publish","type":"post","link":"https:\/\/lafilosofiadelsoftware.com\/index.php\/2021\/06\/03\/clean-architecture-parte-2\/","title":{"rendered":"Clean Architecture en Arquitectura N-capas parte 2"},"content":{"rendered":"\n<p>Continuando con nuestro prop\u00f3sito de aplicar conceptos de&nbsp;<a href=\"https:\/\/lafilosofiadelsoftware.wordpress.com\/2021\/06\/03\/clean-architecture-en-arquitectura-n-capas-parte-1\/\">clean architecture en una arquitectura de N-capas<\/a>&nbsp;trataremos inicialmente los siguientes temas:<\/p>\n\n\n\n<ul class=\"wp-block-list\"><li>\u00bfEs la base de datos nuestro modelo de negocio?<\/li><li>Interfaces como mecanismo de verdadera abstracci\u00f3n.<\/li><li>\u00bfC\u00f3mo sobrevivir a las \u201cCualquierCosaService\u201d?<\/li><li>\u00bfDebemos usar Excepciones?<\/li><li>Evitando los side-effects<\/li><\/ul>\n\n\n\n<p id=\"c122\">Nota: Para la aplicaci\u00f3n pr\u00e1ctica de la teor\u00eda usare como lenguaje de programaci\u00f3n Kotlin con Spring Framework, sin embargo, puede ser aplicado a cualquier otro lenguaje orientado a objetos (o no) f\u00e1cilmente .<\/p>\n\n\n\n<h1 class=\"wp-block-heading\" id=\"e001\">\u00bfEs la base de datos nuestro modelo de negocio?<\/h1>\n\n\n\n<p id=\"6061\">La respuesta siempre ser\u00e1 NO, la base de datos&nbsp;no debe ser m\u00e1s que un ente externo a nuestro dominio (l\u00f3gica de negocio) haciendo que este dependa de sus propios modelos y no tenga nada que ver con una especificaci\u00f3n de base de datos (SQL o noSQL)<\/p>\n\n\n\n<p id=\"5d25\">Existe una mala costumbre generalizada de hacer girar toda nuestra aplicaci\u00f3n entorno a la base de datos, objetos&nbsp;<a href=\"https:\/\/en.wikipedia.org\/wiki\/Object%E2%80%93relational_mapping\">orm<\/a>&nbsp;por doquier contaminando nuestra l\u00f3gica de negocio con especificaciones de base de datos y asumiendo a toda luces que la entidad principal es el objeto de base de datos.<\/p>\n\n\n\n<p id=\"2369\">Debemos poder llegar a reemplazar la especificaci\u00f3n de la DB (o dejar de usarla) de manera tan f\u00e1cil como cambiar un par de archivos y ajustar unos cuantos mapper. Para lograr lo anterior nuestras bases de datos (SQL o noSQL) debemos verlas como temas de infraestructura externa y nuestra l\u00f3gica de negocio no debe de conocer.<\/p>\n\n\n\n<p id=\"b949\">\u00bfC\u00f3mo logramos esto? definiendo correctamente unas interfaces y un par de mapper que conviertan de objetos de base de datos a nuestros objetos de dominio (Si su aplicaci\u00f3n es bastante compleja posiblemente no llegar\u00e1 a los objetos de dominio directamente, veremos esto en los siguientes post).<br>Mucha charla, poco c\u00f3digo, vamos a la acci\u00f3n:<\/p>\n\n\n\n<div class=\"wp-block-image\"><figure class=\"aligncenter\"><img decoding=\"async\" src=\"http:\/\/lafilosofiadelsoftware.files.wordpress.com\/2021\/06\/c7eca-00gmizgtmutmk4x3z.png\" alt=\"\"\/><\/figure><\/div>\n\n\n\n<p id=\"6549\">Demos un vistazo m\u00e1s a detalle de estos 3 archivos:<\/p>\n\n\n\n<div class=\"wp-block-image\"><figure class=\"aligncenter\"><img decoding=\"async\" src=\"http:\/\/lafilosofiadelsoftware.files.wordpress.com\/2021\/06\/40426-0dhlzdw2pgnjnowpb.png\" alt=\"\"\/><\/figure><\/div>\n\n\n\n<p id=\"4247\">Tenemos una clase&nbsp;<em>BookOrm<\/em>&nbsp;(conocidas como Entity) que no es m\u00e1s que un&nbsp;<a href=\"https:\/\/en.wikipedia.org\/wiki\/Object%E2%80%93relational_mapping\">orm<\/a>&nbsp;que contiene adicional una funci\u00f3n para convertir a nuestras clases de dominio ( nuestra infraestructura puede conocer de nuestro modelo, pero no al contrario), una interface&nbsp;<em>BookRepository<\/em>&nbsp;para hacer uso de la potencia de&nbsp;<a href=\"https:\/\/spring.io\/projects\/spring-data-jpa\">SpringJPA<\/a>&nbsp;y nuestra clase&nbsp;<em>BookSqlRepositoryImpl<\/em>&nbsp;que gracias a la inversi\u00f3n de control pueda usar la interface&nbsp;<em>BookRepository<\/em>&nbsp;para hacer consultas predeterminadas por Spring a la DB.<\/p>\n\n\n\n<p id=\"787a\">Pero, \u00bfen qu\u00e9 se diferencia esto a como ya hemos visto en docena de proyectos?, detallemos la implementaci\u00f3n de la interfaz que hace&nbsp;<em>BookSqlRepositoryImpl&nbsp;<\/em>de&nbsp;<em>SearchBookExternalPort, es&nbsp;<\/em>ac\u00e1 es donde comienza la magia, esta interfaz (<em>SearchBookExternalPort)<\/em>&nbsp;fue definida por nuestra l\u00f3gica de negocio la cual defini\u00f3 un contrato (puerto) que debe ser implementado por un adaptador, que en este caso es&nbsp;<em>BookSqlRepositoryImpl<\/em>, pero f\u00e1cilmente podr\u00eda ser un&nbsp;<em>BookRestRepositoryImpl<\/em>.<\/p>\n\n\n\n<p id=\"e746\">Aclaremos un poco que es un puerto y un adaptador:<\/p>\n\n\n\n<ul class=\"wp-block-list\"><li><strong>Puerto<\/strong>: especifica un contrato a ser cumplido sin detallar el c\u00f3mo.<\/li><li><strong>Adaptador<\/strong>: Nos da la implementaci\u00f3n de cierto puerto (el c\u00f3mo)<\/li><\/ul>\n\n\n\n<p id=\"84a2\">Si son detallistas al visualizar la imagen podr\u00e1n observar que nuestra clase&nbsp;<em>BookSqlRepositoryImpl&nbsp;<\/em>no retorna nuestros objetos de&nbsp;<a href=\"https:\/\/en.wikipedia.org\/wiki\/Object%E2%80%93relational_mapping\">orm<\/a>&nbsp;(<em>BookOrm)<\/em>&nbsp;al exterior, en su lugar realiza una conversi\u00f3n (mapper) hacia un objeto de dominio (Book, ubicado en la carpeta&nbsp;<strong>service<\/strong>), de esta forma la l\u00f3gica de negocio localizada en la carpeta&nbsp;<strong>Service<\/strong>&nbsp;no tendr\u00e1 nada que ver con temas externos al no recibir un objeto&nbsp;<a href=\"https:\/\/en.wikipedia.org\/wiki\/Object%E2%80%93relational_mapping\">orm<\/a>.<\/p>\n\n\n\n<div class=\"wp-block-image\"><figure class=\"aligncenter\"><img decoding=\"async\" src=\"http:\/\/lafilosofiadelsoftware.files.wordpress.com\/2021\/06\/90484-1qdwqgupabzanaccsduwdrg.png\" alt=\"\"\/><\/figure><\/div>\n\n\n\n<p id=\"1e62\">Con lo anterior cumplimos el&nbsp;<a href=\"https:\/\/en.wikipedia.org\/wiki\/Dependency_inversion_principle\">DIP<\/a>&nbsp;en el momento que nuestra l\u00f3gica de negocio depende de una abstracci\u00f3n (puerto) para obtener los datos y no d\u00e9 una implementaci\u00f3n.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"ecc8\">Para guardar un libro \u00bfla l\u00f3gica de negocio debe conocer nuestro ORM ?<\/h2>\n\n\n\n<p id=\"8328\">Nuevamente NO. Nuestra l\u00f3gica de negocio solo conoce a sus modelos, veamos un alcance de c\u00f3mo deber\u00edamos realizar el guardado<\/p>\n\n\n\n<div class=\"wp-block-image\"><figure class=\"aligncenter\"><img decoding=\"async\" src=\"http:\/\/lafilosofiadelsoftware.files.wordpress.com\/2021\/06\/e3a65-0amnjzquf1qrzv-87.png\" alt=\"\"\/><\/figure><\/div>\n\n\n\n<div class=\"wp-block-image\"><figure class=\"aligncenter\"><img decoding=\"async\" src=\"http:\/\/lafilosofiadelsoftware.files.wordpress.com\/2021\/06\/4db2b-0cvx01ofp3g80kych.png\" alt=\"\"\/><figcaption>Modelo usado por la capa de l\u00f3gica de negocio<\/figcaption><\/figure><\/div>\n\n\n\n<div class=\"wp-block-image\"><figure class=\"aligncenter\"><img decoding=\"async\" src=\"http:\/\/lafilosofiadelsoftware.files.wordpress.com\/2021\/06\/726b3-06ibdegs-cgerol_-.png\" alt=\"\"\/><figcaption>Interfaz para acceder a nuestra l\u00f3gica de negocio desde un delegate o facade:<\/figcaption><\/figure><\/div>\n\n\n\n<div class=\"wp-block-image\"><figure class=\"aligncenter\"><img decoding=\"async\" src=\"http:\/\/lafilosofiadelsoftware.files.wordpress.com\/2021\/06\/ff623-0xxrwa78gchsitqs7.png\" alt=\"\"\/><figcaption>Nuestra l\u00f3gica de negocio recibe una interfaz (puerto) para realizar el registro de los Books.<\/figcaption><\/figure><\/div>\n\n\n\n<div class=\"wp-block-image\"><figure class=\"aligncenter\"><img decoding=\"async\" src=\"http:\/\/lafilosofiadelsoftware.files.wordpress.com\/2021\/06\/aea2e-0cttwko47fsa4jpu3.png\" alt=\"\"\/><figcaption>Puerto usado por la l\u00f3gica de negocio<\/figcaption><\/figure><\/div>\n\n\n\n<div class=\"wp-block-image\"><figure class=\"aligncenter\"><img decoding=\"async\" src=\"http:\/\/lafilosofiadelsoftware.files.wordpress.com\/2021\/06\/d9416-0sccrwpsn_ah-psbs.png\" alt=\"\"\/><figcaption>Nuestra anterior clase de BookSqlRepositoryImpl nos sirve de adaptador nuevamente, dicho registro de libro podr\u00eda hacerse en un servicio web externo o un noSQL (veremos esto en siguientes post) y nuestro ORM, convierte de modelo a su idioma (<a href=\"https:\/\/en.wikipedia.org\/wiki\/Object%E2%80%93relational_mapping\">orm<\/a>)<\/figcaption><\/figure><\/div>\n\n\n\n<p id=\"d70a\">Con lo anterior vimos el primer tema sobre base de datos en c\u00f3mo interact\u00faa con nuestra l\u00f3gica de negocio y un abre bocas sobre \u00e9l trabajar con abstracciones, en las siguientes publicaciones veremos los siguientes temas.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Continuando con nuestro prop\u00f3sito de aplicar conceptos de&nbsp;clean architecture en una arquitectura de N-capas&nbsp;trataremos inicialmente los siguientes temas: \u00bfEs la base de datos nuestro modelo de negocio? Interfaces como mecanismo de verdadera abstracci\u00f3n. \u00bfC\u00f3mo sobrevivir a las \u201cCualquierCosaService\u201d? \u00bfDebemos usar Excepciones? Evitando los side-effects Nota: Para la aplicaci\u00f3n pr\u00e1ctica de la teor\u00eda usare como lenguaje &#8230; <a title=\"Clean Architecture en Arquitectura N-capas parte 2\" class=\"read-more\" href=\"https:\/\/lafilosofiadelsoftware.com\/index.php\/2021\/06\/03\/clean-architecture-parte-2\/\" aria-label=\"Leer m\u00e1s sobre Clean Architecture en Arquitectura N-capas parte 2\">Leer m\u00e1s<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"om_disable_all_campaigns":false,"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"categories":[2],"tags":[7,8,11,12,19],"class_list":["post-12","post","type-post","status-publish","format-standard","hentry","category-clean-architecture","tag-clean-architecture","tag-clean-code","tag-ingeniera-de-software","tag-n-capas","tag-software-engineer"],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/lafilosofiadelsoftware.com\/index.php\/wp-json\/wp\/v2\/posts\/12"}],"collection":[{"href":"https:\/\/lafilosofiadelsoftware.com\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/lafilosofiadelsoftware.com\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/lafilosofiadelsoftware.com\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/lafilosofiadelsoftware.com\/index.php\/wp-json\/wp\/v2\/comments?post=12"}],"version-history":[{"count":1,"href":"https:\/\/lafilosofiadelsoftware.com\/index.php\/wp-json\/wp\/v2\/posts\/12\/revisions"}],"predecessor-version":[{"id":140,"href":"https:\/\/lafilosofiadelsoftware.com\/index.php\/wp-json\/wp\/v2\/posts\/12\/revisions\/140"}],"wp:attachment":[{"href":"https:\/\/lafilosofiadelsoftware.com\/index.php\/wp-json\/wp\/v2\/media?parent=12"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lafilosofiadelsoftware.com\/index.php\/wp-json\/wp\/v2\/categories?post=12"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lafilosofiadelsoftware.com\/index.php\/wp-json\/wp\/v2\/tags?post=12"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}