Servicios REST con .NET Core
  • Servicios REST con ASP.NET Core y Entity Framework Core
  • 1. Introducción
    • 1.1 Instalación Visual Studio Community
    • 1.2 Instalación de SQL Server en Mac
    • 1.3 Extensión Intellicode
    • 1.4 Aplicación de ejemplo
  • 2. Explicación de Conceptos
    • 2.1 Servicios REST
      • 2.1.1 OData
      • 2.1.2 GraphQL
    • 2.2 Entity Framework para versiones de tu base de datos
    • 2.3 Paquetes Nuget
    • 2.4 Archivo de recursos
    • 2.5 Estructura de los Proyectos .Net Core
    • 2.6 Código Limpio
    • 2.7 Programación asíncrona
    • 2.8 Git
    • 2.9 ¿Qué es Scrum?
      • 2.9.1 Personas
      • 2.9.2 Roles Scrum
      • 2.9.3 Backlog
      • 2.9.4 Reuniones del Scrum
  • 3. Control de código fuente y Scrum con Azure DevOps
    • 3.1 Introducción a Azure DevOps
      • 3.1.1 Crear un nuevo Proyecto en Azure DevOps
      • 3.1.2 Agregando personas al equipo de trabajo
      • 3.1.3 Agregando los sprints y la capacidad de trabajo
      • 3.1.4 Crear el Backlog y asignar User Stories al Sprint
      • 3.1.5 Crear Prototipos
      • 3.1.6 Conectar a Azure DevOps desde Visual Studio
        • 3.1.6.1 Crear tu proyecto con Visual Studio Community y sincronizarlo a Azure DevOps
      • 3.1.7 Consultar tus tareas pendientes
        • 3.1.7.1 Tareas y Dashboards con Azure DevOps
        • 3.1.7.2 Consultar tus tareas desde Visual Studio Community
      • 3.1.8 Trabajando con Ramas (Branches)
        • 3.1.8.1 Crear la rama desarrollo desde Azure DevOps
          • 3.1.8.1 Crear una rama(branch) desde tu tarea en Azure DevOps
        • 3.1.8.2 Como trabajar con ramas (branches) desde Visual Studio Community
        • 3.1.8.3 Crear el Pull Request con Azure DevOps
      • 3.1.9 Retrospectiva del Sprint
      • 3.1.10 Agregando una Wiki
    • 3.2 Integrando tu código fuente a GitHub
      • 3.2.1 Trabajando con ramas en GitHub
      • 3.2.2 Sincronizar los cambios del código con GitHub y Visual Studio
      • 3.3 Trabajando con Branches (Ramas) con Visual Studio
        • 3.3.1 Branches con Visual Studio
        • 3.3.2 Creando un template para tus PR (Pull Request)
        • 3.3.3 Protegiendo tu branch
  • 4. Creando tu primer servicio
    • 4.1 Crear las base de datos y los usuarios en MySQL
    • 4.2 Crear la tabla Categoría y sus validaciones
    • 4.3 Creando el servicio Categorias
    • 4.4 Probando tus servicios con POSTMAN
    • 4.5 Documentar y Probar tus servicios con Swagger
      • 4.5.1 Configurar Swagger
      • 4.5.2 Comentarios XML
      • 4.5.3 Generando la página de documentación
    • 4.6 Agregando índices
    • 4.7 Mejorando tu código
      • 4.7.1 Creando Objetos de Accesos a Datos
      • 4.7.2 Creando tus mensajes de error en diferentes idiomas
      • 4.7.3 Cambiando el formato del Json de los servicios
  • 5. Agregando el servicio para los productos
    • 5.1 Crear la tabla de Productos
    • 5.2 Formas de cargar información de tablas relacionadas
    • 5.3 Crear llaves fóraneas e índices
    • 5.4 Creando el servicio Productos
    • 5.5 Validar Reglas Mejorando tu código
      • 5.5.1 Agregando una excepción a todos nuestros servicios
      • 5.5.2 Agregando clases genéricas para validar y/o consultar información
      • 5.5.3 Alternativa para validar reglas con ef core
  • 6. Cambiar de base de datos a SQL Server
    • 6.1 Cambiar la base de datos a SQL Server
    • 6.2 Cambiar a SQL Server en Azure
  • 7. Crear servicios con OData
    • 7.1.1 Creando el modelo Clientes
    • 7.1.2 Creando el modelo ClienteCategoría
    • 7.1.3 Agregando paquete Nuget para OData
    • 7.1.4 Configurar el EDM Model
    • 7.1.5 Configurar el servicio OData y llaves foráneas
    • 7.1.6 Creando el Controller para clientes
    • 7.1.7 Configurar y probar los servicios con OData
    • 7.1.8 Práctica Crear el servicio para ClientesCategorias
    • 7.1.9 Recomendaciones de seguridad y rendimiento a tomar en cuenta con OData
  • 8. GraphQL
    • 8.1.1 Creando la tabla Caducidad
    • 8.1.2 Creando el query
    • 8.1.3 Configurando y probando graphQL
    • 8.1.4 Creando la Mutation
    • 8.1.5 Probando nuestros servicios con Postman
  • 9. Seguridad
    • 9.1 Json Web Tokens
    • 9.2 Seguridad basada en roles y usuarios
      • 9.2.1 Creando nuestra tabla roles e insertando los roles principales
      • 9.2.2 Consideraciones de seguridad para almacenar tus passwords
      • 9.2.3 Creando las tablas para manejar la seguridad
      • 9.2.4 Agregando usuarios y roles
    • 9.3 Agregando seguridad a nuestros servicios
    • 9.4 Creando nuestro servicio de login y generar el token
    • 9.5 ¿Cómo agregar seguridad basada en roles a los Servicios REST?
      • 9.5.1 Seguridad basada en claims
      • 9.5.2 Creando las tablas para validar permisos por cada tabla
      • 9.5.3 Seguridad basada en directivas
      • 9.5.4 Seguridad con Action Filters
    • 9.6 Guardando el historial de cambios
    • 9.7 Refrescando tu token
    • 9.8 Seguridad Mejorando tu código
      • 9.8.1 ¿Cómo limitar el número de intentos incorrectos en el login?
      • 9.8.2 ¿Cómo obtener la ciudad del usuario por medio de la IP?
      • 9.8.3 Habilitando CORS
  • 10. Pruebas Unitarias
    • 10.1 Agregando el proyecto de pruebas unitarias
    • 10.2 Crear una prueba unitaria
      • 10.2.1 Ejecutando las pruebas unitarias
    • 10.3 Agregando una base de datos en memoria para nuestras pruebas unitarias
    • 10.4 Agregando la referencia de nuestro proyecto CaducaRest
      • 10.4.1 Agregando paquetes nuget necesarios
    • 10.5 Configurando Clases para Objetos Sustitutos
      • 10.5.1 Configurando el Contexto para utilizar la base de datos en Memoria
      • 10.5.2 Configurando el objeto para sustituir mensajes de Error por idioma
    • 10.6 Agregando pruebas para las Categorías
  • 11. Integración continua
    • 11.1 ¿Qué es la integración continua?
    • 11.2 Subir tu código fuente a BitBucket
      • 11.2.1 Integración continua y pruebas automáticas con Bitbucket
    • 11.3 Integración continua y pruebas automáticas en Azure DevOps
  • 12. Pruebas de integración
    • 12.1 ¿Qué es SpecFlow?
    • 12.2 Agregando el proyecto de pruebas de integración
    • 12.3 Configurando Specflow
    • 12.4 Creando pruebas para el login
    • 12.5 Agregando las pruebas de Integración a Azure Devops
    • 12.6 Specflow Mejorando tu código
      • 12.6.1 Cambiando las pruebas a español
      • 12.6.2 Pasando tablas a nuestras pruebas
      • 12.6.3 Agregar los passwords como variables de ambiente
      • 12.6.4 Probando con SQLite
      • 12.6.5 Agregando diferentes parámetros con MSTest
      • 12.6.6 Generando el reporte living doc de specflow
  • 13. Integración continua con Postman
    • 13.1 Recomendaciones para probar tus servicios
    • 13.2 Instrucciones básicas para probar con Postman
    • 13.3 Crear colecciones en Postman
    • 13.4 Agregar pruebas a tus servicios
    • 13.5 Crear environments
    • 13.6 Agregando datos de prueba con archivos .csv
    • 13.7 Exportando tus colecciones y ejecutarlas con Newman.
    • 13.8 Agregando las colecciones de postman al pipeline
  • 14. Pruebas de usuario
    • 14.1 Page Object Model
    • 14.2 ¿Qué es Selenium?
      • 14.2.1 Selenium Instrucciones básicas
      • 14.2.2 Agregando el proyecto de pruebas de usuario
    • 14.3 ¿Qué es Cypress?
      • 14.3.1 Cypress Instrucciones básicas
    • 14.4 ¿Qué es Playwright?
      • 14.4.1 Playwright Instrucciones básicas
  • 15. Despliegue Continuo con Azure DevOps y Azure
    • 15.1 Crear un App Service en Azure
    • 15.2 Generando Artifacts en Azure Pipelines
    • 15.3 Generando el Release en Azure Pipelines al App Service de Azure
    • 15.4 Ejecutando las colecciones de Postman después del release
    • 15.5 Agregando las pruebas de usuario en Azure Pipelines
  • 16. Instalación en Windows Server e IIS
    • 16.1 Instalar IIS en Windows Server
    • 16.2 Instalación del ASP.NET Core Module/Hosting Bundle
    • 16.3 Crea el Sitio Web en IIS
  • 17. Instalación en Linux
    • 17.1 Creando una máquina virtual linux en Azure
    • 17.2 Habilitando el acceso remoto
    • 17.3 Configura linux para .Net Core
    • 17.4 Instalando mysql
    • 17.5 Instalando Nginx y configurando tu servicio
    • 17.6 Instalando un certificado SSL gratuito con CertBot
    • 17.7 Agregando diferentes subdominios
  • 18. Docker
