Castle ActiveRecord学习实践（4）：实现One-Many关系的映射

摘要：前面几篇文章简单的介绍了ActiveRecord中的基本映射以及构建配置信息，本文我们用ActiveRecord里面的Blog，Post例子来实现One-Many/Many-One关联。

主要内容

1．准备数据表结构

2．编写实体类并介绍HasMany和BlongsTo特性

3．构建配置信息

4．编写测试代码

 

一．准备数据表结构

在这个例子中，我们引入了两个对象Blog、Post，它们之间的关系是一对多，即一个Blog有多篇Post。需要用到的数据表结构如下

CREATE TABLE Blogs (

    blog_id     int IDENTITY(1, 1) PRIMARY KEY,

    blog_name   varchar(50),

    blog_author varchar(50)

)

 

CREATE TABLE Posts (

    post_id        int IDENTITY(1, 1) PRIMARY KEY,

    post_title     varchar(50),

    post_contents  text,

    post_categories varchar(50),

    post_blogid    int FOREIGN KEY REFERENCES Blogs (blog_id),

    post_created   datetime,

    post_published bit

)

二．编写实体类

首先我们来看Blog实体类的编写，需要用到HasMany特性，这时我们会在Blog实体类中定义一个Posts属性，用它来表示该Blog所发表的所有Posts，代码如下

 

[ActiveRecord("Blogs")]

public class Blog : ActiveRecordBase

{

    //……

    private IList _posts;

 

    [HasMany(typeof(Post), Table="posts", ColumnKey="post_blogid")]

    public IList Posts

    {

        get { return _posts; }

        set { _posts = value; }

    }

}

HasManyAttribute说明

属性	说明	示例
Cascade	指明哪些操作会从父对象级联到关联的对象，相关的操作见后面，如果不指定，则为None	Cascade=ManyRelationCascadeEnum.All
Inverse	指定是否级联操作	Inverse =true|false
Schema	指定Schema的名字	Schema="ARDemo"
Table	指定持久化类所关联的数据库表名，如果表名与类名相同，可以省略	Table="posts"
ColumnKey	指定关联类的一个属性，这个属性将会和本外键相对应。	ColumnKey="post_blogid"
Where	指定一个附加SQL的Where子句	Where="IsPost = 0"
Lazy	指定是否延迟加载关联对象	Lazy=true|false

Cascade的类型值有如下几种

类型	说明
None	不进行级联操作
SaveUpdate	进行级联Save/Update操作
Delete	进行级联Delete操作
All	进行级联Save/Update/Delete操作
AllDeleteOrphan	进行级联Save/Update/Delete操作，并删除无相关父对象的子对象

 

在Post实体类中，我们需要定义一个Blog类型的属性，并且用到BlongsTo特性，即一个Post属于某一个Blog，代码如下：

[ActiveRecord("Posts")]

public class Post : ActiveRecordBase

{

    //……

    private Blog _blog;

 

    [BelongsTo("blogid")]

    public Blog Blog

    {

        get { return _blog; }

        set { _blog = value; }

    }

}

BelongsToAttribute说明

属性	说明	示例
Cascade	指定级联操作	Cascade=CascadeEnum.SaveUpdate
Column	列名，外键字段名	BelongsTo("blogid") Column="blogid"
Insert	是否允许增加	Insert=true|false
NotNull	是否允许为空	NotNull =true|false
OuterJoin	是否允许外连接抓取	OuterJoin=OuterJoinEnum.True
Unique	是否唯一	Unique =true|false
Update	是否允许更新	Update =true|false

 

Cascade类型如下

选项	说明
None	默认值，不进行级联操作
All	进行级联Save/Update/Delete操作
SaveUpdate	进行级联Save/Update操作
Delete	进行级联Delete操作

 

OuterJoin选项有三个：Auto，True，False

最后完整的Blog实体类如下

/**//// <summary>

/// Blog 的摘要说明。

/// </summary>

[ActiveRecord("Blogs")]

public class Blog : ActiveRecordBase

{

    private int _id;

 

    private String _name;

 

    private String _author;

 

    private IList _posts;

 

    [PrimaryKey(PrimaryKeyType.Native, "blog_id")]

    public int Id

