源博客:http://www.cnblogs.com/kissdodog/archive/2013/02/21/2919886.html

1. hibernate-mapping

这个元素包括以下可选的属性。schema属性,指明了这个映射所引用的表所在的schema名称。假若指定了这个属性, 表名会加上所指定的schema的名字扩展为全限定名。假若没有指定,表名就不会使用全限定名。default-cascade 指定了未明确注明cascade属性的.Net属性和集合类.Net会采取什么样的默认级联风格。 auto-import属性默认让我们在查询语言中可以使用非全限定名的类名。assemblynamespace指定了持久化类的应用程序集名称和其所在的名称空间名。
<hibernate-mapping                                   schema="schemaName"                   (1) default-cascade="none|save-update"    (2)auto-import="true|false"              (3)assembly="Eg"                         (4)namespace="Eg"                         (5)/>  

 各选项说明:

(1)

schema (optional): 数据库schema名称。

(2)

default-cascade (可选 - 默认为 none): 默认的级联风格。

(3)

auto-import (optional - defaults to true): 指定我们在使用查询语句的时候是否可以使用非全限定名。

(4)(5)

assembly and namespace(可选): 指定映射文件中的类的应用程序集名称和其所在的名称空间名,用来生成类的非全限定名。

  如果没有设置assemblynamespace标签,我们不得不使用类的非全限定名 (namespace.类名,assembly).

  假若你有两个持久化类,它们的非全限定名是一样的,你应该设置auto-import="false"。 假若说你把一个“import过”的名字同时对应两个类, NHibernate会抛出一个异常。

二. class

你可以使用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: 持久化类(或者接口)的.NET全限定名。

(2)

table: 对应的数据库表名。

(3)

discriminator-value(辨别值) (可选 - 默认和类名一样):一个用于区分不同的子类的值,在多态行为时使用。可选值包括nullnot null

(4)

mutable (可选, 默认值为 true): 表明该类的实例可变(不可变)。

(5)

schema (可选) 覆盖在根元素中指定的schema名字。

(6)

proxy (可选)指定一个接口,在延迟装载时作为代理使用。你可以在这里使用该类自己的名字。

(7)

dynamic-update (可选,默认为false): 指定用于UPDATE 的SQL将会在运行时动态生成,并且只更新那些改变过的字段。

(8)

dynamic-insert (可选, 默认为false): 指定用于 INSERT的 SQL 将会在运行时动态生成,并且只包含那些非空值字段。

(9)

select-before-update (可选,默认值为false): 指定NHibernate除非确定对象的确被修改了,UPDATE操作。在特定场合(实际上,只会发生在一个临时对象关联到一个新的session中去,执行update()的时候),这说明NHibernate会在UPDATE之前执行一次额外的SQLSELECT操作,来决定是否应该进行UPDATE。

(10)

polymorphism (可选, 默认值为 implicit (隐式)): 界定是隐式还是显式的使用查询多态。

(11)

where (可选) 指定一个附加的SQLWHERE 条件,在抓取这个类的对象时会一直增加这个条件。

(12)

persister (可选): 指定一个定制的IClassPersister

(13)

batch-size (可选,默认是1) 指定一个用于根据标识符抓取实例时使用的"batch size"(批次抓取数量)。

(14)

optimistic-lock (乐观锁定) (可选,默认是version): 决定乐观锁定的策略。

(15)

lazy (可选): 假若设置lazy="false",就会禁用延迟加载。

(16)

abstract(可选) 用于在<union-subclass>的继承结构 (hierarchies)中标识抽象超类。

 若指明的持久化类实际上是一个接口,这也是完全可以接受的。 之后你可以用元素<subclass>来指定该接口的实际实现类。 你可以持久化任何static(静态的)内部类。 你应该使用标准的类名格式来指定类名,比如:Eg.Foo+Bar, Eg。由于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-updatee和dynamic-insert的设置并不会继承到子类, 所以在<subclass>或者<joined-subclass>元素中可能 需要再次设置。这些设置是否能够提高效率要视情形而定。请用你的智慧决定是否使用。

  使用select-before-update通常会降低性能。如果你重新连接一个脱管(detache)对象实例 到一个Session中时,它可以防止数据库不必要的触发update。 这就很有用了。