Powered by GitBook
On this page
  • Eager loading (carga diligente)
  • Explicit loading (carga explícita)
  • Lazy loading (carga diferida)
  • Joins
  • Agrupar productos por categoría

Was this helpful?

  1. 5. Agregando el servicio para los productos

5.2 Formas de cargar información de tablas relacionadas

Entity framework core cuenta con 3 formas para cargar la información de las tablas de llaves foráneas.

Eager loading (carga diligente)

Al obtener un producto, le indicas que también deseas que te incluya los datos de la categoría. Para esto debes incluir un objeto virtual de la tabla categoria en tu tabla producto.

public class Producto
{ 
    [Key] 
    [DatabaseGenerated(DatabaseGeneratedOption.Identity)] 
    public int Id { get; set; }
    
    public virtual Categoria Categoria {get; set; }
            
    [Required(ErrorMessage = "Required")]
    [Range(1,999, ErrorMessage = "Range")]
    public int Clave { get; set; }

    [Required(ErrorMessage = "Required")]
    [Column(TypeName = "VARCHAR(80)")]
    public string Nombre { get; set; }
}

Cuando desees obtener un producto con su categoría, agregas el espacio de nombres System.Data.Entity y con la palabra Include incluyes el nombre de la tabla categoría. De esta manera si luego renombras la tabla categoría utilizando la opción de Visual Studio para renombrar, te cambiara el nombre de la tabla categoría en todas las tablas relacionadas. El query generado es un select de la tabla productos con un join a la tabla categoria.

