NHibernate官方文档中文版--基础ORM（Basic O/R Mapping）

映射声明

对象/关系映射在XML文件中配置。mapping文件这样设计是为了使它可读性强并且可修改。mapping语言是以对象为中心，意味着mapping是围绕着持久化类声明来建立的，而不是围绕数据表。

要注意的是，尽管很多NHibernate使用者选择手动定义XML文件，但是仍然有很多工具可以用来生成mapping文件，包括NHibernate.Mapping.Attributes 库和各种各样基于模板的代码生成工具（CodeSmith, MyGeneration）。

让我们用一个mapping的例子作为开始：

<?xml version="1.0"?>
<hibernate-mapping xmlns="urn:nhibernate-mapping-2.2" assembly="Eg"
    namespace="Eg">

        <class name="Cat" table="CATS" discriminator-value="C">
                <id name="Id" column="uid" type="Int64">
                        <generator class="hilo"/>
                </id>
                <discriminator column="subclass" type="Char"/>
                <property name="BirthDate" type="Date"/>
                <property name="Color" not-null="true"/>
                <property name="Sex" not-null="true" update="false"/>
                <property name="Weight"/>
                <many-to-one name="Mate" column="mate_id"/>
                <set name="Kittens">
                        <key column="mother_id"/>
                        <one-to-many class="Cat"/>
                </set>
                <subclass name="DomesticCat" discriminator-value="D">
                        <property name="Name" type="String"/>
                </subclass>
        </class>

        <class name="Dog">
                <!-- mapping for Dog could go here -->
        </class>

</hibernate-mapping>

我们现在讨论mapping文件中的内容。我们将只会描述NHibernate在运行时使用的文档中的标签和特性。mapping文件也包含一些额外的可选的特性和标签，这些特性和标签会影响表结构导出工具（schema export tool）导出的数据库的表结构（database schemas）。（例如not-null特性）。

XML名称空间

所有的XMLmapping应该声明XML名称空间。规定的XML结构定义（schema definition）可以在NHibernate发行版中的src hibernate-mapping.xsd 中找到。

小建议：想要启用mapping和配置文件的智能感知功能，需要将相应的.xsd文件作为你解决方案中所有项目的一部分（生成操作可以是‘none’）或者作为“solution files”，或者放在你的“lib”文件夹中，然后将它添加到你的XML文件的schemas属性中。你可以在<VS installation directory>XmlSchemas中复制它，要注意你可能得将不同版本的xsd对应不同版本的NHibernate。

hibernate-mapping

这个标签有很多可选的特性。schema特性定义了对应表的数据库表空间。如果指定了相应的表空间，那么数据表名称就会被限定在给定的表空间。如果这个置空，就不会限定表空间。default-cascade 特性定义了没有详细指定级联方式的属性和集合的级联方式。默认情况下，auto-import 特性让我们在查询语句中使用不限定表空间的类名。assembly 和 namespace特性定义了持久化类位于哪个程序集中，在哪个名称空间中声明。

           <hibernate-mapping                         (1)
         schema="schemaName"                          (2)
         default-cascade="none|save-update"           (3)
         auto-import="true|false"                     (4)
         assembly="Eg"                                (5)
         namespace="Eg"                               (6)
         default-access="field|property|field.camecase(7)..."
         default-lazy="true|false"
 />

(1) schema (可选): 数据库表空间的名称。

(2) default-cascade (可选 - 默认 none):  默认的级联方式。

(3) auto-import (可选 - 默认true):  定义是否可以在查询语句中使用非限定表空间的类名（在mapping文件中定义的类）。

(4)(5) assembly and namespace(可选):  指定非限定表空间的类所在的程序集和名称空间。

(6) default-access (可选- 默认 property): NHibernate获得属性值的方式

(7) default-lazy (可选- 默认 true):如果设置成false，懒加载就会被禁用

如果你不使用assembly和namespace特性，你就得使用完整的类名，包括程序集和名称空间的名称。

如果你有两个持久化类使用了相同的（未限定表空间的）名字，你应该将auto-import设置成false。如果你试图将两个类设置成相同的名称，那么NHibernate会抛出异常。

类

你可以使用class来定义一个持久化类：

<class
        name="ClassName"                              (1)
        table="tableName"                             (2)
        discriminator-value="discriminator_value"     (3)
        mutable="true|false"                          (4)
        schema="owner"                                (5)
        proxy="ProxyInterface"                        (6)
        dynamic-update="true|false"                   (7)
        dynamic-insert="true|false"                   (8)
        select-before-update="true|false"             (9)
        polymorphism="implicit|explicit"              (10)
        where="arbitrary sql where condition"         (11)
        persister="PersisterClass"                    (12)
        batch-size="N"                                (13)
        optimistic-lock="none|version|dirty|all"      (14)
        lazy="true|false"                             (15)
        abstract="true|false"                         (16)