如果你打开了dynamic-update,你可以选择几种乐观锁定的策略:

  • version(版本检查) 检查version/timestamp字段
  • all(全部) 检查全部字段
  • dirty(脏检查)只检察修改过的字段
  • none(不检查)不使用乐观锁定

  我们非常强烈建议你在NHibernate中使用version/timestamp字段来进行乐观锁定。 对性能来说,这是最好的选择,并且这也是唯一能够处理在session外进行操作的策略(例如: 在使用ISession.Update()的时候)。注意version或者是timestamp属性不能为null,不管是否使用了unsaved-value策略,或者是实例被作为是瞬态。

  从NHibernate 1.2.0开始,版本号从1开始(以前的版本从0开始),这样允许把version的属性的unsaved-value设置为0。

三、 id

被映射的类必须定义对应数据库表主键字段。大多数类有一个属性, 为每一个实例包含唯一的标识。 元素定义了该属性到数据库表主键字段的映射。

<id                                             name="PropertyName"                        (1)   type="typename"                             (2)column="column_name"                         (3)unsaved-value="any|none|null|id_value"       (4)access="field|property|nosetter|ClassName">   (5)<generator class="generatorClass"/>
</id>

(1)

name (可选): 标识属性的名字。

(2)

type(可选): 标识NHibernate类型的名字。

(3)

column(可选 - 默认为属性名): 主键字段的名字。

(4)

unsaved-value (可选 - 默认为一个切合实际(sensible)的值): 一个特定的标识属性值,用来标志该实例是刚刚创建的,尚未保存。 这可以把这种实例和从以前的session中装载过(可能又做过修改--译者注) 但未再次持久化的实例区分开来。

(5)

access (可选 - 默认为property): NHibernate用来访问属性值的策略。

  如果name属性不存在,会认为这个类没有标识属性。

四、(主键生成策略)generator

  可选的<generator>子元素是一个.NET类的名字, 用来为该持久化类的实例生成唯一的标识。如果这个生成器实例需要某些配置值或者初始化参数, 用元素来传递。

<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>

 所有的生成器都实现NHibernate.Id.IIdentifierGenerator接口。 这是一个非常简单的接口; 某些应用程序可以选择提供他们自己特定的实现。当然, NHibernate提供了很多内置的实现。下面是一些内置生成器的快捷名字:

  1、increment

用于为int类型生成 唯一标识。只有在没有其他进程往同一张表中插入数据时才能使用。 在集群下不要使用

  2、identity

对DB2,MySQL, MS SQL Server, Sybase和HypersonicSQL的内置标识字段提供支持。数据库返回的主键值 返回的标识符是int类型的。

  3、sequence

在DB2,PostgreSQL, Oracle, SAP DB, McKoi中使用序列(sequence), 而在Interbase中使用生成器(generator)。返回的标识符是int类型的。

  4、hilo

  使用一个高/低位算法来高效的生成int类型的标识符。给定一个表和字段(默认分别是是hibernate_unique_key 和next_hi)作为高位值得来源。 高/低位算法生成的标识符只在一个特定的数据库中是唯一的。在用户自行提供的连接中,不要使用这种生成器。

  5、seqhilo

使用一个高/低位算法来高效的生成int类型的标识符,给定一个数据库序列(sequence)的名字。

  6、uuid.hex

用一个System.Guid的ToString()方法法生成字符串类型的标识符, 字符串的长度由format参数定义。

  7、uuid.string

用一个新的System.Guid实例的byte[]转化为字符串作为标示符。

  8、guid

使用新的System.Guid实例作为标示符。

  9、guid.comb