using System.Data.Entity;
var productos = contexto.Productos.Include(p => p.Categoria).ToList()

Explicit loading (carga explícita)

Aquí indicas que deseas cargar la información de las tablas relacionadas. La diferencia es que con la primera forma se realiza con una sola query con un join y en esta forma se hacen varias consultas a la base de datos. Dependiendo de que tan complejo es la información que necesitas obtener a veces es mejor realizar mas llamadas a la base de datos que una sola query muy compleja.

Por ejemplo deseamos obtener todos los productos de la categoría con el Id 1. Primero obtenemos la categoría con el Id 1. El método Find lo que hace es que busca un registro por medio de su llave primaria, en este caso el Id. El query generado es un select a la tabla categoría donde el id es 1

var categoria = contexto.Categoria.Find(1)

Luego obtenemos todos los productos de esa categoría

contexto.Productos.Where(p=> p.CategoriaId == categoria.Id).ToList()

También de esta manera podemos filtrar la información de los productos por ejemplo que su nombre empiece con A, para esto utilizamos StartWith

var productos = contexto.Producto
                      .Where(p => p.CategoriaId == categoria.Id 
                          && p.Nombre.StartsWith('A')).ToList();

También puedes utilizar el operador in (contains), el cual te permite buscar los productos de diferentes categorías, por ejemplo, quieres encontrar los productos de las categorías cuyo Id es menor a 5. Para esto buscamos las categorías con el Id < 5. Luego mediante la instrucción indicamos que solo deseamos el campo Id de nuestra tabla categoría. Por último filtramos los productos cuya categoría este en la lista anterior.

