Tizzani.ValueObject 0.2.0

Tizzani.ValueObject

A simple value object framework easily configurable for use with Entity Framework Core.

Sample Usage

BlogTitle.cs

public sealed record BlogTitle : ValueObject<string>
{
    public BlogTitle(string value) : base(value) { }
    
    public override void Validate(string value)
    {
        if (string.IsNullOrWhiteSpace(value))
            throw new ArgumentException("Blog title is required.");
          
        if (value.Length > 50)
            throw new ArgumentException("Blog title cannot exceed 50 characters.");
    }
}

Blog.cs

public sealed class Blog
{
    public int Id { get; set; }
    public BlogTitle Title { get; set; } = null!;
}

BlogContext.cs

public sealed class BlogContext : DbContext
{
    public DbSet<Blog>() Blogs => Set<Blog>();
    
    protected override void OnModelCreating(ModelBuilder builder)
    {
        modelBuilder.MapValueObjects();
        
        // for additional configuration (e.g., max length):
        modelBuilder.Entity<Blog>().HasValueObject(x => x.Title).HasMaxLength(50);
    }
}

Json Serialization

In some cases it might be useful to serialize/deserialize to/from the underlying value type. For these cases, you can include ValueObjectConverter in your json serialization options:

Without custom converter:

var blog = new Blog(1, new BlogTitle("My Sick Blog"));

// output: {"Id":1,"Title":{"Value":"My Sick Blog"}}
Console.WriteLine(JsonSerializer.Serialze(blog));

With custom converter:

var blog = new Blog(1, new BlogTitle("My Sick Blog"));

var options = new JsonSerializerOptions();
options.Converters.Add(new ValueObjectConverter());

// output: {"Id":1,"Title":"My Sick Blog"}
Console.WriteLine(JsonSerializer.Serialize(blog, options));