标签:有一个 and 连续 数据库表 针对 激活 leo name active
实体是DDD(领域驱动模型)的核心概念之一,Eric Evans 把它描述成“一个对象本质上不是通过其属性定义的,而是通过一系列连续性和标识来定义“。所以,实体都有一个Id,并保存在数据库里。一个实体类通常映射成关系型数据库的一个表。
在ABP里,实体类都派生自Entity类,如下面示例代码
public class Person : Entity
{
public virtual string Name { get; set; }
public virtual DateTime CreationTime { get; set; }
public Person()
{
CreationTime = DateTime.Now;
}
}
Person类定义成为一个实体类,它有两个属性,同时,Entity类定义了一个Id属性,它是这个实体类的主键,所以,所有实体类的主键都是一样的,都是为Id。
Id(主键)的类型是可以修改的,默认是int(Int32),如果你想把Id定义为其它类型,你应该像下面代码所示显示声明:
public class Person : Entity<long>
{
public virtual string Name { get; set; }
public virtual DateTime CreationTime { get; set; }
public Person()
{
CreationTime = DateTime.Now;
}
}
你也可以把它设置成string,Guid或者其它类型。
Entity类重写了equality操作符(==),使得检查两个实体是否相等(它们的Id是否相等)变得很容易;它也定义了一个**IsTransient()方法去检查是否有Id.
“聚合是领域驱动模型里的一种模式,DDD聚合是聚合领域对象,可以把它当成一个单元,在例子中聚合根可能是一个订单和订单里的子项,这些是单独的对象,但是把订单(连同他的子项)当成一个单一的聚合来对待是很有帮助的。“(Martin Fowler 全文
虽然ABP不强制你使用聚合,你也可能想在你的应用程序里创建聚合和聚合根,ABP里定义了一个继承了Entity的AggregateRoot为聚合来创建聚合根实体。
AggregateRoot定义了DomainEvents集合来生成领域事件,在当前工作单元完成前,这些事件会自动触发。事实上,任意一个实体都可以通过实现IGeneratesDomainEvents接口来生成领域事件,但是通常(最近实践)是在聚合根里来生成领域事件,这就是为什么把它默认定义在AggregateRoot里,而不是Entity类里。
在许多应用程序里,实体类里都会用到一些相同的属性(和数据库表字段),例如CreateTime,用来表示实体被创建的时间。ABP里提供了一些有用的接口,使得这些通用属性更明显及更富表达性,这也为实现了这些接口的实体类提供了一种公共代码的方式。
IHasCreationTime使得实体类的“创建时间”信息使用一个公共属性成为可能,当一个实现了这个接口的类对象插入到数据库里时,ABP会自动设置这个实体的创建时间属性值。
public interface IHasCreationTime
{
DateTime CreationTime { get; set; }
}
Person类实现IHasCreationTime接口后,可以重写成如下代码所示:
public class Person : Entity<long>, IHasCreationTime
{
public virtual string Name { get; set; }
public virtual DateTime CreationTime { get; set; }
public Person()
{
CreationTime = DateTime.Now;
}
}
ICreationAudited添加了CreatorUserId来扩展了IHasCreationTime:
public interface ICreationAudited : IHasCreationTime
{
long? CreatorUserId { get; set; }
}
当保存新的实体时,ABP会自动把CreatorUserId设置成当前用户的Id,针对不同类型的Id属性,它也有泛型版本的。
对于修改也有类似的接口:
public interface IHasModificationTime
{
DateTime? LastModificationTime { get; set; }
}
public interface IModificationAudited : IHasModificationTime
{
long? LastModifierUserId { get; set; }
}
当更新实体时,ABP也会自动设置这些属性,而你只要为你的实体定义它们就可以了。
如果你想实现所有这些审计属性,你可以直接实现IAudited接口:
public interface IAudited : ICreationAudited, IModificationAudited
{
}
作为一种快捷方式,你可以直接派生自AuditedEntity类,而不是直接去实现IAudited接口,AuditedEntity针对不同类型的Id属性有一个泛型版本。
注意:ABP是通过ABP Session取得当前用户。
软删除时一种通用的做法来标识实体被删除了,而不是真的从数据库里删除它。例如,你可能不想直接从数据库里删除一个用户的数据,因为它关联了其它一些表。ISoftDelete接口就是为这个目的而建的:
public interface ISoftDelete
{
bool IsDeleted { get; set; }
}
ABP实现了软删除模式,当一个实体被软删除时,ABP就会侦测到,阻止它直接删除,而把它的IsDeleted设置为true,并更新到数据库里,在查询时,ABP会自动过滤掉被软删除的数据。
如果你使用了软删除,你可能想保存这条数据是什么时候删除的,被谁删除的,那这样的话,你可以实现IDeletionAudited接口,如下所示:
public interface IDeletionAudited : ISoftDelete
{
long? DeleterUserId { get; set; }
DateTime? DeletionTime { get; set; }
}
如你所见,IDeletionAudited继承了ISoftDelete,当实体被删除时,ABP会自动设置这些属性。
如果你想对一个实体实现所有审计接口(创建、修改和删除),你可以直接实现IFullAudited接口,因为它继承那些接口:
public interface IFullAudited : IAudited, IDeletionAudited
{
}
作为一种快捷方式,你可以让你的类派生自实现了上面那些接口的FullAuditedEntity类。
有些实体需要标识为激活或失效,然后你可能对实体的激活/失效状态做一些操作,你可以实现IPassivable接口,它就是为了这个目的而建的,它定义了IsActive属性。
如果你的实体在第一次创建时就要被激活,你可以在构造函数里把IsActive设置为true。
这跟软删除(IsDeleted)有些不一样,如果一个实体被软删除了,它是无法从数据库里抓取出来的(ABP默认阻止获取软删除数据),但是,对于激活/失效状态的实体,从数据库获取数据时,就完全有你来决定了。
当一个实体被插入、修改或删除时,ABP会自动触发一些特定的事件。因此,你可以注册这些事件去执行任何你需要的逻辑。想了解更多可以查看event bus documentation里的Predefined Events。
实际上,Entity类实现了IEntity接口(和Entity实现了IEntity),如果你不想派生自Entity类,你可以直接实现这些接口,对于其它实体类也有相应的接口,但是不建议你这样做,除非你有一个好的理由不去派生自Entity类。
ABP提供了一个简单的接口,IExtendableObject,它可以轻易的把任意键值对数据与实体相关联起来,看看这个简单的实体:
public class Person : Entity, IExtendableObject
{
public string Name { get; set; }
public string ExtensionData { get; set; }
public Person(string name)
{
Name = name;
}
}
IExtendableObject只是定义了一个ExtensionData字符串属性,它被用来存放JSON格式的键值对对象。例如:
var person = new Person("John");
person.SetData("RandomValue", RandomHelper.GetRandom(1, 1000));
person.SetData("CustomData", new MyCustomObject { Value1 = 42, Value2 = "forty-two" });
我们可以用SetData方法设置任意类型的对象为值,当我们用到上面的代码时,ExtensionData的值是这样的:
{"CustomData":{"Value1":42,"Value2":"forty-two"},"RandomValue":178}
然后我们可以使用GetData取得任意值:
var randomValue = person.GetData<int>("RandomValue");
var customData = person.GetData<MyCustomObject>("CustomData");
在有些情况下,这是很有用的(当你需要提供向实体类上动态添加额外数据的能力时),正常情况下你应该使用常规属性,动态类型的用法类型既不明确,也不是安全。
标签:有一个 and 连续 数据库表 针对 激活 leo name active
原文地址:http://www.cnblogs.com/Lau7/p/8011492.html