A Closer Look at What’s New in .NET 8 Series (Part 2) – Understanding Value Objects with Complex Types in Entity Framework Core 8

In the ever-evolving world of software development, managing data efficiently and intuitively is paramount. With the release of Entity Framework Core 8 (EF8), Microsoft introduces a powerful new feature: Value Objects With Complex Types. This feature aims to streamline how we handle certain categories of data objects within our applications. In this blog post, we’ll explore what Complex Types are, why they are beneficial, and how to use them effectively in your .NET projects.

Categories of Objects in Entity Framework Core

To understand the significance of Complex Types, we first need to categorize the types of objects we work with in Entity Framework Core:

1. Primitive Types: These are unstructured objects that hold a single value, such as int, Guid, string, or IPAddress. They are simple and straightforward, used commonly across applications.
2. Entity Types: These are structured objects that hold multiple values and are identified by a key value. Examples include Blog, Post, and Customer. Entity types are core components in EF Core, typically represented by tables in the database.
3. Complex Types: This category includes structured objects that hold multiple values but do not have a key defining their identity. Examples are Dimensions, GeoLocation, and ContactInfo Structured objects holding multiple values without a key defining their identity, Before EF8, handling such objects was challenging as there was no direct support for them, often leading to convoluted workarounds using owned types.

Introduction to Complex Types in EF8

Entity Framework Core 8 addresses the need for a proper way to handle complex types. These objects are:

1. Not identified or tracked by key value: Unlike entity types, complex types do not rely on a primary key for their identity.
2. Defined as part of an entity type: Complex types cannot exist independently in the context of a DbSet. They must be part of an entity.
3. Support both .NET value types and reference types: This flexibility allows you to use complex types for a wide range of scenarios.
4. Instances can be shared by multiple properties: This means you can reuse complex type instances across different properties of an entity.

Why Use Complex Types?

Complex types offer several advantages:

1. Simplified Data Modeling: Allowing more natural data structures.
2. Improved Code Clarity: Distinguishing clearly between entities and non-entity structures.
3. Enhanced Reusability: Promoting reuse of common data structures.

Implementing Complex Types in EF8

Let’s explore practical examples using Dimensions and GeoLocation complex types within Product and Warehouse entities.

Define a Complex Type:

public class Dimensions
{
    public double Length { get; set; }
    public double Width { get; set; }
    public double Height { get; set; }
}

public class GeoLocation
{
    public double Latitude { get; set; }
    public double Longitude { get; set; }
}

Integrate the Complex Type into an Entity:

public class Product
{
    public int Id { get; set; }
    public string Name { get; set; }
    public Dimensions ProductDimensions { get; set; }
}

public class Warehouse
{
    public int Id { get; set; }
    public string LocationName { get; set; }
    public GeoLocation LocationCoordinates { get; set; }
}

Configure Complex Types in the DbContext:

public class ApplicationDbContext : DbContext
{
    public DbSet<Product> Products { get; set; }
    public DbSet<Warehouse> Warehouses { get; set; }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity<Product>(entity =>
        {
            entity.OwnsOne(p => p.ProductDimensions);
        });

        modelBuilder.Entity<Warehouse>(entity =>
        {
            entity.OwnsOne(w => w.LocationCoordinates);
        });
    }
}

In this configuration, OwnsOne indicates that Dimensions and GeoLocation are complex types within the Product and Warehouse entities, respectively.

Conclusion

Complex types in EF8 bring a new level of sophistication to how we model and manage data in .NET applications. By eliminating the need for a primary key and allowing seamless integration within entities, complex types offer a cleaner, more efficient approach to handling structured data without unique identity requirements. As you embrace EF8, leveraging complex types will undoubtedly lead to more maintainable and robust applications.

We hope this introduction to complex types in Entity Framework Core 8 has been informative and inspires you to incorporate this feature into your next project. Happy coding!