abp/docs/zh-Hans/Value-Objects.md

值对象

一个对象,表示领域的描述方面,没有概念上的身份被称为 值对象.

(Eric Evans)

属性相同但Id不同的两个实体 被视为不同的实体.但是,值对象没有Id

值对象的类

值对象是一个抽象类,可以继承它来创建值对象类

示例: An Address class

public class Address : ValueObject
{
    public Guid CityId { get; private set; }

    public string Street { get; private set; }

    public int Number { get; private set; }

    private Address()
    {
        
    }
    
    public Address(
        Guid cityId,
        string street,
        int number)
    {
        CityId = cityId;
        Street = street;
        Number = number;
    }

    protected override IEnumerable<object> GetAtomicValues()
    {
        yield return Street;
        yield return CityId;
        yield return Number;
    }
}

• 值对象类必须实现 GetAtomicValues()方法来返回原始值

ValueEquals

ValueObject.ValueEquals(...) 用于检测两个值是否相等

示例: Check if two addresses are equals

Address address1 = ...
Address address2 = ...

if (address1.ValueEquals(address2)) //Check equality
{
    ...
}

最佳实践

以下是使用值对象时的一些最佳实践:

• 如果没有充分的理由将值对象设计为可变的,则将其设计为不可变（如上面的地址）.
• 构成一个值对象的属性应该形成一个概念整体.例如：CityId,Street和Number不应是个人实体的单独属性.这也使Person实体更简单.

另请参阅

• 实体