最新NHibernate中文文档.docx
《最新NHibernate中文文档.docx》由会员分享,可在线阅读,更多相关《最新NHibernate中文文档.docx(56页珍藏版)》请在冰豆网上搜索。
最新NHibernate中文文档
第1章NHibernate体系结构
总览
对NHibernate体系结构的非常高层的概览:
这幅图展示了NHibernate使用数据库和配置文件数据来为应用程序提供持久化服务(和持久化的对象)。
我们试图显示更多NHibernate运行时体系结构的细节。
但挺不幸的,NHibernate是比较灵活的并且提供了好几种不同的运行方式。
我们展示一下两种极端情况。
轻型体系中,应用程序自己提供ADO.NET连接,并且自行管理事务。
这种方式使用了NHibernateAPI的一个最小子集。
全面解决体系中,对于应用程序来说,所有的底层ADO.NETAPI都被抽象了,NHibernate会替你照管所有的细节。
下面是图中一些对象的定义:
SessionFactory(NHibernate.ISessionFactory)
对属于单一数据库的编译过的映射文件的一个线程安全的,不可变的缓存快照。
它是Session的工厂,是ConnectionProvider的客户。
可以持有一个可选的(第二级)数据缓存,可以在进程级别或集群级别保存可以在事物中重用的数据。
会话Session(NHibernate.ISession)
单线程,生命期短促的对象,代表应用程序和持久化层之间的一次对话。
封装了一个ADO.NET连接。
也是Transaction的工厂。
保存有必需的(第一级)持久化对象的缓存,用于遍历对象图,或者通过标识符查找对象。
持久化对象(Persistent)及其集合(Collections)
生命期短促的单线程的对象,包含了持久化状态和商业功能。
它们可能是普通的对象,唯一特别的是他们现在从属于且仅从属于一个Session。
一旦Session被关闭,他们都将从Session中取消联系,可以在任何程序层自由使用(比如,直接作为传送到表现层的DTO,数据传输对象)。
临时对象(TransientObject)及其集合(Collection)
目前没有从属于一个Session的持久化类的实例。
他们可能是刚刚被程序实例化,还没有来得及被持久化,或者是被一个已经关闭的Session所实例化的。
事务Transaction(NHibernate.ITransaction)
(可选)单线程,生命期短促的对象,应用程序用它来表示一批工作的原子操作。
是底层的ADO.NET事务的抽象。
一个Session某些情况下可能跨越多个Transaction事务。
ConnectionProvider(NHibernate.Connection.ConnectionProvider)
(可选)ADO.NET连接的工厂。
从底层的IDbConnection抽象而来。
对应用程序不可见,但可以被开发者扩展/实现。
TransactionFactory(net.sf.hibernate.TransactionFactory)
(可选)事务实例的工厂。
对应用程序不可见,但可以被开发者扩展/实现。
在上面的轻型结构中,程序没有使用Transaction/TransactionFactory或ConnectionProviderAPI,直接和ADO.NET对话了。
第2章ISessionFactory配置
可编程配置方式
获取ISessionFactory
用户自行提供ADO.NET连接
NHibernate提供ADO.NET连接
可选配置属性
SQL方言(SQLDialects)
外连接抓取(OuterJoinFetching)
自定义CacheProvider
查询语言替换
Logging
因为NHibernate被设计为可以在许多不同环境下工作,所以它有很多配置参数。
幸运的是,大部分都已经有默认值了。
NHibernate.Test.dll包含了一个示例的配置文件app.config,它演示了一些可变的参数。
可编程配置方式
NHibernate.Cfg.Configuration的一个实例代表了应用程序中所有的.NET类到SQL数据库的映射的集合。
Configuration用于构造一个(不可变的)ISessionFactory。
这些映射是从一些XML映射文件中编译得来的。
你可以得到一个Configuration的实例,直接实例化它即可。
下面有一个例子,用来从两个XML配置文件(和exe文件在同一个目录下)中的映射中初始化:
Configurationcfg=newConfiguration()
.AddXmlFile("Item.hbm.xml")
.AddXmlFile("Bid.hbm.xml");
另外一个(某些时候更好的)方法是让NHibernate自行用GetManifestResourceStream()来装载映射文件
Configurationcfg=newConfiguration()
.AddClass(typeof(NHibernate.Auction.Item))
.AddClass(typeof(NHibernate.Auction.Bid));
NHibernate就会在这些类型的程序集的嵌入的资源中寻找叫做NHibernate.Auction.Item.hbm.xml和NHibernate.Auction.Bid.hbm.xml的映射文件。
这种方法取消了所有对文件名的硬编码。
另外一个(可能是最好的)方法是让NHibernate读取一个程序集中所有的配置文件:
Configurationcfg=newConfiguration()
.AddAssembly("NHibernate.Auction");
NHibernate将会遍历程序集查找任何以hbm.xml结尾的文件。
这种方法取消了所有对文件名的硬编码并且确保程序集中的配置文件文件都会被加载。
在使用VisualStudio.NET或者NAnt生成程序集时请确保hbm.xml文件是作为嵌入资源(EmbeddedResources)添加的。
Configuration也可以指定一些可选的配置项
Hashtableprops=newHashtable();
...
Configurationcfg=newConfiguration()
.AddClass(typeof(NHibernate.Auction.Item))
.AddClass(typeof(NHibernate.Auction.Bid));
cfg.Properties=props;
Configuration是仅在配置期使用的对象,从第一个SessionFactory开始建立的时候,它就失效了。
获取ISessionFactory
当所有的映射都被Configuration解析之后,应用程序为了得到ISession实例,必须先得到它的工厂。
这个工厂应该是被应用程序的所有线程共享的:
ISessionFactorysessions=cfg.BuildSessionFactory();
当然,NHibernate并不禁止你的程序实例化多个ISessionFactory。
在你使用不止一个数据库的时候,这就有用了。
用户自行提供ADO.NET连接
ISessionFactory可以使用一个用户自行提供的ADO.NET连接来打开一个ISession。
这种设计可以让应用程序来自己管理ADO.NET连接:
IDbConnectionconn=myapp.GetOpenConnection();
ISessionsession=sessions.OpenSession(conn);
//dosomedataaccesswork
应用程序必须小心,不能在同一个连接上打开两个并行的ISession!
NHibernate提供ADO.NET连接
另一种方法就是,你可以让ISessionFactory替你打开连接。
SessionFactory必须事先知道ADO.NET连接的参数,有几种不同的方法设置参数:
1.通过提供一个IDictionary实例给Configuration.Properties。
2.在名为nhibernate的System.Configuration.NameValueSectionHandler类型的配置节点添加属性。
3.在hibernate.cfg.xml中包含元素。
如果你使用这种方法,打开一个ISession是非常简单的:
ISessionsession=sessions.OpenSession();//openanewSession
//dosomedataaccesswork,anADOconnectionwillbeusedondemand
所有的NHibernate属性名和约束都在NHibernate.Cfg.Environment类中定义。
我们讨论一下ADO.NET连接配置最重要的几项设置:
假若你设置了如下的属性,Hibernate会使用ADO.NETDataProvider来得到连接:
表2.1.NHibernateADO.NET属性
属性名
用途
hibernate.connection.provider_class
定制IConnectionProvider的类型.
例如:
full.classname.of.ConnectionProvider(如果提供者创建在NHibernate中),或者full.classname.of.ConnectionProvider,assembly(如果使用一个自定义的IConnectionProvider接口的实现,它不属于NHibernate)。
hibernate.connection.driver_class
定制IDriver的类型.
full.classname.of.Driver(如果驱动类创建在NHibernate中),或者full.classname.of.Driver,assembly(如果使用一个自定义IDriver接口的实现,它不属于NHibernate)。
hibernate.connection.connection_string
用来获得连接的连接字符串.
hibernate.connection.isolation
设置事务隔离级别.请检查System.Data.IsolationLevel来得到取值的具体意义并且查看数据库文档以确保级别是被支持的。
例如:
Chaos,ReadCommitted,ReadUncommitted,RepeatableRead,Serializable,Unspecified
下面是一个在web.config文件中指定连接属性的例子:
xmlversion="1.0"encoding="utf-8"?
>
Version=1.0.5000.0,Culture=neutral,PublicKeyToken=b77a5c561934e089"/>
key="hibernate.connection.provider"
value="NHibernate.Connection.DriverConnectionProvider"
/>
key="hibernate.connection.driver_class"
value="NHibernate.Driver.SqlClientDriver"
/>
key="hibernate.connection.connection_string"
value="Server=127.0.0.1;InitialCatalog=thedatabase;IntegratedSecurity=SSPI"
/>
key="hibernate.connection.isolation"
value="ReadCommitted"
/>
key="hibernate.dialect"
value="NHibernate.Dialect.MsSql2000Dialect"
/>
--log4net(requiredbyNHibernate)andotherappspecificconfigfollows-->
可选配置属性
下面是一些在运行时可以改变NHibernate行为的其他配置。
所有这些都是可选的,也有合理的默认值。
表2.2.NHibernate配置属性
属性名
用途
hibernate.dialect
NHibernate方言(Dialect)的类名-可以让NHibernate使用某些特定的数据库平台的特性
例如:
full.classname.of.Dialect(如果方言创建在NHibernate中),或者full.classname.of.Dialect,assembly(如果使用一个自定义的方言的实现,它不属于NHibernate)。
hibernate.default_schema
在生成的SQL中,scheml/tablespace的全限定名.
例如:
SCHEMA_NAME
hibernate.prepare_sql
是否准备sql语句
例如:
true|false
hibernate.session_factory_name
SessionFactory被创建后将自动绑定这个名称.
例如:
some.name
hibernate.use_outer_join
允许使用外连接抓取。
例如:
true|false
hibernate.cache.provider_class
指定一个自定义的CacheProvider缓存提供者的类名
例如:
full.classname.of.CacheProvider(如果ICacheProvider创建在NHibernate中),或full.classname.of.CacheProvider,assembly(如果使用一个自定义的ICacheProvider,它不属于NHibernate)。
hibernate.query.substitutions
把NHibernate查询中的一些短语替换为SQL短语(比如说短语可能是函数或者字符)。
例如:
hqlLiteral=SQL_LITERAL,hqlFunction=SQLFUNC
SQL方言(SQLDialects)
你总是可以为你的数据库设置一个hibernate.dialect方言,它是NHibernate.Dialect.Dialect的一个子类。
如果你不需要使用基于native或者sequence的主键自动生成算法,或者悲观锁定(使用ISession.Lock()或者IQuery.SetLockMode())的话,方言就可以不必指定。
然而,假若你指定了一个方言,Hibernate会为上面列出的一些属性使用特殊默认值,省得你手工指定它们。
表2.3.NHibernateSQL方言(hibernate.dialect)
RDBMS
方言
DB2
NHibernate.Dialect.DB2Dialect
PostgreSQL
NHibernate.Dialect.PostgreSQLDialect
MySQL
NHibernate.Dialect.MySQLDialect
Oracle(anyversion)
NHibernate.Dialect.OracleDialect
Oracle9/10g
NHibernate.Dialect.Oracle9Dialect
Sybase
NHibernate.Dialect.SybaseDialect
MicrosoftSQLServer2000
NHibernate.Dialect.MsSql2000Dialect
MicrosoftSQLServer7
NHibernate.Dialect.MsSql7Dialect
Firebird
NHibernate.Dialect.FirebirdDialect
外连接抓取(OuterJoinFetching)
如果你的数据库支持ANSI或者Oracle风格的外连接,外连接抓取可能提高性能,因为可以限制和数据库交互的数量(代价是数据库自身进行了更多的工作)。
外连接抓取允许你在一个SELECT语句中就可以得到一个由多对一或者一对一连接构成的对象图。
默认情况下,抓取在叶对象,拥有代理的对象或者产生对自身的引用时终止。
对一个特定关联来说,通过在XML映射文件中设置outer-join属性可以控制是否开启抓取功能。
设置hibernate.use_outer_join为false将禁用全局的外连接抓取.设置为true将启用所有一对一(one-to-one)和多对一(many-to-one)关联中的外连接抓取,默认情况下,它被设置为auto,即自动外连接。
但是,一对多关联和集合永远不会使用外连接抓取,除非对每个特定的关联进行明确声明。
这一行为可以在运行时通过NHibernate查询重载。
自定义CacheProvider
通过实现NHibernate.Cache.ICacheProvider接口,你可以整合一个第二级缓存进来。
你可以通过hibernate.cache.provider_class选择某个自定义的实现。
查询语言替换
你可以使用hibernate.query.substitutions定义新的NHibernate查询短语。
比如说:
hibernate.query.substitutionstrue=1,false=0
会在生成的SQL中把短语true和false替换成整数值。
hibernate.query.substitutionstoLowercase=LOWER
这可以让你重新命名SQL的LOWER函数。
Logging
通过Apachelog4net,NHibernate记录很多事件。
你可以从http:
//logging.apache.org/log4net/下载log4net.要使用log4net,你要在app.config或者web.config中配置log4net节点.在src/NHibernate.Test工程中有一个配置的例子.
我们强烈建议你熟悉NHibernate's的log信息。
NHibernate's的很多工作都会尽量详细的留下log,也没有让它变的难以阅读。
这是用来解决问题的最基本的设施。
第3章持久化类(PersistentClasses)
POCO简单示例
为持久化字段声明访问器(getters和setters)
实现一个默认的构造方法(constructor)
提供一个标识属性(identifierproperty)(可选)
建议使用不是sealed的类(可选)
实现继承(Inheritance)
实现Equals()和GetHashCode()
持久化生命周期(Lifecycle)中的回调(Callbacks)
合法性检查(Validatable)回调
用属性替代XML
持久化类是应用程序用来解决商业问题的类(比如,在电子交易程序中的Customer和Order)。
持久化类,就如同它的名字暗示的,是短暂存在的,它的实例会被持久性保存于数据库中。
如果这些类符合简单的规则,NHibernate能够工作得最好,这些规则就是PlainOldCLRObject(POJO,简单传统CLR对象)编程模型。
POCO简单示例
用一个类描述一只猫。
publicclassCat
{
privatelong_id;//identifier
privatestring_name;
privateDateTime_birthdate;
privateCat_mate;
privateSet_kittens;
privateColor_color;
privatechar_sex;
privatefloat_weight;
publiclongId
{
get{return_id;}
set{_id=value;}
}
publicstringName
{
get{return_name;}
set{_name=value;}
}
publicDateTimeBirthdate
{
get{return_birthdate;}
set{_birthdate=value;}
}
publicCatMate
{
get{return_mate;}
set{_mate=value;}
}
publicSetKittens
{
get{return_kittens;}
set{_kittens=value;}
}
publicColorColor
{
get{return_color;}
set{_color=value;}
}
publiccharSex
{
get{return_sex;}
set{_sex=value;}
}
publicfloatWeight
{
get{return_weight;}
set{_weight=value;}
}
}
有四条主要的规则:
为持久化字段声明访问器(getters和setters)
Cat为它的所有可持久化字段声明了getters和setters访问器。
用访问器来替代直接访问字段是个好习惯。
然而也可以通过字段(field)来使用NNHibernate。
属性不一定需要声明为public的。
NHibernate可以对default,procted,internal,