测试环境：单机安装Win2003SP2 + SQL2000 + .NET2.0 + VS2005
一、下载安装NHibernate
下载地址：http://sourceforge.net/project/showfiles.php?group_id=73818
运行安装程序NHibernate-1.2.1.GA.msi，默认情况下“C:"Program Files"NHibernate”目录下。
二、准备数据库
1．在SQL Server2000下创建NHibernate数据库；
2．执行如下SQL语句创建数据表users：
use NHibernate go CREATE TABLE users ( LogonID nvarchar(20) NOT NULL default '0', Name nvarchar(40) default NULL, Password nvarchar(20) default NULL, EmailAddress nvarchar(40) default NULL, LastLogon datetime default NULL, PRIMARY KEY (LogonID) ) go |
三、开发程序
1．在VS2005中新建类库项目NHibernate.Examples，同时选中“创建解决方案目录”复选框。
<?XML:NAMESPACE PREFIX = V /> 2．在NHibernate.Examples类库项目创建类文件User.cs，内容如下。（注：一个User对象对应数据表users中的一条记录。）
using System; namespace NHibernate.Examples.QuickStart { public class User { private string id; private string userName; private string password; private string emailAddress; private DateTime lastLogon; public User() { } public string Id { get { return id; } set { id = value; } } public string UserName { get { return userName; } set { userName = value; } } public string Password { get { return password; } set { password = value; } } public string EmailAddress { get { return emailAddress; } set { emailAddress = value; } } public DateTime LastLogon { get { return lastLogon; } set { lastLogon = value; } } } } |
3．在NHibernate.Examples类库项目创建映射文件User.hbm.xml，并将文件的“生成操作”属性设置为“嵌入的资源”（如图），映射文件将成为装配件的一部分。
<?xml version="1.0" encoding="utf-8" ?> |
让我们来看看User.hbm.xml文件中让我们感兴趣的某些行。第一个有趣的标签是class。这里我们将映射类型名称(类名和装配件)到我们数据库中的User表，这里和Hibernate有一点点的不同。你将不得不告诉NHibernate从何处提取对象。在这个例子里我们从装配件NHibernate.Examples装载类NHibernate.Examples.QuickStart.User 。NHibernate 遵循和.Net Framework同样的规则来加载类型。因此如果你在如何指定类型的方面有些混淆，请参看.Net Framework SDK。
让我们先跳过id标签，来讨论property标签。简要看一下，你将发现NHibernate所要做的工作。name属性的值正是我们.Net 类的属性，column属性值将是我们数据库里的字段。type属性是可选的（如果你不标明，NHibernate将利用反射进行最佳的推测）。
好了，让我们回到标签id, 你可以猜测到这个标签将是映射数据库表的主键，的确如此，id标签的组成和我们刚才看的property标签是相似的。我们映射属性到目标数据库的字段。
内嵌的generator 标签告诉NHibernate 如何生成主键（它将恰当的为你生成主键，不管你指定何种类型，但你必须告诉它）。在我们的例子里，我们设定为assigned,意味着我们对象将自己生成主键（毕竟User对象常常需要一个UserID）。如果你执意要NHiberante为你生成主键，你感兴趣于设定uuid.hex和uuid.string（从文档中获取更多信息）
提示：如果你仅仅是改变映射文件，你不能使用build 而应该Rebuild项目。Visual Studio.Net 不会重新编译有改变的映射文件。
4．新建一个Windows应用程序项目NHibernateQuickStart，并添入已有的解决方案。
5．在项目NHibernateQuickStart中添加对NHibernate.dll的引用（默认安装情况下在“C:"Program Files"NHibernate"bin"net-2.0"NHibernate.dll”）。
6．在项目NHibernateQuickStart中添加对NHibernate.Examples类库项目的引用:
7. 在项目NHibernateQuickStart中添加应用程序配置文件App.config，内容如下：(告诉NHibernate 去哪里连接数据库以及数据库的相关配置)
<?xml version="1.0" encoding="utf-8" ?> <configuration> <configSections> <section name="nhibernate" type="System.Configuration.NameValueSectionHandler, System, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" /> </configSections> <nhibernate> <add key="hibernate.connection.provider" value="NHibernate.Connection.DriverConnectionProvider" /> <add key="hibernate.dialect" value="NHibernate.Dialect.MsSql2000Dialect" /> <add key="hibernate.connection.driver_class" value="NHibernate.Driver.SqlClientDriver" /> <add key="hibernate.connection.connection_string" value="Server=localhost;initial catalog=nhibernate;Integrated Security=SSPI" /> </nhibernate> </configuration> |
8．开始编写写入数据的代码。
（1）在项目NHibernateQuickStart中Form1窗体上添一个按钮button1，双击button1进入代码编辑界面，我们将在button1_Click事件中编写代码。
（2）在代码中添加using声明：
using NHibernate; using NHibernate.Cfg; using NHibernate.Examples.QuickStart; |
（3）button1_Click事件代码如下：
private void button1_Click(object sender, EventArgs e) { Configuration cfg = new Configuration(); cfg.AddAssembly("NHibernate.Examples"); ISessionFactory factory = cfg.BuildSessionFactory(); ISession session = factory.OpenSession(); ITransaction transaction = session.BeginTransaction(); User newUser = new User(); newUser.Id = "joe_cool_test"; newUser.UserName = "Joseph Cool"; newUser.Password = "abc123"; newUser.EmailAddress = "joe@cool.com"; newUser.LastLogon = DateTime.Now; // Tell NHibernate that this object should be saved session.Save(newUser); // commit all of the changes to the DB and close the ISession transaction.Commit(); session.Close(); } |
（4）编译整个解决方案。执行生成的EXE文件NHibernateQuickStart.exe，点击button1。之后，打开数据库users表，如果产生了一条记录，则成功！
本项目源码下载：NHibernateQuickStart1.rar
===================================================================================
另外，本人还写了一个复杂点的示例，包含了增加、修改、删除、显示记录的操作:
源码下载：NHibernateQuickStart2.rar。看了这个代码你会发现项目中充斥了如下类似的代码：
Configuration cfg = new Configuration(); cfg.AddAssembly("NHibernate.Examples"); ISessionFactory factory = cfg.BuildSessionFactory(); ISession session = factory.OpenSession(); ITransaction transaction = session.BeginTransaction(); |
如何解决这个问题呢?以后再探讨吧J
===================================================================================
推荐阅读《Hibernate Quickly中文版》一书，虽然是针对Java的，但是思想是相通的，NHibernate本源于Hibernate，看了之后会Hibernate有全面深入的认识。
其它资料：
Hibernate官方网站：http://www.hibernate.org
NHibernate论坛：http://www.okec.cn
renrenqq的blog(有丰富的ORM资料)：http://www.cnblogs.com/renrenqq
（注：本人参考NHibernate官方快速指南未能测试成功，后整理本篇文档，参考了译文：http://www.okec.cn/htm_data/7/0709/194.html）
=====================================================================================================
参考NHibernate官方快速指南编写代码遇到的问题：
From:http://hi.baidu.com/zsea/blog/item/7d999e3d8a54c203baa1678d.html
一、Test.Model.Person.hbm.xml(2,2): XML validation error: 未能找到元素“urn:nhibernate-mapping-2.0:hibernate-mapping”的架构信息。
将2.0改为2.2
二、 The following types may not be used as proxies:
Test.Model.Person: method set_Id should be virtual
Test.Model.Person: method get_Name should be virtual
Test.Model.Person: method set_Name should be virtual
Test.Model.Person: method get_Id should be virtual
类配置文件中Class的Lazy改为false
网上搜到的三种解决方案：
1. You can follow the advice of the exception and add "virtual" to all of your properties, and make sure your class is non-sealed. Obviously you'll want to do this if you think you might want to take advantage of the lazy-initializing proxy feature. However, changing your classes may not be practical or advisable if you have a legacy codebase, or it may just bother you that a "transparent" persistence framework is dictating how you design certain aspects of your value classes. That's where Options 2 and 3 come in. Both of those involve changing back to the old behavior.
name="NorthwindClasses.Category, NorthwindClasses"
table="Categories"
lazy="false"
>