    {

        get { return _id; }

        set { _id = value; }

    }

 

    [Property("blog_name")]

    public String Name

    {

        get { return _name; }

        set { _name = value; }

    }

 

    [Property("blog_author")]

    public String Author

    {

        get { return _author; }

        set { _author = value; }

    }

    

    [HasMany(typeof(Post), Table="posts", ColumnKey="post_blogid")]

    public IList Posts

    {

        get { return _posts; }

        set { _posts = value; }

    }

 

    public static void DeleteAll()

    {

        DeleteAll( typeof(Blog) );

    }

 

    public static Blog[] FindAll()

    {

        return (Blog[]) FindAll( typeof(Blog) );

    }

 

    public static Blog Find(int id)

    {

        return (Blog) FindByPrimaryKey( typeof(Blog), id );

    }

}

 

完整的Post类如下

/**//// <summary>

/// Post 的摘要说明。

/// </summary>

[ActiveRecord("Posts")]

public class Post : ActiveRecordBase

{

    private int _id;

 

    private String _title;

 

    private String _contents;

 

    private String _category;

 

    private DateTime _created;

 

    private bool _published;

 

    private Blog _blog;

 

    public Post()

    {

        _created = DateTime.Now;

    }

 

    public Post(Blog blog, String title, String contents, String category) : this()

    {

        _blog = blog;

        _title = title;

        _contents = contents;

        _category = category;

    }

 

    [PrimaryKey(PrimaryKeyType.Native,"post_id")]

    public int Id

    {

        get { return _id; }

        set { _id = value; }

    }

 

    [Property("post_title")]

    public String Title

    {

        get { return _title; }

        set { _title = value; }

    }

 

    [Property(Column="post_contents",ColumnType="StringClob")]

    public String Contents

    {

        get { return _contents; }

        set { _contents = value; }

    }

 

    [Property("post_categories")]

    public String Category

    {

        get { return _category; }

        set { _category = value; }

    }

 

    [BelongsTo("post_blogid")]

    public Blog Blog

    {

        get { return _blog; }

        set { _blog = value; }

    }

 

    [Property("post_created")]

    public DateTime Created

    {

        get { return _created; }

        set { _created = value; }

    }

 

    [Property("post_published")]

    public bool Published

    {

        get { return _published; }

        set { _published = value; }

    }

 

    public static void DeleteAll()

    {

        ActiveRecordBase.DeleteAll( typeof(Post) );

    }

 

    public static Post[] FindAll()

    {

        return (Post[]) ActiveRecordBase.FindAll( typeof(Post) );

    }

}

三．构建配置信息

这里我采用上篇中将过的XML配置方式

<?xml version="1.0" encoding="utf-8" ?>

<activerecord>

    <config>

        <add key="hibernate.connection.driver_class" value="NHibernate.Driver.SqlClientDriver" />

        <add key="hibernate.dialect" value="NHibernate.Dialect.MsSql2000Dialect" />

        <add key="hibernate.connection.provider" value="NHibernate.Connection.DriverConnectionProvider" />

        <add key="hibernate.connection.connection_string" value="Data Source=.;Initial Catalog=test;Integrated Security=SSPI" />

    </config>

</activerecord>

 

四．编写测试代码

1．级联增加：新增一个Blog，并同时添加相关的Post到数据表中

[Test]

public void TestCascadingSave()

{

    //创建Blog对象

    Blog blog = new Blog();

    blog.Name="Terrylee's Tech Space";

    blog.Author = "Terrylee";

 

    //执行事务，持久化对象到数据库

    using(TransactionScope tran = new TransactionScope())

    {

        try

        {

            blog.Create();

            

            for(int i=1;i<11;i++)

            {

                //创建Post对象

                Post post = new Post();

                post.Title="This is my "+i.ToString()+" post";

                post.Category="Castle";

                post.Blog = blog;

                post.Save();

            }

 

            tran.VoteCommit();

        }

        catch

        {

            tran.VoteRollBack();

        }

    }// The changes will be sent to the DB when the session is disposed here

}

2．级联更新：
首先我们为一个已经存在的Blog增加多个Post

 

[Test]

public void TestCascadingUpdate()

