Castle ActiveRecord 泛型应用

    Castle ActiveRecord在.Net2.0下支持泛型,这极大的方便了我们创建强类型集合以及对对象的强类型操作.本文引用了Castle站点上泛型的例子来详细介绍如何应用泛型. 另外你需要在这里找到NHibernate.Generics 来支持AR对泛型的扩展.这个例子描述了最简单的Blog与Post一对多的关系,为了让示例更清晰,做了少许修改. 

    NHibernate.Generics 中包含了若干供我们引用的泛型集合EntitySet,EntityList,EntityDictionary等,以及与这些集合相匹配的EntityRef.

DB结构
CREATE TABLE [dbo].[Blogs] (
    [blog_id] [int] IDENTITY (1, 1) NOT NULL ,
    [blog_name] [varchar] (50) NULL ,    
) ON [PRIMARY]

CREATE TABLE [dbo].[Posts] (
    [post_id] [int] IDENTITY (1, 1) NOT NULL ,
    [post_title] [varchar] (50) NULL ,
    [post_contents] [text] NULL ,    
    [post_blogid] [int] NULL ,    
) ON [PRIMARY] TEXTIMAGE_ON [PRIMARY]

Bolg Class
[ActiveRecord]
public class Blog : ActiveRecordBase
{
    EntitySet<Post> _posts;
    int _id;
    string _name;

    private Blog()
    {
        _posts = new EntitySet<Post>(
                delegate(Post p) { p.Blog = this; },
                delegate(Post p) { p.Blog = null; }
            );
    }

    [PrimaryKey(PrimaryKeyType.Identity, "blog_id", Access = PropertyAccess.NoSetterCamelCaseUnderscore)]
    public int Id
    {
        get { return _id; }
    }

    [Property("blog_name")]
    public string Name
    {
        get { return _name; }
        set { _name = value; }
    }

    [HasMany(typeof(Post), "post_blogId", "Posts", Inverse = true, 
        CustomAccess = Generics.Access, RelationType = RelationType.Set)]
    public ICollection<Post> Posts
    {
        get { return _posts; }
    }

    public static Blog FindByName(string value)
    {
        return ActiveRecordBase<Blog>.FindOne(new EqExpression("Name", value));
    }
}

    在BlogClass中看到了这样的定义EntitySet<Post> _posts.

    首先看看构造函数中对它的初始化2个匿名delegate的作用是当向Bolg.Posts集合中添加或移除一个Post时,自动添加或移除Post.Bolg属性设置.省却了每次都需要做双向设置.

    再来看一下Bolg.Posts的公开属性返回一个ICollection的接口是很重要的而不是具体类型,这样屏蔽了直接使用NHibernate.Generics中的集合所带来的依赖.

    最后看看顶上的attribute,对应关系不多讲,CustomAccess = Generics.Access是一定要标明的描述了泛型访问方式.RelationType = RelationType.Set同样要标识明确RelationType.Set对应EntitySet, RelationType.Bag则对应EntityList.Inverse属性有可无了,它指明了即使Bolg.Posts中的Post没有被存入数据库Bolg一样可以被先保存,通常我认为使用Cascade = ManyRelationCascadeEnum.All会更好.

    还有一点需要注意的是应用了泛型的私有变量命名如 _posts,按照AR目前最新的DailyBulid你必须按照下划线这样的格式命名,Access属性的设置似乎是无效的.如果使用其他方式会出错.

    泛型集合之后来关注下其他问题.

    你看到了Id的attribute,由于id是自动生成的所以无需设置set访问器,Access = PropertyAccess.NoSetterCamelCaseUnderscore会帮你赋值NoSetterCamelCaseUnderscore指出Id属性的私有变量命名方式是无set访问器的以下划线开头的Camel命名方式.

    对对象的数据库操作同样可以使用泛型,可以看到FindByName中省去了麻烦的转型.

Post Class
[ActiveRecord]
public class Post : ActiveRecordBase
{
    int _id;
    string _title;
    string _content;

    EntityRef<Blog> _blog;

    [PrimaryKey(PrimaryKeyType.Identity, "post_id",
        Access = PropertyAccess.NoSetterCamelCaseUnderscore)]
    public int Id
    {
        get { return _id; }
    }

    [Property("post_title")]
    public string Title
    {
        get { return _title; }
        set { _title = value; }
    }

    [Property("post_content")]
    public string Content
    {
        get { return _content; }
        set { _content = value; }
    }

    [BelongsTo("post_blog_id",
        CustomAccess = Generics.Access)]
    public Blog Blog
    {
        get { return _blog.Value; }
        set { _blog.Value = value; }
    }

    public Post()
    {
        _blog = new EntityRef<Blog>(
                delegate(Tests.Blog b) { b.Posts.Add(this); },
                delegate(Tests.Blog b) { b.Posts.Remove(this); }
            );
    }
}

    在PostClass中EntityRef是一个对对象的包装,使得它能够添加delegate与Entityxx集合对应来处理添加或移除的同步操作.在Post.Blog属性中可以通过_blog.Value来访问与设置EntityRef包装的值.attribute并没有特别支处,只是CustomAccess = Generics.Access也是不可缺少的属性.

    现在你可以使用ActiveRecord轻松编程了.