Nhibernate 使用 （一）

一：介绍

       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