Fluxera.ValueObject
8.2.4
Prefix Reserved
See the version list below for details.
dotnet add package Fluxera.ValueObject --version 8.2.4
NuGet\Install-Package Fluxera.ValueObject -Version 8.2.4
<PackageReference Include="Fluxera.ValueObject" Version="8.2.4" />
paket add Fluxera.ValueObject --version 8.2.4
#r "nuget: Fluxera.ValueObject, 8.2.4"
// Install Fluxera.ValueObject as a Cake Addin #addin nuget:?package=Fluxera.ValueObject&version=8.2.4 // Install Fluxera.ValueObject as a Cake Tool #tool nuget:?package=Fluxera.ValueObject&version=8.2.4
Fluxera.ValueObject
A value object implementation.
This library helps in implementing Value Object classes in the context of Domain-Driven Design. A Value Object has several traits, some of which this library provides.
A Value Object
- is immutable. Every property must be read-only (i.e. no setter allowed) after instantiation.
- contains domain logic and behaviours. It should encapsulate the domain complexity within it.
- uses the Ubiquitous Language of the domain. A Value Object is an elegant way of embracing the language of the domain in the codebase.
- exposes, uses and combines functions to provide domain value. Functions usually return new instances of a Value Object. Closure of Operations describes an operation whose return type is the same as the type of it's arguments.
// The following function doesn't change any given Amount instance, it just returns a new one.
public Amount Add(Amount amount)
{
if(this.Currency != amount.Currency)
{
throw new InvalidOperationException("Cannot add amounts with different currencies.");
}
Amount result = new Amount(this.Quantity + amount.Quantity, this.Currency);
return result;
}
- uses all of it's attibutes for Equality and Uniqueness.
- is automatically validated upon instantiation using domain validation and throws exception if a validation fails.
Usage
ValueObject<TValueObject>
By having your Value Object derive from the ValueObject<TValueObject>
base class it properly implements Equality
(Equals()
) and Uniqueness (GetHashCode()
). Automatically all public properties are used for the calculations
without you having to write a single line of code.
This default implementation uses reflection to aquire the metadata and to get the values to use. You can provide your own
implementation simply by overriding the GetEqualityComponents()
method.
A simple implementation would look like the this:
public class Amount : ValueObject<Amount>
{
public Amount(decimal quantity, Currency currency)
{
this.Quantity = quantity;
this.Currency = currency;
}
public decimal Quantity { get; }
public Currency Currency { get; }
public Amount Add(Amount amount)
{
if(this.Currency != amount.Currency)
{
throw new InvalidOperationException("Cannot add amounts with different currencies.");
}
Amount result = new Amount(this.Quantity + amount.Quantity, this.Currency);
return result;
}
}
If you decide not to use the relection-based approach, you can simply override GetEqualityComponents()
and
return the values manually. Keep in mind, that all attibutes should be used for Equality and Uniqueness.
protected override IEnumerable<object> GetEqualityComponents()
{
yield return this.Quantity;
yield return this.Currency;
}
PrimitiveValueObject<TValueObject, TValue
A specialized Value Object that only holds a single primitive, string or enum value.
Collections
There are implementations of IList<T>
, ISet<T>
and IDictionary<TKey, TValue>
that determine
equality based on content and not on the collection reference.
When your Value Object contains a collection, this collection needs to be wrapped in one of the available value collection to support the correct way for equality.
If you use the default behavior you can just wrap the collection in the constructor like below. The default equality behavior will automatically pick the value up.
public class Confederation : ValueObject<Confederation>
{
public Confederation(string name, IList<Country> memberCountries)
{
Guard.Against.NullOrWhiteSpace(name, nameof(name));
Guard.Against.NullOrEmpty(memberCountries, nameof(memberCountries));
this.Name = name;
this.MemberCountries = memberCountries.AsValueList(); // Wrap the list in a value list.
}
public string Name { get; }
public IList<Country> MemberCountries { get; }
}
If you prefer to override GetEqualityComponents()
and return the values manually you can wrap the list later.
protected override IEnumerable<object> GetEqualityComponents()
{
yield return this.Name;
yield return this.MemberCountries.AsValueList(); // Wrap the list in a value list.
}
Important Collections must be wrapped in value collections to ensure the correct equality behavior.
ValueList<T>
A list with equality based on the content instead on the list's reference, i.e. two different list instances containing the same items in the same order will be equal.
// Wrap an IList in a ValueList.
IList<Country> countries = new List<Country>
{
Country.Create("DE"),
Country.Create("US"),
};
IList<Country> valueList = countries.AsValueList();
ValueSet<T>
A set with equality based on the content instead on the set's reference, i.e two different set instances containing the same items will be equal regardless of their order.
// Wrap an ISet in a ValueSet.
ISet<Country> countries = new HashSet<Country>
{
Country.Create("DE"),
Country.Create("US"),
};
ISet<Country> valueSet = countries.AsValueSet();
ValueDictionary<TKey, TValue>
A dictionary with equality based on the content instead on the dictionary's reference, i.e. two different dictionary instances containing the same items will be equal.
// Wrap an IDictionary in a ValueDictionary.
IDictionary<int, Country> countries = new Dictionary<int, Country>
{
{ 1, Country.Create("DE") },
{ 4, Country.Create("US") },
};
IDictionary<int, Country> valueDictionary = countries.AsValueDictionary();
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 is compatible. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
-
net6.0
- No dependencies.
-
net7.0
- No dependencies.
-
net8.0
- No dependencies.
NuGet packages (9)
Showing the top 5 NuGet packages that depend on Fluxera.ValueObject:
Package | Downloads |
---|---|
Fluxera.Repository.Abstractions
The abstractions for the generic repository implementation. |
|
Fluxera.Repository
A generic repository implementation. |
|
Fluxera.ValueObject.SystemTextJson
A libary that provides serializer support for System.Text.Json for value objects. |
|
Fluxera.Extensions.Hosting.Modules.Domain.Shared
A module that enables the domain. |
|
Fluxera.ValueObject.EntityFrameworkCore
A libary that provides serializer support for EF Core for value objects. |
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
9.0.1 | 460 | 11/16/2024 |
9.0.0 | 190 | 11/14/2024 |
8.2.4 | 797 | 11/1/2024 |
8.2.3 | 278 | 7/9/2024 |
8.2.2 | 2,005 | 6/15/2024 |
8.2.1 | 287 | 6/12/2024 |
8.2.0 | 295 | 6/12/2024 |
8.1.1 | 930 | 6/2/2024 |
8.1.0 | 919 | 5/26/2024 |
8.0.9 | 240 | 5/24/2024 |
8.0.8 | 204 | 5/24/2024 |
8.0.7 | 7,655 | 4/18/2024 |
8.0.6 | 1,245 | 4/13/2024 |
8.0.5 | 353 | 4/13/2024 |
8.0.4 | 992 | 3/19/2024 |
8.0.3 | 2,760 | 2/22/2024 |
8.0.2 | 6,508 | 1/4/2024 |
8.0.1 | 1,443 | 11/23/2023 |
8.0.0 | 1,429 | 11/15/2023 |
7.1.6 | 1,189 | 7/23/2023 |
7.1.5 | 490 | 7/20/2023 |
7.1.4 | 1,110 | 6/21/2023 |
7.1.3 | 5,213 | 4/13/2023 |
7.1.2 | 1,630 | 3/16/2023 |
7.1.1 | 2,084 | 2/24/2023 |
7.1.0 | 3,106 | 1/18/2023 |
7.0.6 | 4,030 | 12/22/2022 |
7.0.5 | 884 | 12/13/2022 |
7.0.4 | 1,426 | 12/13/2022 |
7.0.3 | 2,534 | 12/9/2022 |
7.0.2 | 1,281 | 11/15/2022 |
7.0.1 | 1,643 | 11/12/2022 |
7.0.0 | 1,165 | 11/9/2022 |
6.1.9 | 5,943 | 10/12/2022 |
6.1.8 | 21,290 | 9/15/2022 |
6.1.7 | 5,077 | 7/30/2022 |
6.1.6 | 5,143 | 6/30/2022 |
6.1.5 | 5,112 | 6/15/2022 |
6.1.4 | 6,254 | 6/7/2022 |
6.1.3 | 1,578 | 6/7/2022 |
6.1.2 | 4,650 | 6/1/2022 |
6.1.1 | 9,378 | 5/29/2022 |
6.1.0 | 3,463 | 5/28/2022 |
6.0.10 | 8,709 | 5/5/2022 |
6.0.9 | 2,625 | 4/20/2022 |
6.0.8 | 8,039 | 3/24/2022 |
6.0.7 | 1,690 | 2/17/2022 |
6.0.6 | 1,194 | 12/17/2021 |
6.0.5 | 307 | 12/9/2021 |
6.0.2 | 303 | 12/9/2021 |