使用Jimmy Nilsson的算法(请参阅http://www.informit.com/articles/article.asp?p=25862)生成一个新的System.Guid标示符。

  10、native

根据底层数据库的能力选择identity, sequence 或者hilo中的一个。

  11、assigned

让应用程序在Save()之前为对象分配一个标示符。

  12、foreign

使用另外一个相关联的对象的标识符。通常和<one-to-one>联合起来使用。

 高/低位算法(Hi/Lo Algorithm)

hilo 和 seqhilo生成器给出了两种hi/lo算法的实现, 这是一种很令人满意的标识符生成算法。 第一种实现需要一个“特殊”的数据库表来保存下一个可用的“hi”值。 第二种实现使用一个Oracle风格的序列(在被支持的情况下)。
<id name="Id" type="Int64" column="cat_id"><generator class="hilo"><param name="table">hi_value</param><param name="column">next_value</param><param name="max_lo">100</param></generator>
</id>
<id name="Id" type="Int64" column="cat_id"><generator class="seqhilo"><param name="sequence">hi_value</param><param name="max_lo">100</param></generator>
</id>

很不幸,你在为NHibernate自行提供IDbConnection时无法使用hilo。 NHibernate必须能够在一个事务里获取"hi"值。

  UUID算法(UUID Algorithm )

<id name="Id" type="String" column="cat_id"><generator class="uuid.hex"><param name="format">format_value</param><param name="seperator">seperator_value</param></generator>
</id>

  UUID算法是调用Guid.NewGuid().ToString(format)方法生成标示符。 format参数的使用请参阅MSDN,GUID的默认分隔符是-, 这个基本不会改动。format可以决定是都替换默认的默认分隔符。 The UUID is generated by callingGuid.NewGuid().ToString(format)

   UUID字符串算法

这个算法调用Guid.NewGuid().ToByteArray()方法获取byte[], 然后将byte[]转换为char[]char[]被作为一个长度 为16的字符串返回。

  GUID 算法

guid标示符通过调用Guid.NewGuid()创建。当在MSSQL中使用Guids标示符时做主键,外键或者是索引是为了获取更好的性能 通常使用guid.comb。其他支持GUIDs标示的的数据库使用guid.comb能否获得性能的提升未知。

  标识字段和序列(Identity columns and Sequences)

对于内部支持标识字段的数据库(DB2,MySQL,Sybase,MS SQL),你可以使用identity关键字生成。 对于内部支持序列的数据库(DB2,Oracle, PostgreSQL, Interbase, McKoi,SAP DB), 你可以使用sequence风格的关键字生成。 这两种方式对于插入一个新的对象都需要两次SQL查询。

对于跨平台开发,native策略会从identity, sequence 和hilo中进行选择,选择哪一个,这取决于底层数据库的支持能力。

  程序分配的标识符(Assigned Identifiers)

如果你需要应用程序分配一个标示符(而非NHibernate来生成它们),你可以使用assigned生成器。 这种特殊的生成器会使用已经分配给对象的标识符属性的标识符值。用这种特性来分配商业行为的关键字要特别小心(基本上总是一种可怕的设计决定)。

  因为其继承天性,使用这种生成器策略的实体不能通过ISession的SaveOrUpdate()方法保存。作为替代, 你应该明确告知NHibernate是应该被save还是update,分别调用ISession的Save()或Update()方法。

五、composite-id 联合ID

<composite-idname="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()GetHashCode()方法,来实现组合的标识符判断等价.也必须实现可序列化

  不幸的是,这种组合关键字的方法意味着一个持久化类是它自己的标识。除了对象自己之外, 没有什么方便的“把手”可用。你必须自己初始化持久化类的实例,在使用组合关键字load()持久化状态之前, 必须填充他的联合属性。我们会在 7.4. 组件作为联合标识符(Components as composite identifiers)第 7.4 节 “组件作为联合标识符(Components as composite identifiers)”章中说明一种更加方便的方法, 把联合标识实现为一个独立的类,下面描述的属性只对这种备用方法有效:

  • name (可选):一个组件类型,持有联合标识(参见下一节)。

  • access (可选 - 默认为property): NHibernate应该使用的访问此属性值的策略

  • class (可选 - 默认为通过反射(reflection)得到的属性类型) : 作为联合标识的组件类名(参见下一节)。

NHibernate之映射文件配置说明(转载1)相关推荐

  1. NHibernate之映射文件配置说明

    1. hibernate-mapping 这个元素包括以下可选的属性.schema属性,指明了这个映射所引用的表所在的schema名称.假若指定了这个属性, 表名会加上所指定的schema的名字扩展为 ...

  2. NHibernate之映射文件配置说明(转载2)

    六.鉴别器 在"一棵对象继承树对应一个表"的策略中,<discriminator>元素是必需的, 它定义了表的鉴别器字段. 鉴别器字段包含标志值,用于告知持久化层应该为 ...

  3. 快速生成NHibernate的映射文件和映射类的利器 —— codesmith软件

    1.     Codesmith软件简介 (1) Codesmith软件是一种基于模板的代码生成工具,在ORM中,它能帮助我们生成实体类.XML配置文件,从而简化了我们一部分的开发工作,它的使用类似于 ...

  4. Angular应用中tsconfig.json文件配置说明及配置全局路径映射

    tsconfig.json文件配置说明 1. tsconfig.json文件中的选项配置 2. 配置全局路径映射 1. tsconfig.json文件中的选项配置 TypeScript编译器配置文件的 ...

  5. NHibernate Step by Step (一) 转载

    转载于http://abluedog.cnblogs.com/archive/2006/04/15/375862.html 基本的软件环境如下: 1.NHibernate http://www.nhi ...

  6. Fluent NHibernate关系映射

    1.好处:Fluent NHibernate让你不再需要去写NHibernate的标准映射文件(.hbm.xml), 方便了我们的代码重构,提供了代码的易读性,并精简了项目代码 实现: (1).首先我 ...

  7. MyBatsi-Mapper映射文件

    Mapper映射文件 cache – 给定命名空间的缓存配置. cache-ref – 其他命名空间缓存配置的引用. resultMap – 是最复杂也是最强大的元素,用来描述如何从数据库结果集中来加 ...

  8. 使用内存映射文件在进程之间共享数据

    数据共享方法是通过让两个或多个进程映射同一个文件映射对象的视图来实现的,这意味着它们将共享物理存储器的同一个页面.因此,当一个进程将数据写入一个共享文件映射对象的视图时,其他进程可以立即看到它们视图中 ...

  9. MongoDB内存映射文件

    2019独角兽企业重金招聘Python工程师标准>>> Mongodb源码分析--内存文件映射(MMAP) 内存映射文件原理探索 Linux 内存映射函数 mmap()函数详解 Li ...

最新文章

  1. Java的ClassLoader
  2. go 捕获网卡http_接口测试工具Postman(三)使用postman抓包捕获HTTP请求-Go语言中文社区...
  3. angelica类似_亲爱的当归(Angelica)是第一个让我哭泣的VR体验
  4. [JS性能优化专篇]
  5. 蚂蚁上市P8身价超亿,丢给我这几个牛逼的公众号
  6. redis压缩列表ziplist的连锁扩容
  7. 线程超时 php-fpm,php-fpm线程僵死导致网站无响应
  8. SQL语句处理一些修改、新增、删除、修改属性操作(MySql)
  9. 【汇编语言】DOSBox教程
  10. 本特利330505-02-02-02-00速度传感器
  11. 计算机桌面最下面的横条怎么去掉,win7系统桌面出现横条如何去除?桌面出现横条去除方法...
  12. PHP pdf转化为图片(PNG)
  13. w10桌面计算机图标箭头去除,完美W10如何去除桌面图标快捷方式小箭头
  14. MyEclipse 10.5下载地址及破解方法
  15. Maven filter 导致打包以后的excel文件损坏的问题
  16. 深入理解AQS之ReentrantReadWriteLock详解
  17. vue--百度地图之离线地图
  18. Win10运行LoadRunner11录制脚本无法启动浏览器
  19. 导弹追踪飞机c语言编程,防御导弹 (C语言代码)
  20. KDD CUP 99数据集分析

热门文章

  1. javascript 使用canvas绘画
  2. 2010年的最后一天,我又辞工(日记)
  3. pytorch---之halfTensor
  4. 1.3 线性回归的sklearn实现
  5. pycharm双击没有反应(Idea机制与之相同)
  6. (一)Linux下C++ OpenCV开发环境搭建
  7. android usb虚拟串口,USB 虚拟串口简介
  8. linux阵列建立分区,在Linux上创建磁盘阵列———RAID-5
  9. cas4.0 mysql_【SSO单点系列】:CAS4.0 CAS整合SpringMVC+MyBatis实现数据库校验(04)
  10. java定义一个空数组_一个 Java 方法,最多能定义多少参数?