Spring.Net&NHibernate 学习 4

第一个NHibernate 程序

任何熟悉Hibernate的人会发现这篇指南和Glen Smith 的 A Hitchhiker's Guide to Hibernate 非常相近。这里的内容正是基于他的指南，因此所有的感谢都应该给与他。

 

NHibernate的文档并非每处都和Hibernate的文档一致。然而，项目的相似应该能使读者通过读Hibernate的文档来很好的理解NHibernate如何工作。

 

这篇文档意在让你尽可能快的开始使用NHibernate。它将介绍如何持久化一个简单的对象到一张表里。想得到更多的复杂的例子，可以参考NUnit测试及附带代码。

我们将进行以下步骤。

1．新建一个将要持久化.Net对象的表

2．构建一个可以让NHibernate知道如何持久化对象属性的映射文件

3．构建一个需要被持久化的.Net类

4．构建一个存放NHibernater的配置文件的对像

5．使用NHibernate的API测试你的第一个NHibernate程序

 

n        新建项目

项目名称为：NHibernateSample，名字空间：OKEC.Sample.NHibernate

n        建立数据表

数据库为SQLServer2000，表名为：my_users

if exists (select * from dbo.sysobjects where id = object_id(N'[dbo].[my_users]') and OBJECTPROPERTY(id, N'IsUserTable') = 1)     drop table [dbo].[my_users]     GO     CREATE TABLE [dbo].[my_users] (     [LogonId] [varchar] (50) COLLATE Chinese_PRC_CI_AS NOT NULL ,     [UserName] [varchar] (50) COLLATE Chinese_PRC_CI_AS NULL ,     [Password] [varchar] (50) COLLATE Chinese_PRC_CI_AS NULL ,     [EmailAddress] [varchar] (50) COLLATE Chinese_PRC_CI_AS NULL ,     [LastLogon] [datetime] NULL     ) ON [PRIMARY]     GO     ALTER TABLE [dbo].[my_users] ADD     CONSTRAINT [PK_my_users] PRIMARY KEY  CLUSTERED     (     [LogonId]     )  ON [PRIMARY]     GO

 

n        建立XML对像映射文件

现在我们有数据表和需要去映射它的.Net类。我们需要一种方式去让NHibernate知道如何从一个映射到另一个。这个任务依赖于映射文件来完成。最易于管理的办法是为每一个类写一个映射文件，如果你命名它是User.hbm.xml并且把它放在和类的同一个目录里，NHiberante将会使得事情简单起来。下面是User.hbm.xml的例子：

<?xml version="1.0" encoding="utf-8" ?> <hibernate-mapping xmlns="urn:nhibernate-mapping-2.0">     <class name=" OKEC.Sample.NHibernate.NHibernateTest.User,NHibernateSample" table="my_users">         <id name="Id" column="LogonId" type="String" length="20">         <generator class="assigned" />         </id>                <property name="UserName" column="UserName" type="String" length="40"/>         <property name="Password" column="Password" type="String" length="20"/>         <property name="EmailAddress" column="EmailAddress" type="String" length="40"/>         <property name="LastLogon" column="LastLogon" type="DateTime"/>     </class> </hibernate-mapping>

注意事项：在Visual Studio 2003/2005中要将此文件的属性设置为“嵌入的资源”（Embedded Resource）

n        建立对像

对像定义：User.cs

using System; namespace OKEC.Sample.NHibernate.NHibernateTest {     /// <summary>     /// Summary description for User.     /// </summary>     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; }         }     } }

 

n        编写Nhibernate的初始化配置程序

程序名：MyConfiguration.cs

using System; using NHibernate.Cfg; namespace OKEC.Sample.NHibernate.NHibernateTest {     /// <summary>     /// MyConfiguration 的摘要说明。     /// </summary>     public class MyConfiguration     {         public MyConfiguration()         {               //               // TODO: 在此处添加构造函数逻辑               //         }         public Configuration GetConfig()         {               try               {                   Configuration cfg = new Configuration();              cfg.SetProperty("hibernate.connection.provider","NHibernate.Connection.DriverConnectionProvider");                   //请修改此行中的SQLServer的配置                   cfg.SetProperty("hibernate.connection.connection_string","Data Source=192.168.88.15;Database=liluhua;User ID=sa;Password=sa;Trusted_Connection=False");                   cfg.SetProperty("hibernate.dialect","NHibernate.Dialect.MsSql2000Dialect");                   cfg.SetProperty("hibernate.connection.driver_class","NHibernate.Driver.SqlClientDriver");                   cfg.AddAssembly("NHibernateSample");                   return cfg;               }               catch(Exception ex)               {                   Console.WriteLine(ex.Message);                   Console.WriteLine(ex.StackTrace);               }               return null;         }     } }

n        编写调用程序

准备好上面的一切，我们就可以开始编辑启动程序，来测试你的第一个Nhibernate程序了。

程序名：UserFixture.cs

using System; using System.Collections; using NHibernate; using NHibernate.Cfg; using NHibernate.Expression; namespace OKEC.Sample.NHibernate.NHibernateTest {     /// <summary>     /// UserFixture 的摘要说明。     /// </summary>     public class UserFixture     {         public UserFixture()         {               //               // TODO: 在此处添加构造函数逻辑               //         }         public void ValidateQuickStart()         {               try               {                   //得到NHibernate的配置                   MyConfiguration config = new MyConfiguration();                   Configuration cfg = config.GetConfig();                     ISessionFactory factory = cfg.BuildSessionFactory();                   ISession session = factory.OpenSession();                   ITransaction transaction = session.BeginTransaction();                     User newUser = null;                   try                   {                       newUser = (User)session.Load(typeof(User), "joe_cool");                   }                   catch                   {                   }                   if(newUser==null)                   {                       newUser = new User();                       newUser.Id = "joe_cool";                       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();                     // open another session to retrieve the just inserted user                   session = factory.OpenSession();                     User joeCool = (User)session.Load(typeof(User), "joe_cool");                     // set Joe Cool's Last Login property                   joeCool.LastLogon = DateTime.Now;                     // flush the changes from the Session to the Database                   session.Flush();                     IList recentUsers = session.CreateCriteria(typeof(User))                       .Add(Expression.Gt("LastLogon", new DateTime(2004, 03, 14, 20, 0, 0)))                       .List();                   foreach(User user in recentUsers)                   {                       //Assert.IsTrue(user.LastLogon > (new DateTime(2004, 03, 14, 20, 0, 0)) );                       Console.WriteLine(user.UserName);                       Console.WriteLine(user.Password);                   }                   session.Close();               }               catch(Exception ex)               {                   Console.WriteLine(ex.Message);                   Console.WriteLine(ex.StackTrace);               }               Console.ReadLine();         }     } }

n        测试你的程序

如果运行后没有出错，显示了结果，说明你的第一个NHibernate程序成功了。

Joseph Cool abc123