Mostrando entradas con la etiqueta Component Model. Mostrar todas las entradas
Mostrando entradas con la etiqueta Component Model. Mostrar todas las entradas

sábado, 29 de octubre de 2016

Arquitectura de N-Capas con Visual Studio .NET y AngularJS

Este artículo es el primero de una serie de artículos en que quiero explicar mi visión de la programación por capas.

La Arquitectura de N-capas es probablemente uno de los modelos más utilizados en programación. Se utiliza tan a menudo porque es escalable, extensible, segura, fácil de mantener en el tiempo, reutilizable y se puede trabajar por diferentes programadores según su especialidad sin interferirse el trabajo.

En este artículo voy a presentar una arquitectura básica de n-capas que se puede utilizar para la creación de pequeñas hasta grandes aplicaciones.

Para el desarrollo de una arquitectura en capas robusta y perdurable en el tiempo, se deben tener en cuenta los siguientes aspectos:
·         Las capas de una aplicación deben ser independientes entre sí, como las fichas de un lego. De esta manera podemos reemplazar cualquiera de las capas por una más actualizada en cualquier momento.
·         Se debe mantener el principio de responsabilidad modular, esto quiere decir que cada capa es responsable de un tema o característica.
·         Principio de caja negra. Cada componente es independiente de otros y solo interactúa en sus entradas y salidas.
·         Don't Repeat Yourself (DRY). Principio de No repitas. Cada funcionalidad debe estar una sola vez en el sistema (Sin duplicados).
·         Establecer normas en la codificación del desarrollo. Esto asegura la consistencia de código y el mantenimiento del mismo.

Ventajas

Ilustración 1
Siendo la programación en capas una arquitectura que tiene como objetivo principal separar la capa de diseño de la de lógica, existen otros valores adicionales que aportan a proyectos grandes entre otros como:

·         Facilita la creación de código estructurado
·         Facilita el trabajo en equipo, permitiendo que varios programadores trabajen paralelamente en una misma funcionalidad sin interferirse mutuamente.
·         Permite separar algunas de las capas de código en diferentes servidores para balanceo de cargas, buses de datos empresariales, etc.



En la ilustración 1 podrás apreciar el un modelo básico de capas.



Proyecto ejemplo y descripción de capas

Se elaboró un ejemplo en Visual Studio 2013 con base de datos SQL Server 2014 para la descripción de la arquitectura, a continuación, encontrarás una breve descripción de la funcionalidad que tiene cada capa, los aplicativos relacionados y las herramientas utilizadas en el ejemplo relacionados con cada capa.:


Base de Datos: es la encargada de la persistencia de los datos, la integridad de la información y el acceso a los mismos, está formada por uno o más sistemas de gestión de base de datos “SGBD” como son: Oracle, SQL server, mySQL, PostgreSQL, MongoDB, etc.  

Para el ejemplo estamos usando el motor de base de datos SQL Server Express 2014. La base de datos consiste en dos tablas, una que se llama tipo de identificación y otra Persona relacionadas entre sí como se muestra en la ilustración 1.

Importante: Al final del artículo encontraras el Script para crear la base de datos, el script incluye 200 datos creados aleatoriamente mediante estadística de los nombres y apellidos más comunes. En el script tienes que cambiar el nombre dela base de datos donde vas a colocar las tablas.

Acceso a datos: La capa de acceso de datos contiene la funcionalidad para la Creación, Consulta, Actualización y Eliminación o “CRUD” por sus siglas en inglés (Create, Read, Update and Delete) de datos en la base de datos. Hoy en día en esta capa se utilizan objetos de mapeo relacional “ORM” como son NHibernate o Entity Framework “EF”.

Para el ejemplo usamos Entity Frameworky y Linq para gestionar el CRUD de las tablas mediante clases en C#. Como punto importante cuando se instancia el modelo de datos, se realiza en una clase padre que es heredada por las clases que gestionan el CRUD, lo anterior para poder hacer configuraciones al EF que afecten a todas las clases.

Importante: Si se quiere actualizar el modelo desde la base de datos se debe cambiar la cadena de conexión "EntidadesDatos" del Entity Framework en el archivo App.config.

Lógica de negocios:  La Business Logic Layer contiene la funcionalidad principal de la aplicación. El objetivo es llevar a cabo toda la lógica personalizada que se aplica sobre los datos en métodos que se exponen desde la capa de acceso de datos.

