大家好，又见面了，我是你们的朋友全栈君。
一：介绍
NHibernate 是一个基于.Net 的针对关系型数据库的对象持久化类库。Nhibernate 来源于非常优秀的基于Java的Hibernate 关系型持久化工具。
NHibernate 从数据库底层来持久化你的.Net 对象到关系型数据库。NHibernate 为你处理这些，远胜于你不得不写SQL去从数据库存取对象。你的代码仅仅和对象关联，NHibernat 自动产生SQL语句，并确保对象提交到正确的表和字段中去。
二：ORM
对象-关系映射（OBJECT/RELATION MAPPING，简称ORM），是随着面向对象的软件开发方法发展而产生的。面向对象的开发方法是当今企业级应用开发环境中的主流开发方法，关系数据库是企业级应用环境中永久存放数据的主流数据存储系统。对象和关系数据是业务实体的两种表现形式，业务实体在内存中表现为对象，在数据库中表现为关系数据。内存中的对象之间存在关联和继承关系，而在数据库中，关系数据无法直接表达多对多关联和继承关系。因此，对象-关系映射(ORM)系统一般以中间件的形式存在，主要实现程序对象到关系数据库数据的映射。
三：常用对象
| SessionFactory（NHibernate.ISessionFactory） | 对属于单一数据库的编译过的映射嗯间的一个线程安全的，不可变的缓存快照。它是Session的工厂，是ConnectioProvider的客户。可以持有一个可选的（第二级）数据缓存，可以在进程级别或集群级别保存可以在事务中重用的数据。 |
| 会话Session（NHibernate.ISession） | 单线程，生命期短促的对象，代表应用程序和持久化层之间的一次对话。封装了一个ADO.NET连接。也是Transaction的工厂。保存有必需的（第一级）持久化对象的缓存，用于遍历对象图，或者通过标识符查找对象 |
| 持久化对象（Persistent）及其集合（Collection） | 生命期短促的单线程对象，包含了持久化状态和商业功能。它们可能是普通的对象，唯一特别的是他们现在从属于且仅从属于一个Session。一旦Session被关闭，他们都将从Session中取消联系，可以在任何程序层自由使用（比如，直接作为传送到表现层的DTO，数据传输对象）。 |
| 临时对象（Transient Object）及其集合（Collection） | 目前没有从属于一个Session的持久化类的实例。它们可能是刚刚被程序实例化，还没来得及被持久化，或者是被一个已经关闭的Session所实例化的。 |
| 事务Transaction（NHibernate.ITransaction) | （可选）单线程，生命期短促的对象，应用程序用它来表示一批工作的原子操作。是底层的ADO.NET事务的抽象。一个Session某些情况下可能跨越多个Transaction事务。 |
| ConnectionProvider（NHibernate.Connectin.ConnectionProvider) | （可选）ADO.NET连接的工厂，从底层的IDbConnection抽象而来。对应用程序不可见，但可以被开发者扩展/实现。 |
| TransactionFactory（net.sf.hibernate.TransactionFactory) | （可选）事务实例的工厂，对应用程序不可见，但可以被开发者扩展/实现 |
| ICriteria | ICriteria是Expression(表达式)数据加载接口，Expression是一个关系表达式组合，通过它能产生SQL语句的Where部分, 用户需要通过ISession来间接调用它。 |
| IQuery | IQuery是HQL数据加载接口，HQL(Hibernate Query Language)是NHB专用的面向对象的数据查询语言，它与数据库的SQL有些类似，但功能更强大！同ICriteria一样，也需要通过ISession来间接调用它。 |
四：栗子
Nhibernate支持各大主流的数据库，本文中使用的是mysql数据库。看Nhibernate的配置文件，文件名 NHibernate.cfg.xml
<?xml version="1.0" encoding="utf-8" ?> <!-- Add this element --> <hibernate-configuration xmlns="urn:nhibernate-configuration-2.2" > <session-factory name="NHibernate.Test"><!--命名空间--> <!--定制IDriver的类型--> <property name="connection.driver_class">NHibernate.Driver.MySqlDataDriver</property> <!--用来获得连接的连接字符串--> <property name="connection.connection_string"> initial catalog=db_test;Data Source=xxx.xxx.x.xx;User Id=test;Password=test; pooling=true;min pool size=5; max pool size=100;Connection Timeout=100; </property> <!--NHibernate方言（Dialect）的类名 - 可以让NHibernate使用某些特定的数据库平台的特性--> <property name="dialect">NHibernate.Dialect.MySQL5Dialect</property> <mapping assembly="NHibernate.Test"/> </session-factory> </hibernate-configuration>
NHibernate方言（Dialect）与数据库的对应关系
| RDBMS | 方言 |
| DB2 | NHibernate.Dialect.DB2Dialect |
| PostgreSQL | NHibernate.Dialect.PostgreSQLDialect |
| MySQL | NHibernate.Dialect.MySQLDialect |
| Oracle (any version) | NHibernate.Dialect.OracleDialect |
| Oracle 9/10g | NHibernate.Dialect.Oracle9Dialect |
| Sybase | NHibernate.Dialect.SybaseDialect |
| Microsoft SQL Server 2000 | NHibernate.Dialect.MsSql2000Dialect |
| Microsoft SQL Server 7 | NHibernate.Dialect.MsSql7Dialect |
| Firebird | NHibernate.Dialect.FirebirdDialect |
五：数据库表映射xml，在项目中添加 nhibernate-configuration.xsd和 nhibernate-mapping.xsd 可以获得智能提示
<?xml version="1.0" encoding="utf-8" ?> <hibernate-mapping xmlns="urn:nhibernate-mapping-2.2" default-lazy="false"> <class name="NHibernate.Test.Entity.UserModel, NHibernate.Test" table="user" lazy="false" discriminator-value="0"> <id name="Id" column="Id" unsaved-value="0" type="Int32"> <generator class="increment" /> </id> <property name="UserName" column="UserName" type="String" length="100"/> <property name="Age" column="Age" type="Int32"/> </class> </hibernate-mapping>
hibernate-mapping 的对应属性，这个元素包括四个可选的属性。schema属性，指明了这个映射所引用的表所在的schema名称。假若指定了这个属性，表名会加上所指定的schema的名字扩展schema的名字扩展为全限定名。假若没有指定，表明就不会使用全限定名。default-cascade指定了未注明cascade属性和集合类会采用什么样的默认级联风格。auto-import属性默认让我们在查询语言中可以使用非全限定名的类名。default-access告诉我们怎么访问属性。
<hibernate-mapping schema="schemaName" (1) default-cascade="none|save-update" auto-import="true|false" default-access="property|field|nosetter|ClassName" assembly="assembly.name" namespace="namespace.name" >
hibernate-mapping
|
||
| schema（可选） | schemaName | 数据库schema名称。 |
| default-cascade（可选-默认为none） | none|save-update | 默认的级联风格。 |
| auto-import（可选-默认为true） | true|false | 指定是否我们可以在查询语言中使用非全限定的类名（仅限于本映射文件中的类）。 |
| default-acess（可选-默认为property） | property|field|nosetter|ClassName | NHibernate访问属性时的策略。 |
| assembly（可选） | assembly.name | 指定一个程序集，如果在映射文档中没有指定程序集，就使用这个程序集 |
| namespace | namespace.name | 指定一个命名空间前缀，如果在一个映射文档中没有指定全限定名，就使用这个命名空间名。 |
class:可以使用class元素来定义一个持久化类
<class name="ClassName" table="tableName" discriminator-value="discriminator_value" mutable="true|false" schema="owner" proxy="ProxyInterface" dynamic-update="true|false" dynamic-insert="true|false" polymorphism="implicit|explicit" where="arbitrary sql where condition" persister="PersisterClass" lazy="true|false" />
| class | ||
| name | ClassName | 持久化类（或者接口）的全限定名 |
| table | tableName | 对应的数据库表名。 |
| discriminator-value（可选-默认和类名一样） | discriminator_value | 一个用于区分不同的子类的值，在多态行为时使用。 |
| mutable（可选，默认为true） | true|false | 表明该类的实例可变（不可变）。 |
| schema（可选） | owner | 覆盖在根<hibernate-mapping>元素中指定的schema名字 |
| proxy（可选） | ProxyInterface | 指定一个接口，在延迟装载时作为代理使用。你可以在这里使用该类自己的名字 |
| dynamic-update（可选，默认为false） | true|false | 指定用于UPDATE的sql将会在运行时动态生成，并且只更新哪些改变过的字段 |
| dynamic-insert（可选，默认为false） | true|false | 指定用于INSERT的sql将会在运行时动态生成，并且只包含哪些非空字段 |
| polymorphism（可选，默认为implicit（隐式）） | implicit|explicit | 界定是隐式还是显式的使用查询多态。 |
| where（可选） | arbitrary sql where condition | 指定一个附加的SQL WHERE 条件，在抓取这个类的对象时会一直增加这个条件 |
| persister（可选） | PersisterClass | 指定一个定制的IClassPersister。 |
| lazy（可选） | true|false | 假若设置lazy=“true”，就是设置这个类自己的名字作为proxy接口的一种等价快捷方式 |
主键Id
<id name="propertyName" type="typename" column="column_name" unsaved-value="any|none|null|id_value" access="field|property|nosetter|ClassName"> <generator class="generatorClass"/> </id>
| Id | ||
name（可选）
|
propertyName | 标识属性的名字。 |
type（可选）
|
typename | 标识NHibernate类型的名字。 |
| unsaved-value（可选-默认为null） | any|none|null|id_value | 一个特定的标识属性值，用来标识该实例是刚刚创建的，尚未保存。这可以把这种实例和从以前的sssion中装载过（可能又做过修改）但未再次持久化的实例区分开来。 |
| column（可选-默认为属性名） | column_name | 主键字段的名字 |
| access（可选-默认为property） | field|property|nosetter|ClassName | NHibernate用来访问属性值的策略 |
如果name属性不存在，会认为这个类没有标识属性。
unsaved-value属性很重要！如果你的类的标识属性不是默认为null的，你应该指定正确的默认值。特别重要的是在使用值类型System.ValueType，例如System.Int32或者System.Guid作为你的<id>属性时确保清楚的设置这个属性，因为System.ValueType对象不可能为null值。
还有一个另外的<composite-id>声明可以访问旧式的多主键数据。不鼓励使用这种方式。
gennerator
<id name="Id" type="Int64" column="uid" unsaved-value="0"> <generator class="NHibernate.Id.TableHiLoGenerator"> <param name="table">uid_table</param> <param name="column">next_hi_value_column</param> </generator> </id>
必须声明的<generator>子元素是一个.NET类的名字，用来为该持久化类的属性生成唯一的标识。如果这个生成器实例需要某些配置值或者初始化参数，用<param>元素传递。
|
identity
|
对DB2,MySQL, MS SQL Server, Sybase和HypersonicSQL的内置标识字段提供支持。返回的标识符是 Int64, Int32 或者 Int16类型的。 |
|
sequence（序列） |
对DB2,MySQL, PostgreSQL, Oracle的内置标识字段提供支持。返回的标识符是Int64 Int32 或者 Int16类型的。 |
|
hilo（高低位） |
使用一个高/低位算法来高效的生成Int64, Int32 或者 Int16类型的标识符。给定一个表和字段（默认分别是hibernate_unique_key 和next）作为高位值得来源。高/低位算法生成的标识符只在一个特定的数据库中是唯一的。 |
|
seqhilo（使用序列的高低位） |
使用一个高/低位算法来高效的生成Int64, Int32 或者 Int16类型的标识符，给定一个数据库序列（sequence)的名字。 |
|
uuid.hex
|
用一个System.Guid和它的ToString(string format)方法生成字符串类型的标识符。字符串的长度取决于 format的配置。 |
|
uuid.string |
用一个新的System.Guid产生一个byte[] ，把它转换成字符串。 |
|
guid |
用一个新的System.Guid 作为标识符。 |
|
guid.comb |
用Jimmy Nilsson在文章http://www.informit.com/articles/article.asp?p=25862中描述的算法产生一个新的System.Guid。 |
|
native（本地） |
根据底层数据库的能力选择 identity, sequence 或者 hilo中的一个。 |
|
assigned（程序设置） |
让应用程序在save()之前为对象分配一个标示符。 |
|
foreign（外部引用） |
使用另外一个相关联的对象的标识符。和<one-to-one>联合一起使用。 |
联合ID(composite-id)
<composite-id name="propertyName"class="ClassName" unsaved-value="any|none" access="field|property|nosetter|ClassName"> <key-property name="propertyName" type="typename" column="column_name"/> <key-many-to-one name="propertyName class="ClassName" column="column_name"/> ...... </composite-id>
如果表使用联合主键，你可以把类的多个属性组合成为标识符属性。<composite-id>元素接受<key-property>属性映射和<key-many-to-one>属性映射作为子元素。
<composite-id> <key-property name="medicareNumber"/> <key-property name="dependent"/> </composite-id>
你的持久化类必须重载Equals()和HashCode()方法，来实现组合的标识符判断等价.也必须实现Serializable接口
不幸的是，这种组合关键字的方法意味着一个持久化类是它自己的标识。除了对象自己之外，没有什么方便的“把手”可用。你必须自己初始化持久化类的实例，在使用组合关键字Load()持久化状态之前，必须填充他的联合属性。我们会在TODO: LINKTOCOMPENENTS 中说明一种更加方便的方法，把联合标识实现为一个独立的类，下面描述的属性只对这种备用方法有效:
|
name (可选) |
一个组件类型，持有联合标识 |
|
class (可选 – 默认为通过反射(reflection)得到的属性类型) |
作为联合标识的组件类名。 |
|
unsaved-value (可选 – 默认为 none) |
假如被设置为any的值，就表示新创建，尚未被持久化的实例将持有的值。 |
识别器（discriminator）
<discriminator column="discriminator_column" type="discriminator_type" force="true|false" insert="true|false" />
|
column (可选 – 默为 class) |
识别器字段的名字 |
|
type (可选 – 默认为 String) |
一个NHibernate字段类型的名字 |
|
force (可选 – 默认为 false) |
强制”NHibernate指定允许的识别器值,就算取得的所有实例都是根类的。 |
|
insert (可选 – 默认为 true) |
当识别器是被映射的组件的标识符的一部分时设置为false。 |
标识器字段的实际值是根据<class> 和<subclass>元素的discriminator-value得来的。
文章来源：http://www.cnblogs.com/wolf-sun/p/4138918.html
发布者：全栈程序员-用户IM，转载请注明出处：https://javaforall.cn/154343.html原文链接：https://javaforall.cn
【正版授权，激活自己账号】： Jetbrains全家桶Ide使用，1年售后保障，每天仅需1毛
【官方授权 正版激活】： 官方授权 正版激活 支持Jetbrains家族下所有IDE 使用个人JB账号...