var categorias = contexto.Categoria.Where(c => c.Id < 5);
var categoriasId = categorias.Select(c => c.Id);
var productos = contexto.Producto.Where
                 (p => categoriasId.Contains(p.CategoriaId)).ToList();

Lazy loading (carga diferida)

protected override void OnConfiguring(
         DbContextOptionsBuilder optionsBuilder)
    => optionsBuilder
        .UseLazyLoadingProxies()
        .UseMySql(Configuration.GetConnectionString
                                          ("DefaultConnection"));

Para obtener los productos de la categoría con el Id 1, en nuestra clase Categoria agregamos una objeto que guardará la lista de Productos

public class Categoria 
{ 
    public int Id { get; set; }
        
    public int Clave { get; set; }

    public string Nombre { get; set; }
    
    public virtual ICollection<Producto> Productos { get; set; }
}

Internamente se crea una clase llamada Proxy, la cual sería similar a lo siguiente:

public override Icollection<Producto> Productos
{
    get
    {
      if (_productos == null) 
          _productos = contexto.CargarProductos();
          
      return productos;
    }
}

De esta manera puedes consultar los productos de la categoría con solo acceder a la propiedad Productos de tu objeto Categoria

var categoria = contexto.Categoria.Find(1)
var productos = categoria.Productos;

Aunque parezca que se escribe menos código, la desventaja es que, si tienes muchas tablas relacionadas por ejemplo 5, cuando quieras obtener los datos de tu categoría con sus 5 tablas relacionadas, se realizarían 6 selects, uno para obtener la tabla categoría y otra por cada tabla relacionada que necesites.

Se recomienda mas para aplicaciones de escritorio. Ya que en aplicaciones web o de celulares no muestran tanta información al mismo tiempo y el usuario puede abandonar la página o la app si tarda mucho en cargar.

En mi caso prefiero yo indicar cuando quiero cargar la información relacionada por lo cual en la tabla producto solo agregue el campo CategoriaId.

Joins

Inner Join

También puedes obtener la información mediante joins. Agregas la palabra join indicando a que tabla deseas conectarte y con la palabra on primero escribes la primer tabla (categoria) y luego la siguiente tabla. Selecciona los campos que necesitas con select

var categorias_productos = (from categorias in contexto.Categoria
             join productos in contexto.Producto
                on categorias.Id equals productos.CategoriaId
                select new
                {
                    categoria.Id,
                    categoria.Nombre,
                    IdProducto = productos.Id,
                    NombreProducto = productos.Nombre
                }).ToList();

Left Join

Si existieran productos que no tuvieran categoría y deseas mostrar los productos con el nombre de la categoría o una cadena vacía si el producto no tiene categoría se debe realizar un left join. En linq esto se realiza guardando en una variable los datos de la categoría que es la que puede estar vacía y luego seleccionarla con la palabra DefaultIfEmpty

var categoriasYProductos = (from  p in _context.Producto
                               join c in _context.Categoria
                                  on p.CategoriaId equals c.Id
                                  into cat
                                  from categoria in 
                                              cat.DefaultIfEmpty()
                                      select new
                                      {
                                        Categoria = categoria.Nombre,
                                        p.Clave,
                                        p.Nombre
                                      }).ToList();

Agrupar productos por categoría

Group

Puedes agrupar los productos de forma jerárquica de acuerdo al Id de la categoría con la palabra Group. El resultado sería algo así:

Categoría Id: 1
     Producto: Aspirina
     Producto: Paracetamol
Cateogría Id: 2
     Producto: Bicarbonato de sodio
  • Selecciona tu tabla productos

  • Agrega la palabra group

  • Agrega el nombre de tu tabla

  • Ordena con la palabra by seguido del campo por el cual deseas agrupar

  • Agrega la palabra into seguido de un nombre para el grupo

  • Selecciona los campos de tu tabla que deseas mostrar o si seleccionas el nombre del grupo te mostrará todos los campos de tu tabla.