{   

    //找到ID为5的Blog

    Blog blog = Blog.Find(5);

 

    //执行事务，持久化对象到数据库

    using(TransactionScope tran = new TransactionScope())

    {

        try

        {           

            for(int i=1;i<5;i++)

            {

                //创建Post对象

                Post post = new Post();

                post.Title="This is my "+i.ToString()+" post";

                post.Category="Castle";

                

                post.Save();

                

                //注意这句

                blog.Posts.Add(post);

            }

            

            blog.Update();

 

            tran.VoteCommit();

        }

        catch

        {

            tran.VoteRollBack();

        }

    }

}

当然上面的更新代码也可以这样去写：

[Test]

public void TestCascadingUpdate()

{   

    //找到ID为5的Blog

    Blog blog = Blog.Find(5);

 

    //执行事务，持久化对象到数据库

    using(TransactionScope tran = new TransactionScope())

    {

        try

        {           

            for(int i=1;i<5;i++)

            {

                //创建Post对象

                Post post = new Post();

                post.Title="This is my "+i.ToString()+" post";

                post.Category="Castle";

 

                //在这儿指定它们的关联

                post.Blog = blog;

                post.Save();

            }

            

        tran.VoteCommit();

        }

        catch

        {

            tran.VoteRollBack();

        }

    }

}

但是如果我们去掉post.Save()这句话，就会发现Post并没有增加到库中：

[Test]

public void TestCascadingUpdate()

{   

    //找到ID为5的Blog

    Blog blog = Blog.Find(5);

 

    //执行事务，持久化对象到数据库

    using(TransactionScope tran = new TransactionScope())

    {

        try

        {           

            for(int i=1;i<5;i++)

            {

                //创建Post对象

                Post post = new Post();

                post.Title="This is my "+i.ToString()+" post";

                post.Category="Castle";

                

                //注释掉这句

                //post.Save();

                

                blog.Posts.Add(post);

            }

 

            blog.Update();

            

        tran.VoteCommit();

        }

        catch

        {

            tran.VoteRollBack();

        }

    }

}

此时，必须修改我们的Blog类，设置级联操作为SaveUpdate，上面的代码才可以正常执行

// 

[HasMany(typeof(Post), Table="posts", ColumnKey="post_blogid",Cascade=ManyRelationCascadeEnum.SaveUpdate)]

public IList Posts

{

    get { return _posts; }

    set { _posts = value; }

}

下面再测试一个删除某一个Blog的某些Post后，再保存

[Test]

public void TestCascadingUpdateDel()

{   

    //找到ID为7的Blog

    Blog blog = Blog.Find(7);

    int expectedCount = blog.Posts.Count;

    

    using(TransactionScope tran = new TransactionScope())

    {

        try

        {

            blog.Posts.RemoveAt(0);

            

            blog.Update();

 

            tran.VoteCommit();

        }

        catch

        {

            tran.VoteRollBack();

        }

    }

    

    int actualCount = Blog.Find(7).Posts.Count;

 

    Assert.AreEqual(expectedCount-1,actualCount);

}

上面这段代码测试可以通过，但是我们会发现表Posts中会有一些记录没有BlogId，修改Blog实体类重新设置级联操作，就可以正常删除了：

// 

[HasMany(typeof(Post), Table="posts", ColumnKey="post_blogid",Cascade=ManyRelationCascadeEnum.AllDeleteOrphan)]

public IList Posts

{

    get { return _posts; }

    set { _posts = value; }

}

3．级联删除

删除一个Blog对象后，对应的Post对象应该全部删除

[Test]

public void TestCascadingDelete()

{

    //找到ID为7的Blog对象

    Blog blog = Blog.Find(5);

 

    using(TransactionScope tran = new TransactionScope())

    {

        try

        {

            blog.Delete();

 

            tran.VoteCommit();

        }

        catch

        {

            tran.VoteRollBack();

        }

    }

}

同样要注意设置级联操作。

关于One-Many关联映射就介绍这么多了，至于Many-One关联同One-Many，只不过对HasMany和BlongsTo设置的位置不一样而已，在下一篇文章中我会介绍在ActiveRecord中实现Many-Many关联映射。

 

参考资料

Castle的官方网站http://www.castleproject.org