nhibernate指南Word文档下载推荐.docx
《nhibernate指南Word文档下载推荐.docx》由会员分享，可在线阅读，更多相关《nhibernate指南Word文档下载推荐.docx（9页珍藏版）》请在冰豆网上搜索。
这里我们将使用的是一个非常简单的例子。
假设你正在为你的网站开发一个基本的用户管理子系统。
我们将使用如下的一张User表（假定你已经设置好一个数据库—在的例子里我称它为NHibernate）。
useNHibernate
go
CREATE
TABLEusers（
LogonIDnvarchar（20）NOT
NULL
default´
0´
Namenvarchar（40）default
NULL,
Passwordnvarchar（20）default
EmailAddressnvarchar（40）default
LastLogondatetime
default
PRIMARY
KEY（LogonID）
）
我使用的是MSSqlServer2000,但也可以使用任何数据库，只要你有关于它们的基于.Net数据提供驱动程序。
我们将得到一个含有LogonID,Name,Password,Email和LastLogon的表.经过以上标准步骤，我们下一步是写一个.Net类处理一个给定的User对象。
第二步:
产生一个.Net类文件
当内存中有一堆User对象的时候，我们需要某种对象去保存它们。
NHibernate通过对象属性的反射来工作，因此我们需要添加我们希望持久化的对象属性。
一个可以被NHibernate持久化的类应该看起来象下面的样子：
usingSystem;
namespaceNHibernate.Demo.QuickStart
{
public
classUser
private
stringid;
stringuserName;
stringpassword;
stringemailAddress;
privateDateTimelastLogon;
publicUser（）
}
stringId
get{returnid;
}
set{id=value;
stringUserName
get{returnuserName;
set{userName=value;
stringPassword
get{returnpassword;
set{password=value;
stringEmailAddress
get{returnemailAddress;
set{emailAddress=value;
publicDateTimeLastLogon
get{returnlastLogon;
set{lastLogon=value;
在上面的例子里，我们的属性和构建函数是public，但这个对NHibernate不是必要的.它可以使用public,protected,internal或者甚至是用private来持久化数据。
第三步：
写映射文件
现在我们有数据表和需要去映射它的.Net类。
我们需要一种方式去让NHibernate知道如何从一个映射到另一个。
这个任务依赖于映射文件来完成。
最易于管理的办法是为每一个类写一个映射文件，如果你命名它是YourObject.hbm.xml并且把它放在和类的同一个目录里，NHiberante将会使得事情简单起来。
下面是一个User.hbm.xml的例子：
<
?
xmlversion="
1.0"
encoding="
utf-8"
?
>
hibernate-mapping
xmlns="
urn:
nhibernate-mapping-2.0"
class
name="
NHibernate.Examples.QuickStart.User,NHibernate.Examples"
table="
users"
id
Id"
column="
LogonId"
type="
String"
length="
20"
generator
class="
assigned"
/>
/id>
property
UserName"
column="
Name"
40"
Password"
EmailAddress"
LastLogon"
DateTime"
/class>
/hibernate-mapping>
让我们来看看这个文件中让我们感兴趣的某些行。
第一个有趣的标签是class。
这里我们将映射类型名称（类名和装配件）到我们数据库中的User表，这里和Hibernate有一点点的不同。
你将不得不告诉NHibernate从何处提取对象。
在这个例子里我们从装配件NHibernate.Examples装载类
NHibernate.Examples.QuickStart.User。
NHibernate遵循和.NetFramework同样的规则来加载类型。
因此如果你在如何指定类型的方面有些混淆，请参看.NetFrameworkSDK。
让我们先跳过id标签，来讨论property标签。
简要看一下，你将发现NHibernate所要做的工作。
name属性的值正是我们.Net类的属性，column属性值将是我们数据库里的字段。
type属性是可选的（如果你不标明，NHibernate将利用反射进行最佳的推测）。
好了，让我们回到标签id,你可以猜测到这个标签将是映射数据库表的主键，的确如此，id标签的组成和我们刚才看的property标签是相似的。
我们映射属性到目标数据库的字段。
内嵌的generator标签告诉NHibernate如何生成主键（它将恰当的为你生成主键，不管你指定何种类型，但你必须告诉它）。
在我们的例子里，我们设定为assigned,意味着我们对象将自己生成主键（毕竟User对象常常需要一个UserID）。
如果你执意要NHiberante为你生成主键，你感兴趣于设定uuid.hex和uuid.string（从文档中获取更多信息）
提示：
如果你使用VisualStudio.Net去编译的话，请将user.hbm.xml的BuildAction属性设置为EmbeddedResource。
映射文件将成为装配件的一部分。
更详细的细节重点将在后面展示。
如果你仅仅是改变映射文件，你不能使用build而应该Rebuild项目。
VisualStudio.Net不会重新编译有改变的映射文件。
第四步：
为你的数据库产生一个配置文件
我们至今还没有告诉NHibernate去哪里连接数据库。
最直接的办法是在你的应用程序的配置文件里设置一个NHibernate配置节。
这和在Hibernate里使用属性文件是等价的。
如下配置：
configuration>
configSections>
section
nhibernate"
System.Configuration.NameValueSectionHandler,System,Version=1.0.3300.0,Culture=neutral,PublicKeyToken=b77a5c561934e089"
/configSections>
nhibernate>
add
key="
hibernate.connection.provider"
value="
NHibernate.Connection.DriverConnectionProvider"
hibernate.dialect"
NHibernate.Dialect.MsSql2000Dialect"
hibernate.connection.driver_class"
NHibernate.Driver.SqlClientDriver"
hibernate.connection.connection_string"
Server=localhost;
initialcatalog=nhibernate;
IntegratedSecurity=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。
简化的版本如下
1.创建一个Configuration对象
2.让Configuration知道你将存储何种类型的对象
3.为你选择的数据库创建一个Session对象
4.Load，Save和Query你的对象
5.通过Session的Flush（）方法将对象提交给数据库。
为了让你更清晰，我们来看一些代码。
首先，创建一个Configuration对象
Configuration对象能够解析所有.Net对象和后台数据库中的映射关系。
Configurationcfg=newConfiguration（）;
cfg.AddAssembly（"
NHibernate.Examples"
）;
Configuration对象会搜索装配件里的任何以hbm.xml结尾的文件。
还有其他方法加载映射文件，但这种方式是最简单的。
下一步，创建一个Session对象
ISession对象提供一个到后台数据库的连接，ITransaction对象提供一个可以被NHibernate管理的事务。
ISessionFactoryfactory=cfg.BuildSessionFactory（）;
ISessionsession=factory.OpenSession（）;
ITransactiontransaction=session.BeginTransaction（）;
接着来Load,Save和Query你的对象
现在你可以用使用传统的.Net方法来操纵对象。
你想保存一个新对象到数据库吗？
尝试下面的方法：
UsernewUser=newUser（）;
newUser.Id="
joe_cool"
;
newUser.UserName="
JosephCool"
newUser.Password="
abc123"
newUser.EmailAddress="
joe@"
newUser.LastLogon=DateTime.Now;
//TellNHibernatethatthisobjectshouldbesaved
session.Save（newUser）;
//commitallofthechangestotheDBandclosetheISession
transaction.Commit（）;
session.Close（）;
正如你所看到的，关于NHiberante重要的事情是如此简单。
继续并且查询你的数据库，验证一下User表里的新记录。
现在重要的事情就是你去操心业务对象并在进行处理的时候告诉NHibernate就可以了。
让我们来告诉你，当你有一个UserID的时候如何获取对象（举例说，登陆你的网站的时候）。
仅仅一句话就可以打开Session，传入key就可以了
//openanothersessiontoretrievethejustinserteduser
session=factory.OpenSession（）;
UserjoeCool=（User）session.Load（typeof（User）,"
你所获取的User对象还在生存周期内！
改变它的属性，并通过Flush（）持久化到数据库。
//setJoeCool´
sLastLoginproperty
joeCool.LastLogon=DateTime.Now;
//flushthechangesfromtheSessiontotheDatabase
session.Flush（）;
你所要做的就是通过NHibernate来进行你需要的改变，并调用Session的Flush（）方法提交。
验证一下数据库，查查用户ID为”joe_cool”的记录中”LastLogon”的更改。
还有更好的，你可以以System.Collections.IList的方式来获取从表中的对象。
如下
IListuserList=session.CreateCriteria（typeof（User））.List（）;
foreach（UseruserinuserList）{System.Diagnostics.Debug.WriteLine（user.Id"
lastloggedinat"
user.LastLogon）;
}这个查询将会返回所有表记录。
往往你需要做更多的控制，比如说获取从March14,200410:
00PM 以后登陆的用户，如下：
IListrecentUsers=session.CreateCriteria（typeof（User））
.Add（Expression.Expression.Gt（"
newDateTime（2004,03,14,20,0,0）））
.List（）;
foreach（UseruserinrecentUsers）
{
System.Diagnostics.Debug.WriteLine（user.Id"
}
文档里还有一堆健壮的查询方式让你调用，这里仅仅让你对NHibernate所提供的强有力的工具有一定的了解。
最后调用Session对象的Close（）方法，释放NHibernate所使用的ADO.Net连接资源
//tellNHibernatetoclosethisSession
更确切地说
…
你已经完成创建对象，持久化并通过条件查询或键值查询来返回它。
相信你已经从中获得快乐。
现在你对NHibernate有了大致的了解，如果你能仔细阅读大量来自Hibernate2.0.3文档,你将获得帮助（NHibernate文档还在早期阶段，现在还仅仅是对Hibernate的拷贝）。
Enjoy!
AndHappyNHibernating!
MikeDoerfler
再次说明，所有的权利来自GlenSmith的AHitchhiker´
sGuidetoHibernate
Translatedby:
JasonXie
Published:
2005-02-24
升级会员 