La sintaxis es:

from variable in contexto.NombreTabla group variable by campoGrupo 
       into nombreGrupo select nombreGrupo o campos

Se regresará un objeto el cual tiene:

  • Una variable llamada key que contiene el campo por el cual estas agrupando

  • Un objeto con los campos seleccionados.

El ejemplo es el siguiente:

var productosXCategoria = from productos in contexto.Producto
            group productos by productos.CategoriaId into p
            select p).ToList()
            
foreach (var categorias in productosXCategoria)
{
    Console.WriteLine("Categoría Id: "  + categorias.Key);
    foreach (var producto in categorias)
    {
        Console.WriteLine("\t Producto: {0}", producto.Nombre);
    }
}

Si deseas mostrar el nombre de la categoría, puedes realizar un group join

Group Join

En este ejemplo mostraré las categorías con el total de productos de cada categoría de la siguiente manera:

Análgesicos: 2
Antiácidos: 1

Realizas el join de categorías con productos, a la tabla productos le indicas que formará un grupo, esto te creará un objeto con los campos de la tabla categoría, y una lista de objetos con los datos de los productos. Con la palabra count() obtenemos el total de productos encontrados

var categoriasProd = (from categorias in _context.Categoria
                      join productos in _context.Producto
                         on categorias.Id equals 
                                        productos.CategoriaId
                             into grupo
                       select new { Categoria = categorias.Nombre,
                                    TotalProductos = grupo.Count()})
                                       .ToList();
foreach (var categoria in categoriasProd )
{
     Console.WriteLine(categoria.Categoria + ": " +
                  categoria.TotalProductos);
}

Si deseas obtener la lista de productos por categoría

Categoría: Análgesicos
     Producto: 1 - Aspirina
     Producto: 2 - Paracetamol
Cateogría: Antiácidos
     Producto: 3 - Bicarbonato de sodio

En lugar del count, simplemente con un select, seleccionamos los campos que necesitamos.

Otra forma de concatenar variables con texto es incluir $ seguido del texto que deseas mostrar y entre llaves pones las variables que deseas mostrar.

var categoriasYProductos = (from c in _context.Categoria
                              join p in _context.Producto
                                 on c.Id equals p.CategoriaId
                                 into grupo
                                   select new
                                   {
                                      Categoria = c.Nombre,
                                      Productos = grupo.Select(g => 
                                          new
                                          {
                                               g.Clave,
                                               g.Nombre
                                           })
                                        }).ToList();
foreach (var categoria in categoriasYProductos)
{
    Console.WriteLine("Categoría: " + categoria.Categoria);
    foreach (var producto in categoria.Productos)
    {
       Console.WriteLine($"Producto: {producto.Clave}
        - { producto.Nombre}");
    }
}

Como último ejemplo de group join, mostraré las categorías con los nombres de los productos separados por coma

Análgesicos: Aspirina, Paracetamol
Antiácidos: Bicabornato de Sodio

Para mostrar los productos separados por , utilizamos el método Join, el primer parámetro es una cadena con la cual deseamos separar los productos, seguido de una lista de productos, para esto seleccionamos el campo nombre del grupo de productos.

var categoriasYProductos = (from c in _context.Categoria
                               join p in _context.Producto
                                    on c.Id equals p.CategoriaId
                                into grupo
                             select new
                             {
                                Categoria = c.Nombre,
                                Productos = string.Join(",", 
                                     grupo.Select(g => g.Nombre))
                             }).ToList();
foreach (var categoria in categoriasYProductos)
{
    Console.WriteLine($"{categoria.Categoria} : 
              {categoria.Productos}");               
}

Aquí puedes ver un pdf con el resumen de las consultas explicadas por si deseas imprimirlo y/o consultarlo para tus proyectos de forma más rápida y offline.

Previous5.1 Crear la tabla de ProductosNext5.3 Crear llaves fóraneas e índices

Last updated 2 years ago

Was this helpful?

De esta manera cargas la información relacionada según la necesites. Para esto es necesario agregar el paquete y habilitarlo en el método OnConfiguring

El link de la documentación oficial de microsoft es

Microsoft.EntityFrameworkCore.Proxies
https://docs.microsoft.com/es-es/ef/core/querying/related-data
121KB
Resumen LINQ.pdf
pdf