Code First en Entity Framework

Code-First es un enfoque de desarrollo en Entity Framework donde los modelos de datos se definen mediante clases de C#.

En este modelo, partimos de las clases de C# para definir nuestra estructura de datos. Estas clases (que llamamos entidades), representan las tablas de la base de datos, y sus propiedades representan las columnas.

Posteriormente, Entity Framework se encarga de generar automáticamente la base de datos correspondiente (incluyendo tablas, relaciones y restricciones) partir de estas entidades.

Este enfoque es especialmente útil en proyectos nuevos, donde no existe una base de datos predefinida, o en proyectos donde se prefiere mantener el control total sobre el diseño de la base de datos mediante código.

Flujo de trabajo con Code-First

El flujo de trabajo con Code-First consta de los siguientes pasos:

El modelo de datos

Hemos visto cómo crear el modelo, relaciones, y operaciones, en el resto del curso. Así que no voy a entretenerme demasiado aquí

Pero, a modo de resumen, supongamos que tenemos un modelo como este

public class Producto
{
    public int Id { get; set; } // Clave primaria
    public string Nombre { get; set; }
    public decimal Precio { get; set; }
    public int Stock { get; set; }
}

public class MiContexto : DbContext
{
    public DbSet<Producto> Productos { get; set; } // Representa la tabla Productos

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        // Configura la conexión a la base de datos
        optionsBuilder.UseSqlServer("Server=miServidor;Database=MiBaseDeDatos;Trusted_Connection=True;");
    }
}

public class Categoria
{
    public int Id { get; set; }
    public string Nombre { get; set; }
    public ICollection<Producto> Productos { get; set; } // Relación 1:N
}

public class Producto
{
    public int Id { get; set; }
    public string Nombre { get; set; }
    public decimal Precio { get; set; }
    public int Stock { get; set; }
    public int CategoriaId { get; set; } // Clave foránea
    public Categoria Categoria { get; set; } // Relación 1:N
}

Migraciones

Las migraciones son un mecanismo que permite generar y aplicar cambios en la base de datos a partir de las entidades definidas en el código.

Cada migración es un registro versionado de cambios realizados en el modelo de datos de la aplicación, que refleja un conjunto de modificaciones a aplicar a la base de datos (agregar o eliminar tablas, campos, restricciones, etc.)

Para crear una migración, utilizamos la CLI de .NET (dotnet ef)

Creación de la primera migración

Para crear la primera migración, abrimos una terminal en la carpeta del proyecto y ejecutamos:

dotnet ef migrations add Inicial

¿Qué contiene una migración?

Una migración en EF es una clase C# que contiene instrucciones para modificar la base de datos, tanto para aplicar los cambios (Up) como para deshacerlos (Down).

La clase Inicial contiene métodos como estos:

protected override void Up(MigrationBuilder migrationBuilder)
{
    migrationBuilder.CreateTable(
        name: "Estudiantes",
        columns: table => new
        {
            Id = table.Column<int>(nullable: false)
                .Annotation("SqlServer:Identity", "1, 1"),
            Nombre = table.Column<string>(nullable: true),
            Correo = table.Column<string>(nullable: true)
        },
        constraints: table =>
        {
            table.PrimaryKey("PK_Estudiantes", x => x.Id);
        });
}

Y el método Down hace lo contrario:

protected override void Down(MigrationBuilder migrationBuilder)
{
    migrationBuilder.DropTable(name: "Estudiantes");
}

Aplicar las migraciones a la base de datos

Una vez creada la migración, ejecutamos:

dotnet ef database update

Esto aplica las instrucciones Up() en la base de datos. Si hay un error, la transacción se revierte.

Cambios en el modelo y migraciones

Supongamos que agregamos una nueva entidad:

public class Curso
{
    public int Id { get; set; }
    public string Titulo { get; set; }
    public int Creditos { get; set; }
}

Y la añadimos al DbContext:

public DbSet<Curso> Cursos { get; set; }

Generamos la migración:

dotnet ef migrations add AgregaCurso

Y luego:

dotnet ef database update

EF aplicará solo los cambios mínimos y necesarios. En este caso, crear la nueva tabla Cursos.

Comandos útiles de migración