Active Record学习笔记（一）：初步接触

最近开始接触Castle ActiveRecord，学习资料大部分是从网上找到的。这里要特别感谢TerryLee的系列文章：Castle 开发系列 ，在Castle的学习之路上，这个系列文章对我的影响是十分巨大的！除了这个系列文章之外，Castle的官方网站也是学习Castle的好去处！

本篇学习笔记从一个简单对象的CURD操作入手，介绍ActiveRecord！

主要内容：
１．ActiveRecord概述
２．准备数据表
３．编写实体类
４．编写配置文件
５．对象的CRUD操作
６．表示层调用

一、ActiveRecrod概述
　　ActiveRecord是Castle中提供的一个数据访问框架，它在底层封装了NHibernate的操作。与NHibernate相比，ActiveRecord使用特性来代替映射文件hbm.xml，它提供的简洁的O/R映射会让你惊叹原来实现持久化数据层是那么简单。

二、准备数据表

Create   Table   [ Users ]
(
     [ ID ]   Int   Identity ( 1 , 1 )  Primary   Key ,
     [ LoginName ]   Varchar ( 50 )  not   null ,
     [ Password ]   Varchar ( 20 )  not   null
)

三、编写实体类User
　　１．引用Castle.ActiveRecord.dll组件；
　　２．引用Castle.ActiveRecord名称空间：

using  Castle.ActiveRecord;

　　３．让User类继承ActiveRecordBase类（此类处于Castle.ActiveRecord名称空间之下）：

public   class  User : ActiveRecord
{
   //
}

　　４．用[ActiveRecrod()]为类添加特性，指出User类对应的数据表是Users：

[ActiveRecord( " Users " )]
public   class  User : ActiveRecordBase
{
   //
}

　　５．用[Property()]为属性添加特性，指出属性对应数据表中的列：

[ActiveRecord( " Users " )]
public class  User : ActiveRecordBase
{
    private int _id;
    private string _name;
    private string _password;

    //[PrimaryKey]特性指定Id作为主键
    //用PrimaryKeyType.Identity来说明了主键的类型为自增型的
    [PrimaryKey(PrimaryKeyType.Identity, "ID")]
    public int Id
    {
        get { return _id; }
        set { _id = value; }
    }

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

    //若属性名与列名一致可省略不写
    [Property]
    public string Password
    {
        get { return _password; }
        set { _password = value; }
    }
}

四、编写配置文件App.config或web.config。由于ActiveRecord在底层封装了NHibernate，故配置文件的信息和NHibernate一致。
App.config：

<? xml version="1.0" encoding="utf-8"  ?>
< configuration >
     < configSections >
         < section  name ="activerecord"  type ="Castle.ActiveRecord.Framework.Config.ActiveRecordSectionHandler, Castle.ActiveRecord"   />
     </ configSections >
     < 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 ="UID=sa;Password=123456789;Initial Catalog=Castle;Data Source=EMMALEE"   />
         </ config >
     </ activerecord >
</ configuration >

web.config

<? xml version="1.0" ?>
< configuration >
     < configSections >
         < section  name ="activerecord"  type ="Castle.ActiveRecord.Framework.Config.ActiveRecordSectionHandler, Castle.ActiveRecord" />
     </ configSections >
     < 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 ="UID=sa;Password=123456789;Initial Catalog=Castle;Data Source=EMMALEE"   />
         </ config >
     </ activerecord >
     < system .web >
         < compilation  debug ="true" />
         < authentication  mode ="Windows" />
             < customErrors  mode ="RemoteOnly"  defaultRedirect ="GenericErrorPage.htm" >
             < error  statusCode ="403"  redirect ="NoAccess.htm"   />
             < error  statusCode ="404"  redirect ="FileNotFound.htm"   />
         </ customErrors >
     </ system.web >
</ configuration >

五、对象的CRUD操作。类ActiveRecordBas中定义了许多静态方法用于对象的CRUD操作，如：Create、Delete、DeleteAll、FindAll、FindAllByProperty、FindByPrimaryKey、Save等等一些静态方法。
　　１．Create操作

User objUser  =   new  User();
objUser.Name  =   " jailu " ;
objUser.Password  =   " 123456789 " ;

objUser.Create();

　　２．Read操作

User objUser  =  User.Find( 1 );     // 检索主键ＩＤ为1的User对象
string  strName  =  objUser.Name;
string  strPassword  =  objUser.Password;

　　３．Update操作

User objUser  =  User.Find( 1 );     // 检索主键ＩＤ为1的User对象
objUser.Name  =   " EmmaLee " ;
objUser.Password  =   " 987654321 " ;

objUser.Update();

　　４．Delete操作

 User objUser  =  User.Find( 1 );     // 检索主键ＩＤ为1的User对象

objUser.Delete();

　　５．完整的User类代码：

using  System;
using  System.Collections.Generic;
using  System.Text;
using  System.Collections;

using  Castle.ActiveRecord;
using  Castle.ActiveRecord.Queries;

namespace  CastleTest
{
    //为User类添加特性，其实就是告诉ActiveRecord，User类所对应的数据库中的数据表名为Users
    [ActiveRecord("Users")]
    public class User : ActiveRecordBase
    {
        private int _id;
        private string _name;
        private string _password;

        //[PrimaryKey]特性指定Id作为主键
        //用PrimaryKeyType.Identity来说明了主键的类型为自增型的
        [PrimaryKey(PrimaryKeyType.Identity, "ID")]
        public int Id
        {
            get { return _id; }
            set { _id = value; }
        }

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

        //若属性名与列名一致可省略不写
        [Property]
        public string Password
        {
            get { return _password; }
            set { _password = value; }
        }

        public static void DeleteAll()
        {
            
            DeleteAll(typeof(User));
        }

        public static IList FindAll()
        {
            return (IList)FindAll(typeof(User));
        }

        public static User Find(int id)
        {
            return (User)FindByPrimaryKey(typeof(User), id);
        }

        /**//// <summary>
        /// 根据LogonName查询User对象，在测试HQL查询时用到
        /// </summary>
        /// <param name="LogonName">登录名</param>
        /// <returns>User对象数组</returns>
        public static User[] GetUsersByLogonName(string LogonName)
        {
            SimpleQuery query = new SimpleQuery(typeof(User),@"from User user where user.Name = ?",LogonName);

            return (User[])ExecuteQuery(query);
        }
    }
}

六、表示层调用：

private   void  button1_Click( object  sender, EventArgs e)
{
    //初始化，获取连接字符串等信息
    IConfigurationSource source = System.Configuration.ConfigurationSettings.GetConfig("activerecord") as IConfigurationSource;
    ActiveRecordStarter.Initialize(source, typeof(User));

    User objUser = new User();
    objUser.Name = "jailu";
    objUser.Password = "123456789";

    objUser.Create();
}

至此，ActiveRecord的初步接触就算是完成了。

转载于:https://www.cnblogs.com/jailu/archive/2006/08/29/488957.html