Por ejemplo: Encriptación, Des encriptación de datos, validación de atributos, otro ejemplo: Si estoy registrando una persona y esta es menor de edad, el documento de identificación no puede ser el de un adulto.

Servicios: La capa de servicios permite exponer la capa de lógica de negocios como una API para sistemas propios o de terceros. Aunque esta capa no es obligatoria, en algunos sistemas se expone la capa de lógica de negocios directamente a la de presentación. La capa de servicios se debe implementar cuando se prevé que la lógica de la aplicación se expondrá a más de un aplicativo o capa de presentación.

Presentación: La capa de presentación es responsable de organizar la interfaz de usuario de la aplicación, es el Front End de nuestro aplicativo. En nuestro ejemplo la capa de presentación está elaborada en MVC con Bootstrap, jquery  y AngularJS.

En esta capa se puede utilizar tecnologías como ASP.NET Web Forms o ASP.NET MVC, Xamarin, etc.

Para el ejemplo la capa de presentación que usamos está elaborada como un proyecto web mvc con Bootstrap, AngularJS. Lo anterior nos permite que el ejemplo sea web responsive.
El ejemplo consiste en un Grid elaborado con Angular que permite el filtrado y ordenamiento de registros y las demás pantallas del CRUD con Visual Studio y Bootstrap.

Importante: Para que el proyecto pueda conectarse a la base de datos, no olviden cambiar la cadena de conexión "EntidadesDatos" del Entity Framework en el archivo web.config.

Entidades: La capa de entidades contiene todas las entidades que se utilizan en los demás proyectos de la aplicación, tales como las que representan las tablas de la base de datos, los Objetos de transferencia de datos o DTO (Data Transfer Objects) y los atributos a los datos de las clases.
Para el ejemplo, en esta capa agregamos clases parciales donde agregamos validaciones y anotaciones a los atributos de una clase mediante “DataAnnotations”.

Componente: La capa de Componentes, contiene todas las bibliotecas o funcionalidades comunes que se pueden utilizar en cualquiera de las capas anteriores. Por ejemplo: la funcionalidad de la validación, manejo de textos, herramientas de cifrado o clases de registro de excepción se puede añadir a esta capa.

Los archivos del Ejemplo
Descargar script para la creación de la base de datos aquí.
Decargar el código fuente del aplicativo aquí.

Pasos para utilizar el ejemplo:
1. Bajar los archivos
2. Crear una base de datos en SQL server
3. Ajustar la cadena de conexión del Entity Framework en el web.config y App.config
4. Ejecutar el aplicativo.




Para finalizar les recuerdo:

Cada quien tiene su manera de matar pulgas, así que puede haber una gran cantidad de maneras de hacer el mismo trabajo.

Estos artículos son ejemplos, así que, si tienes una mejor manera de hacerlo o puedes colaborarme con alguna observación, tu comentario es bienvenido.
·         No asumo ninguna responsabilidad por el uso de lo expuesto.
·         Si los artículos son de utilidad, no olvides un “Me Gusta” o dejar algún comentario.
·         Para mantener el blog se usa publicidad de google adsense

·         El Blog utiliza cookies para registrar hábitos de navegación.

viernes, 25 de marzo de 2016

Arquitectura de N Capas: Parte 3 – La Capa de Entidades

Arquitectura de N Capas: Parte 3 – La Capa de Entidades
Ahora que tenemos el proyecto armado y la capa acceso a datos y la de entidades, vamos a separar las entidades que se encuentran dentro del modelo de datos den Entity Framework y colocarlos en un proyecto aparte.
Cuando en la capa de datos creamos el modelo de datos, éste se creó de la siguiente manera:
  • ModelGestion.edmx
  • ModelGestion.Context.cs
  • ModelGestion.Designer.cs
  • ModelGestion.edmx.diagram
  • ModelGestion.tt

