我们至今还没有告诉NHibernate 去哪里连接数据库。最直接的办法是在你的应用程序的配置文件里设置一个NHibernate配置节。这和在Hibernate里使用属性文件是等价的。如下配置:
<? xml version="1.0" encoding="utf-8" ?>
< configuration >
< configSections >
< section name ="nhibernate" type ="System.Configuration.NameValueSectionHandler, System, Version=1.0.3300.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;initialecatalog=nhibernate;Integrated Security=SSPI"
/>
</ nhibernate >
</ configuration >
上面的例子里用了SqlClient 驱动,在本地连接名称为NHibernate 的数据库,提供用户名和密码。那里有一堆属性你需要调整来确定如何让NHibernate来访问数据库。再次说明,你可以在文档里获取更多信息。
请注意以上的配置里并没有涉及到log4net的配置信息。NHibernate使用log4net来记录内部发生的一切。在一个应用程序产品里,在你特定环境里,我推荐配置log4net,并为NHibernate设置一定的日志级别。
第五步:开始展现NHibernate的魔力
所有艰苦的工作已经完成。你将有以下内容
User.cs ----你需要持久化的C#类
User.hbm.xml ----你的NHibernate映射文件
App.config ---对ADO.NET连接的配置信息(如果你愿意,你可以在代码中实现)。
你的数据库里有一张User表。
现在可以在你的代码中恰当简洁的使用NHibernate。简化的版本如下
创建一个Configuration对象
让Configuration知道你将存储何种类型的对象
为你选择的数据库创建一个Session对象
Load,Save和Query你的对象
通过Session的Flush()方法将对象提交给数据库。
为了让你更清晰,我们来看一些代码。
首先,创建一个Configuration对象
Configuration对象能够解析所有.Net对象和后台数据库中的映射关系。
Configuration cfg = new Configuration();
cfg.AddAssembly( " NHibernate.Examples " );
Configuration对象会搜索装配件里的任何以hbm.xml 结尾的文件。还有其他方法加载映射文件,但这种方式是最简单的。
下一步,创建一个Session对象ISession对象提供一个到后台数据库的连接,ITransaction对象提供一个可以被NHibernate管理的事务。
ISessionFactory factory = cfg.BuildSessionFactory();
ISession session = factory.OpenSession();
ITransaction transaction = session.BeginTransaction();
接着来Load, Save和Query你的对象
现在你可以用使用传统的.Net方法来操纵对象。你想保存一个新对象到数据库吗?尝试下面的方法:
User newUser = new User();
newUser.Id = " kim_cool " ;
newUser.UserName = " kimCool " ;
newUser.Password = " abc123 " ;
newUser.EmailAddress = " kim@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();
正如你所看到的,关于NHiberante重要的事情是如此简单。继续并且查询你的数据库,验证一下User表里的新记录。现在重要的事情就是你去操心业务对象并在进行处理的时候告诉NHibernate就可以了。
让我们来告诉你,当你有一个UserID的时候如何获取对象(举例说,登陆你的网站的时候)。仅仅一句话就可以打开Session,传入key就可以了
session = factory.OpenSession();
User kimCool = (User)session.Load( typeof (User), " kim_cool " );
你所获取的User对象还在生存周期内!改变它的属性,并通过Flush()持久化到数据库。
// set kim Cool's Last Login property
kimCool.LastLogon = DateTime.Now;
// flush the changes from the Session to the Database
session.Flush();
你所要做的就是通过NHibernate来进行你需要的改变,并调用Session的Flush()方法提交。验证一下数据库,查查用户ID为”kim_cool”的记录中”LastLogon”的更改。
还有更好的,你可以以System.Collections.IList的方式来获取从表中的对象。如下
IList userList = session.CreateCriteria( typeof (User)).List();
foreach (User user in userList)
{
System.Diagnostics.Debug.WriteLine(user.Id + " last logged in at " + user.LastLogon);
}
这个查询将会返回所有表记录。往往你需要做更多的控制,比如说获取从8/19/ 2006 10:00 PM 以后登陆的用户,如下:
IList recentUsers = session.CreateCriteria( typeof (User))
.Add(Expression.Expression.Gt( " LastLogon " , new DateTime( 2006 , 08 , 19 , 20 , 0 , 0 )))
.List();
foreach (User user in recentUsers)
{
System.Diagnostics.Debug.WriteLine(user.Id + " last logged in at " + user.LastLogon);
}
文档里还有一堆健壮的查询方式让你调用,这里仅仅让你对NHibernate所提供的强有力的工具有一定的了解。
最后调用Session对象的Close()方法,释放NHibernate所使用的ADO.Net连接资源
session.Close();
更确切地说…
你已经完成创建对象,持久化并通过条件查询或键值查询来返回它。相信你已经从中获得快乐。