/>

(1) name: 持久化类（或者接口）的全限定名。

(2) table(optional - 默认是非限定的类名): 对应的数据库表名。

(3) discriminator-value (optional - 默认是类名):  一个用于区分不同的子类的值，在多态行为时使用。可以设置为null和not null。

(4) mutable (optional, 默认是true): 指定该类的实例可变（不可变）。

(5) schema (optional): 覆盖在根<hibernate-mapping> 标签中指定的表空间名字

(6) proxy (optional): Specifies an interface to use for lazy initializing proxies. You may specify the name of the class itself. 指定一个接口，在延迟装载时作为代理使用。你可以在这里使用该类自己的名字。

(7) dynamic-update (optional, defaults to false): 指定用于UPDATE 的SQL将会在运行时动态生成，并且只更新那些改变过的字段。

(8) dynamic-insert (optional, defaults to false): 指定用于INSERT的SQL将会在运行时动态生成，并且只包含那些非空字段。

(9) select-before-update (optional, defaults to false): 指定NHibernate是否需要执行UPDATE操作，除非它确定对象真的被修改了，不然就不会执行。在一些特定的情况下（实际上仅仅当瞬时态对象要执行update()而被关联到一个新的session的时候），这意味着NHibernate在执行UPDATE之前会执行一个额外的SELECT的SQL语句操作来判断是不是真的需要进行UPDATE。

(10) polymorphism (optional, defaults to implicit):  指定是隐式还是显式的使用查询多态。

(11) where (optional)  指定一个附加的SQL WHERE 条件，在抓取这个类的对象时会一直增加这个条件。

(12) persister (optional):  指定一个自定义的IClassPersister.

(13) batch-size (optional, defaults to 1) 指定通过主键获得实体方式的批量插入量

(14) optimistic-lock (optional, defaults to version): 指定乐观锁策略。

(15) lazy (optional): 如果设置成lazy="false"懒加载会被完全关闭。

(16) abstract (optional):  用来在<union-subclass>继承中标记抽象父类

若指明的持久化类实际上是一个接口，也可以被完美地接受。其后你可以用 <subclass> 来指定该接口的实际实现类名。你可以持久化任何static（静态的）内部类。记得应该使用标准的类名格式，就是说比如：Eg.Foo+Bar 。这是因为HQL解析器的限制，在NHibernate 1.0版本中，在查询中不能使用内部类。

任何对不可变类的修改操作，mutable="false"，都不会被持久化。这可以让NHibernate做一些小小的性能优化。

可选的proxy属性可以允许延迟加载类的持久化实例。NHibernate开始会返回实现了这个接口的代理。当代理的某个方法被实际调用的时候，真正的持久化对象才会被加载。参见下面的“用于延迟加载的代理”。

Implicit (隐式)的多态是指，如果查询中给出的是任何父类、该类实现的接口或者该类的名字，都会返回这个类的实例；如果查询中给出的是该类子类的名字，则会返回该类的实例。Explicit （显式）的多态是指，只有在查询中给出的明确是该类的名字时才会返回这个类的实例；对于该类的查询也只会返回在 <class> 的定义中作为 <subclass> 或者 <joined-subclass> 出现的子类。 大多数情况下，默认的polymorphism="implicit"都是合适的。 显式的多态在有两个不同的类映射到同一个表的时候很有用。（这就允许一个只包含部分表字段的“轻型”类）。

persister属性可以让你自定义这个类使用的持久化策略。你可以指定你自己实现的NHibernate.Persister.EntityPersister的子类，你甚至可以完全从头开始编写一个NHibernate.Persister.IClassPersister接口的实现，可能是通过调用储存过程、将数据序列化到文件或者LDAP数据库来实现。参阅NHibernate.DomainModel.CustomPersister，这是一个简单的例子（“持久化”到一个Hashtable）。

请注意dynamic-update和dynamic-insert的设置并不会继承到子类，所以在<subclass>或者<joined-subclass>元素中可能需要再次设置。这些设置是否能够提高效率要视情形而定。请用你的智慧决定是否使用。

使用select-before-update 通常会降低性能。但是这种方式能够有效地防止不必要的数据库更新。

如果你使用了select-before-update ，你就可以选择一种乐观锁的策略：