Castle Project非常庞大,ActiveRecord是其中一个非常适合用于Domain Model开发的O/R Mapping框架。它使用.NET的反射特性无需配置文件,集成NHibernate完成数据层持久化功能,根据创建的Model生成数据表,这使得我们在Domain Model的开发中,只需要致力于业务对象关系的分析和定义,大大简少了工作量。
开发环境:
Windows Server 2003 Enterprise + IIS 6.0
CastleProject-1.0-RC3
Visual Studio 2008
.NET Framework 3.5
Oracle 9i
Code Smith 4.1(如果你先定义好了数据表,可用于生成实体类,但它不支持复合主键)
NUnit 2.4.8.0
首先我们来看看ActiveRecord的官方示例MoreComplexSample-vs2003中几个类的关系图:
ActiveRecord的实体类需要在类名上标记[ActiveRecord]。
[BelongsTo] + [HasMany] 表示两个对象的一对多关系
[BelongsTo("ColumnName")] 生成ColumnName的列作为外键。一个Order只有一个Customer(belongs to)。
[HasMany] 不会生成列,Customer可以有多个Order(has many)。如果类中BelongsTo的属性类型不是这个类本身,那么它的类型中必须有对应的HasMany(或HasAndBelongsToMany),否则使用ActiveRecordStarter初始化时会报错。
生成数据表关系如下图所示:
Order.cs
[BelongsTo("CustomerId")] public Customer Customer { get { return customer; } set { customer = value; } }
[HasMany(Lazy=true)] public ISetOrders { get { return orders; } set { orders = value; } }
[BelongsTo("ParentId")] public Category Parent { get { return parent; } set { parent = value; } }
将生成一个带有Parent外键,指向自身主键的Category表。
[HasAndBelongsToMany] 表示多对多关系并生成关系表
[HasAndBelongsToMany(Table="TableName", ColumnKey="ColumnName", ColumnRef="ColumnName")]
HasAndBelongsToMany将以指定的表名生成两个类的关联表,ColumnKey、ColumnRef分别代表这个类与关系对象在TableName中提供作外键的列名。例中Category与Product是多对多关系:
Category.cs
[HasAndBelongsToMany( Table="ProductCategory", ColumnKey="CategoryId", ColumnRef="ProductId", Inverse=true, Lazy=true)] public ISetProducts { get { return products; } set { products = value; } }
Product.cs
[HasAndBelongsToMany( Table="ProductCategory", ColumnKey="ProductId", ColumnRef="CategoryId", Lazy=true)] public ISetCategories { get { return categories; } set { categories = value; } }
两个对象中均标记为HasAndBelongsToMany并且表、列对应,ActiveRecord将生成一个名为ProducCategory,包含ProductID和CategoryID的关系表。
如果关系表恰恰也被定义作为了类,如LineItem,它在Order.cs中已经被使用[HasAndBelongsToMany]进行了表名定义,那么,它需要用两个BelongsTo来表示对Order和Product的关系映射。
Order.cs
[HasAndBelongsToMany( Table="LineItem", ColumnKey="OrderId", ColumnRef="ProductId", Inverse = true, Lazy = true)] public ISetProducts { get { return products; } set { products = value; } }
LineItem.cs
[BelongsTo("OrderId", NotNull = true, UniqueKey = "ConstraintName")] public Order Order { get { return order; } set { order = value; } } [BelongsTo("ProductId", NotNull = true, UniqueKey = "ConstraintName")] public Product Product { get { return product; } set { product = value; } }
public class Product { [OneToOne] public ProductDetail Detail { get; set; } }
public class ProductDetail { [PrimaryKey(PrimaryKeyType.Foreign)] public int ProductID { get; set; } }