《NHibernate中文文档》由会员分享，可在线阅读，更多相关《NHibernate中文文档（22页珍藏版）》请在金锄头文库上搜索。
1、【精品文档】如有侵权，请联系网站删除，仅供学习与交流NHibernate中文文档.精品文档.第1章 NHibernate体系结构总览对NHibernate体系结构的非常高层的概览: 这幅图展示了NHibernate使用数据库和配置文件数据来为应用程序提供持久化服务（和持久化的对象）。 我们试图显示更多NHibernate运行时体系结构的细节。 但挺不幸的，NHibernate是比较灵活的并且提供了好几种不同的运行方式。我们展示一下两种极端情况。轻型体系中，应用程序自己提供ADO.NET连接，并且自行管理事务。这种方式使用了NHibernate API的一个最小子集。 全面解决体系中，对于应用程
2、序来说，所有的底层ADO.NET API都被抽象了，NHibernate会替你照管所有的细节。 下面是图中一些对象的定义：SessionFactory (NHibernate.ISessionFactory)对属于单一数据库的编译过的映射文件的一个线程安全的，不可变的缓存快照。它是Session的工厂，是ConnectionProvider的客户。可以持有一个可选的（第二级）数据缓存，可以在进程级别或集群级别保存可以在事物中重用的数据。会话Session (NHibernate.ISession) 单线程，生命期短促的对象，代表应用程序和持久化层之间的一次对话。封装了一个ADO.NET连接。也
3、是Transaction的工厂。保存有必需的（第一级）持久化对象的缓存，用于遍历对象图，或者通过标识符查找对象。持久化对象(Persistent)及其集合(Collections) 生命期短促的单线程的对象，包含了持久化状态和商业功能。它们可能是普通的对象，唯一特别的是他们现在从属于且仅从属于一个Session。一旦Session被关闭，他们都将从Session中取消联系，可以在任何程序层自由使用（比如，直接作为传送到表现层的DTO,数据传输对象）。 临时对象(Transient Object)及其集合（Collection） 目前没有从属于一个Session的持久化类的实例。他们可能是刚刚被
4、程序实例化，还没有来得及被持久化，或者是被一个已经关闭的Session所实例化的。 事务Transaction (NHibernate.ITransaction) （可选） 单线程，生命期短促的对象，应用程序用它来表示一批工作的原子操作。是底层的ADO.NET事务的抽象。一个Session某些情况下可能跨越多个Transaction 事务。 ConnectionProvider (NHibernate.Connection.ConnectionProvider) （可选）ADO.NET连接的工厂。从底层的IDbConnection抽象而来。对应用程序不可见，但可以被开发者扩展/实现。 Tran
5、sactionFactory (net.sf.hibernate.TransactionFactory) （可选）事务实例的工厂。对应用程序不可见，但可以被开发者扩展/实现。 在上面的轻型结构中，程序没有使用Transaction / TransactionFactory 或ConnectionProvider API,直接和ADO.NET对话了。 第2章 ISessionFactory配置目录 可编程配置方式 获取ISessionFactory 用户自行提供ADO.NET连接 NHibernate提供ADO.NET连接 可选配置属性 SQL 方言 (SQL Dialects) 外连接抓取（O
6、uter Join Fetching ) 自定义 CacheProvider 查询语言替换Logging因为NHibernate被设计为可以在许多不同环境下工作，所以它有很多配置参数。幸运的是，大部分都已经有默认值了。 NHibernate.Test.dll包含了一个示例的配置文件app.config，它演示了一些可变的参数。 可编程配置方式 NHibernate.Cfg.Configuration的一个实例代表了应用程序中所有的.NET类到SQL数据库的映射的集合。Configuration用于构造一个(不可变的)ISessionFactory。这些映射是从一些XML映射文件中编译得来的。
7、你可以得到一个Configuration的实例，直接实例化它即可。下面有一个例子，用来从两个XML配置文件（和exe文件在同一个目录下）中的映射中初始化： Configuration cfg = new Configuration() .AddXmlFile(Item.hbm.xml) .AddXmlFile(Bid.hbm.xml);另外一个（某些时候更好的）方法是让NHibernate自行用GetManifestResourceStream()来装载映射文件 Configuration cfg = new Configuration() .AddClass( typeof(NHiberna
8、te.Auction.Item) ) .AddClass( typeof(NHibernate.Auction.Bid) );NHibernate 就会在这些类型的程序集的嵌入的资源中寻找叫做NHibernate.Auction.Item.hbm.xml 和NHibernate.Auction.Bid.hbm.xml 的映射文件。这种方法取消了所有对文件名的硬编码。 另外一个（可能是最好的）方法是让NHibernate读取一个程序集中所有的配置文件: Configuration cfg = new Configuration() .AddAssembly( NHibernate.Auction
9、 );NHibernate将会遍历程序集查找任何以hbm.xml结尾的文件。 这种方法取消了所有对文件名的硬编码并且确保程序集中的配置文件文件都会被加载。 在使用VisualStudio.NET或者NAnt生成程序集时请确保hbm.xml文件是作为嵌入资源(Embedded Resources)添加的。 Configuration也可以指定一些可选的配置项 Hashtable props = new Hashtable();Configuration cfg = new Configuration() .AddClass( typeof(NHibernate.Auction.Item) ) .
10、AddClass( typeof(NHibernate.Auction.Bid) );cfg.Properties = props;Configuration是仅在配置期使用的对象，从第一个SessionFactory开始建立的时候，它就失效了。 获取ISessionFactory当所有的映射都被Configuration解析之后，应用程序为了得到ISession实例，必须先得到它的工厂。这个工厂应该是被应用程序的所有线程共享的：ISessionFactory sessions = cfg.BuildSessionFactory();当然，NHibernate并不禁止你的程序实例化多个ISes
11、sionFactory。在你使用不止一个数据库的时候，这就有用了。 用户自行提供ADO.NET连接 ISessionFactory可以使用一个用户自行提供的ADO.NET连接来打开一个ISession。这种设计可以让应用程序来自己管理ADO.NET连接: IDbConnection conn = myapp.GetOpenConnection();ISession session = sessions.OpenSession(conn);/ do some data access work应用程序必须小心，不能在同一个连接上打开两个并行的 ISession! NHibernate提供ADO.N
12、ET连接 另一种方法就是，你可以让ISessionFactory替你打开连接。SessionFactory必须事先知道ADO.NET连接的参数，有几种不同的方法设置参数： 1. 通过提供一个IDictionary实例给Configuration.Properties。 2. 在名为nhibernate的System.Configuration.NameValueSectionHandler类型的配置节点添加属性。 3. 在hibernate.cfg.xml 中包含元素。 如果你使用这种方法，打开一个ISession是非常简单的： ISession session = sessions.Open
13、Session(); / open a new Session/ do some data access work, an ADO connection will be used on demand所有的NHibernate属性名和约束都在 NHibernate.Cfg.Environment类中定义。我们讨论一下ADO.NET连接配置最重要的几项设置： 假若你设置了如下的属性，Hibernate会使用ADO.NET Data Provider来得到连接： 表 2.1. NHibernate ADO.NET 属性属性名用途hibernate.connection.provider_class
14、定制IConnectionProvider的类型. 例如：full.classname.of.ConnectionProvider （如果提供者创建在NHibernate中）, 或者 full.classname.of.ConnectionProvider, assembly （如果使用一个自定义的IConnectionProvider接口的实现，它不属于NHibernate）。 hibernate.connection.driver_class 定制IDriver的类型. full.classname.of.Driver （如果驱动类创建在NHibernate中）, 或者 full.clas
15、sname.of.Driver, assembly （如果使用一个自定义IDriver接口的实现，它不属于NHibernate）。 hibernate.connection.connection_string 用来获得连接的连接字符串. hibernate.connection.isolation 设置事务隔离级别. 请检查 System.Data.IsolationLevel 来得到取值的具体意义并且查看数据库文档以确保级别是被支持的。 例如： Chaos, ReadCommitted, ReadUncommitted, RepeatableRead, Serializable, Unspecified 下面是一个在web.config文件中指定连接属性的例子: section name=nhibernate type=System.Configuration.NameValueSectionHandler, System, Version=1.0.5000.0,Culture=neutral, PublicKe
