随着Castle1.0 RC2版本的发布，Castle逐渐走向成熟和趋于稳定，打算在近期写几篇关于AR的Hands On Lab。本篇文章将会介绍AR中最基本的数据访问，包括数据简单筛选和模糊查询等。在开始本Hands On Lab之前，请先下载并安装Castle 1.0 RC2。在整个Hands On Lab中，我们将使用Northwind数据库作为示例，开发环境为VS2005。

1．新建Castle ActiveRecord 项目，安装Castle之后会在新建项目对话框中看到Castle ActiveRecord项目类型，输入项目名Models。

在生成一个Models项目的同时，也为我们生成了一个Models.Test的单元测试项目，这里我们不用测试驱动的方法，直接删除该测试项目就可以了。

2．在Models项目中添加Customer实体类，并引入命名空间：

using Castle.ActiveRecord;

完成后Customer实体类代码如下：

[ActiveRecord("Customers")]

public class Customer : ActiveRecordBase<Customer>

{

    private String _customerID;

    private String _companyName;

    private String _contactName;

    private String _contactTitle;

    private String _address;

    private String _city;

    private String _region;

    private String _postalCode;

    private String _country;

    private String _phone;

    private String _fax;

    [PrimaryKey(PrimaryKeyType.Assigned)]

    public String CustomerID

    {
        get { return _customerID; }

        set { _customerID = value; }
    }

    [Property]

    public String CompanyName

    {
        get { return _companyName; }

        set { _companyName = value; }
    }

    [Property]

    public String ContactName

    {
        get { return _contactName; }

        set { _contactName = value; }
    }

    [Property]

    public String ContactTitle

    {
        get { return _contactTitle; }

        set { _contactTitle = value; }
    }

    [Property]

    public String Address

    {
        get { return _address; }

        set { _address = value; }
    }

    [Property]

    public String City

    {
        get { return _city; }

        set { _city = value; }
    }

    [Property]

    public String Region

    {
        get { return _region; }

        set { _region = value; }
    }

    [Property]

    public String PostalCode

    {
        get { return _postalCode; }

        set { _postalCode = value; }
    }

    [Property]

    public String Country

    {
        get { return _country; }

        set { _country = value; }
    }

    [Property]

    public String Phone

    {
        get { return _phone; }

        set { _phone = value; }
    }

    [Property]

    public String Fax

    {
        get { return _fax; }

        set { _fax = value; }
    }

}

用ActiveRecord特性来指定表名为Customers。

3．新建Web Site，删除默认的Default.aspx页面，添加一个Master页面，在页面加入如下元素：

<div>

    <h2>Castle ActiveRecord Hands On Lab</h2>

    <asp:contentplaceholder id="ContentPlaceHolder1" runat="server">

    </asp:contentplaceholder>

</div>

4．添加ASPX页面，并选择刚才的Master页面作为它的母版页，在ASPX页面中添加一个GridView控件，如下所示：

在GridView中添加绑定列，最终代码如下：

<asp:GridView ID="GridView1" runat="server" Width="610px" AutoGenerateColumns="false">

    <Columns>

        <asp:BoundField DataField="CustomerID" HeaderText="CustomerID" />

        <asp:BoundField DataField="ContactName" HeaderText="ContactName" />

        <asp:BoundField DataField="Country" HeaderText="Country" />

        <asp:BoundField DataField="Phone" HeaderText="Phone" />

    </Columns>

</asp:GridView>

5．编写绑定代码，在Page_Load中加入GridView的绑定代码。

protected void Page_Load(object sender, EventArgs e)

{
    this.GridView1.DataSource = Customer.FindAll();

    this.GridView1.DataBind();
}

这里使用了静态的FindAll()方法，该方法已经在泛型的ActiveRecordBase中作了定义，不需要再在实体类中实现。

6．编写配置文件，在Web项目中添加Web.config文件，在Web.config中添加ActiveRecord配置区。

<configSections>

  <section name="activerecord" type="Castle.ActiveRecord.Framework.Config.ActiveRecordSectionHandler, Castle.ActiveRecord"/>

</configSections>

<connectionStrings>

  <add name="NorthWind" connectionString="Data Source=1DD43B143D104DB;Initial Catalog=Northwind;User ID=sa;Password=sa"/>

</connectionStrings>

<activerecord isWeb="true">

  <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="ConnectionString = ${NorthWind}"/>

  </config>

</activerecord>

由于是Web项目，这里ActiveRecord配置区的isWeb属性必须设置为true。

7．初始化ActiveRecord实体类。在Web Site中添加Global.asax，并导入命名空间：

<%@ Import Namespace="Models" %>

在Application_Start中添加初始化代码：

void Application_Start(object sender, EventArgs e) 

{
   Castle.ActiveRecord.Framework.IConfigurationSource source =  System.Configuration.ConfigurationManager.GetSection("activerecord") as Castle.ActiveRecord.Framework.IConfigurationSource;

   Castle.ActiveRecord.ActiveRecordStarter.Initialize(System.Reflection.Assembly.Load("Models"),source);

}

这里可以对单个实体类进行初始化或者加载整个程序集。

8．至此，一个最简单的基于ActiveRecord的数据查询就做完了，运行后如下：

9．简单的数据筛选，在ActiveRecordBase基类中提供了一个方法FindAllByProperty，可以使用属性进行查询，如我们只查询国家为“UK”的Customer，在Page_Load中修改绑定代码如下：

protected void Page_Load(object sender, EventArgs e)

{

    this.GridView1.DataSource = Customer.FindAllByProperty("Country","UK");

    this.GridView1.DataBind();

}

运行后如下：

10．使用NHibernate的表达式来进行数据筛选。首先引入命名空间：

using NHibernate.Expression;

在Page_Load中修改绑定代码如下所示，我们仍然查询国家为“UK”的Customer。

protected void Page_Load(object sender, EventArgs e)

{

    this.GridView1.DataSource = Customer.FindAll(Expression.Eq("Country", "UK"));

    this.GridView1.DataBind();

}

运行后与上面使用FindAllByProperty()方法的查询结果一致。

11．实现简单的模糊匹配查询。在Default.aspx页面中添加一个Label、TextBox、Button控件，如下图所示，这里我们对ContactName添加模糊查询功能：

HTML代码：

<asp:Label ID="Label1" runat="server" Text="ContactName："></asp:Label>

<asp:TextBox ID="txt_Search" runat="server" Width="242px"></asp:TextBox>

<asp:Button ID="btn_Search" runat="server" OnClick="btn_Search_Click" Text="Search" />

切换到设计视图，双击Search按钮，添加Click事件，并编写代码，这里用HQL语句来实现，关于HQL语句可以参考http://www.hibernate.org/hib_docs/reference/en/html/queryhql.html。完成后代码如下：

protected void btn_Search_Click(object sender, EventArgs e)

{

    IActiveRecordQuery query = new HqlBasedQuery(typeof(Customer), "from Customer c where c.ContactName like ?", "%" + this.txt_Search.Text + "%");

    this.GridView1.DataSource = ActiveRecordMediator.ExecuteQuery(query);

    this.GridView1.DataBind();

}

运行后在文本框中输入Mar，可以看到结果如下：

本文简单的介绍到这里。

示例下载：http://files.cnblogs.com/Terrylee/ARHandsOnLab.rar