Para separar las entidades, trasladamos el archivo ModelGestion.tt de la capa de datos a la capa de entidades, para esto seguimos los siguientes pasos:

  1. Cerrar las ventanas dentro del Visual Studio.
  2. Abrir el explorador de Windows.
  3. Ir a la carpeta de Datos.
  4. Mover el archivo ModelGestion.tt a la carpeta Entidades.
  5. Volver a Visual Studio a la capa de entidades.
  6. Utilizar la opción Show All Files en la capa de presentación para ver el archivo de ModelGestion.tt en la ventana Solution Explorer.
  7. Integrarlo al proyecto mediante la opción de clic derecho Include in Projet .
  8. Abrir el archivo ModelGestion.tt.
  9. Redireccionar, donde está el modelo de datos, de la siguiente manera: conststringinputFile = @"../Datos/ModelGestion.edmx". Lo anterior se hace porque no podemos crearlo mediante: adicionar referencias al proyecto.
  10. Volver a la capa de acceso a datos y eliminar el link roto del archivo ModelGestion.tt .
  11. En el nombre del proyecto de Datos usar clic derecho para incluir la referencia al proyecto Entidades.
  12. Ir a las propiedades del archivo ModelGestion.Context.cs.
  13. En la opción CustomToolNamespace escribir el nombre de la capa de Entidades.
  14. Incluir en la clase de acceso a datos el llamado a Entidades:  using Entidades.
  15. Recompilar la solución.



Las imágenes de los pasos las podrás ver en la Ilustración 1:

Ilustración 1


Ahora que tenemos la capa de entidades agreguemos en ella los metadatos a la entidad Procesos, siguiendo los siguientes pasos:
  1. Agregar al proyecto la referencia a System.ComponentModel.DataAnnotations.
  2. Crear una clase ProcesosMD.cs.
  3. Incluir en la clase:usingSystem.ComponentModel.DataAnnotations.
  4. Volver pública la clase publicclassProcesosMD .
  5. Copiar los atributos de la clase ModelGestion  / Procesos dentro de ProcesosMD .
  6. Adicionar los metadatos.
  7. Al finalizar con la clase ProcesosMD, extendemos las propiedades de la clase

La clase con los metadatos termina así:

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.ComponentModel.DataAnnotations;

namespace Entidades
{
    public class ProcesosMD
    {
        [Display(Name = "Id")]
        public int IdProceso { get; set; }

        [Display(Name = "Nombre Proceso")]
        [Required(ErrorMessage = "Campo requerido")]
        public string NombreProceso { get; set; }

        [Display(Name = "Versión")]
        [Required(ErrorMessage = "Campo requerido")]
        public string Version { get; set; }

        [Display(Name = "Fecha de Creación")]
        [Required(ErrorMessage = "Campo requerido")]
        [DisplayFormat(DataFormatString = "{0:dd/MM/yyyy}")] //Formato de la fecha
        public System.DateTime FechaCreacion { get; set; }
    }

    [MetadataType(typeof(ProcesosMD))]
    public partial class Procesos
    {
    }
}

Algunos de los metadatos que me han sido útiles los puedes encontrar a continuación:
[DisplayName("Nombre del atributo")]
[Required(ErrorMessage = "Campo requerido")]
[MaxLength(50, ErrorMessage = "Máximo 50 caracteres")]
[StringLength(50, ErrorMessage = "Máximo 50 caracteres")]
[RegularExpression(@"[a-zA-ZñÑ\s]{2,50}", ErrorMessage = "Solo letras")]
[RegularExpression("^[0-9]*$", ErrorMessage = "Solo números")]
[Range(0, 999, ErrorMessage = "Máximo tres números")]
[Range(1000000000, 9999999999, ErrorMessage = "10 números")]
[DataType(DataType.Date)] //Fecha
[DisplayFormat(DataFormatString = "{0:dd/MM/yyyy}")] //Formato de la fecha
[DataType(DataType.Url)]
[DataType(DataType.EmailAddress)]


Aquí finalizamos el ejemplo de la capa de Entidades, la cual nos facilita el transporte de los datos entre las demás capas del modelo; recuerden agregar los metadatos a todas las entidades que lo necesite. Así mismo, es mejor hacerlo en archivos separados que agregarlos a la entidad, por la sencilla razón que si hay que cambiar el modelo de datos agregando una propiedad adicional que casi nunca ocurre (Broma), no perderíamos el trabajo elaborado.
Para finalizar les recuerdo:
  • Cada quien tiene su manera de matar pulgas, así que puede haber una gran cantidad de maneras de hacer el mismo trabajo.
  • Estos artículos son ejemplos, así que, si tienes una mejor manera de hacerlo o puedes colaborarme con alguna observación, tu comentario es bienvenido.
  • No asumo ninguna responsabilidad por el uso de lo expuesto.
  • Si los artículos te son de utilidad, no olvides un “Me Gusta” o dejar algún comentario.

Entrada destacada

Arquitectura de N-Capas con Visual Studio .NET y AngularJS

Este artículo es el primero de una serie de artículos en que quiero explicar mi visión de la programación por capas. La Arquitectura ...