hibernate 映射文件中id 及id Generator的详解

本文翻译自hibernate3.3.1有参考资料（hibernate reference）的5.1.4 id及5.1.4.1 Generator。

一、id

被映射的实体类必须声明一个对应数据库表主键列的属性。大多数类有一个JavaBeans风格的代表此实例唯一标识的属性。<id> 元素定义了该属性到数据库表主键字段的映射。

 <id  name="propertyName"
   (1)  type="typename"
   (2)  column="column_name"
   (3)  unsaved-value="null|any|none|undefined|id_value"
   (4)  access="field|property|ClassName">
   (5)  node="element-name|@attribute-name|element/@attribute|."
       <generator class="generatorClass"/>
 </id>

 

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

(2) type (可选): 标识Hibernate类型的名字。 
(3) column (可选 - 默认为实体类的属性名): 数据库表中主键字段的名字。 
(4) unsaved-value (可选 - 默认为一个合情理的值): 一个特定的标识属性值，用来标志该实例是刚刚创建的，尚未保存(unsaved)，其实就是一个瞬时对象。根据这个值，可以把这种瞬时对象和那种已调用session的save方法保存过以及装载过（loaded）的脱管(detached)对象明确区分开来。

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

 

如果 name属性缺失的话，就可以假定这个类是没有标识属性的。

 

unsaved-value属性对Hibernate3来说基本上是不必要的。

 

还有一个供选择的<composite-id>声明可以访问旧式的多主键数据。我们强烈不鼓励使用这种方式。

二、Generator

可选的<generator>子元素是 一个Java类的名称，用来生成该持久化类实例的唯一标识符。如果这个生成器实例需要某些配置值或者初始化参数，可以使用<param>元素来传递这些参数。

 <id name="id" type="long" column="cat_id">
 <generator class="org.hibernate.id.TableHiLoGenerator">
 <param name="table">uid_table</param>
 <param name="column">next_hi_value_column</param>
 </generator>
 </id>

 

 所有的生成器都实现了org.hibernate.id.IdentifierGenerator接口。这是一个非常简单的接口；某些应用程序可以选择提供他们自己特定的实现。当然，Hibernate提供了很多内置的实现。下面是一些内置生成器的快捷名字：

 

increment（递增） 
用于为long, short或者int类型生成唯一标识。只有在没有其他进程往同一张表中插入数据时才能使用。 在集群下不要使用。

identity (标识)
对DB2,MySQL, MS SQL Server, Sybase和HypersonicSQL的内置标识字段提供支持。返回的标识符是long, short 或者int类型的。

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

hilo （高低位） 
使用一个高/低位算法来高效的生成long, short或者 int类型的标识符。给定一个表和字段（默认分别是hibernate_unique_key 和next_hi）作为高位值的来源。高/低位算法生成的标识符只在一个特定的数据库中是唯一的。

seqhilo（使用序列的高低位） 
使用一个高/低位算法来高效的生成long, short或者 int类型的标识符，给定一个数据库序列（sequence)的名字。

uuid
用一个128位的UUID算法生成字符串类型的标识符。在一个网络中唯一（使用了IP地址）。UUID被编码为一个32位16进制数字的字符串。

 

guid

在MS SQL Server 和 MySQL 中使用数据库生成的GUID字符串。

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

assigned (自行分配)
主键由外部程序负责生成，无需Hibernate参与 让应用程序在save()方法调用之前为对象分配一个标示符。这是 <generator>元素没有指定时的默认生成策略。

 

select 
通过数据库触发器选择一些唯一主键的行并返回主键值来分配一个主键。

foreign（外部引用） 
使用另外一个相关联的对象的标识符。常常和<one-to-one>联合一起使用。

 

以下内容摘自：http://ohgrateboy.iteye.com/blog/511019

一：主键生成策略大体分类： 
1：hibernate 负责对主键ID赋值 
2：应用程序自己为主键ID赋值（不推荐使用） 
3：底层数据库为主键ID赋值 
二：具体用法 
1：increment：（跨平台的） 
以递增的方式为代理主键赋值，每次维护的当前实例中取出一个最大值，在最大值的基础之上再进行加法，适合只有单个应用进程访问数据的情况，否则会产生并发冲突问题（主键重复）。并且oid 的类型必须是long ,int ,short类型的。 
2：assigned :由程序员给赋值，（不建议使用） 
3：identity:是由底层的数据库来生成主键，他要求底层数据库支持自动增长，并且把主键定义成自动增长类型的 ，oid 必须是long ,int ,short 类型的。 
Oracle 不支持。Mysql 支持 
4：sequence:由底层的数据根据序列来生成主键。oracle ,db2数据库支持，mysql不支持 
5：native:(跨平台的) 
由hibernate 自己跟据不同的数据库的主键生成方式，自己选择生成方式（可以跨平台） 
6：hilo :（跨平台的），通过hi/lo算法实现主键的生成机制，但是需要额外的表来保存主键的生成历史,使用时要先插入一个值。 
使用规则： 通用性和安全性： 
7：seqhilo：取得sequence的值，来生成高位，产生id。 
但是只能使用于有sequence的数据库（oracle , db2）; 
8：uuid.hex: 
用系统时间和ip地址等具有天然唯一性的资源进行计算，生成id， 
全球唯一。生成的是一个128位的二进制数。然后把这个二进制数，转化成一个16进制的数（32位），再转化为字符串付给我们的id。那么我们的实体类的oid以及数据库的主键都需要随之改为字符串类型的。 
9：foreign 
用于共享主键的时候。（一对一主键关联）； 

原文链接：：http://ryxxlong.iteye.com/blog/612446

xml 代码

1. <id name=”id” column=”id” type=”java.lang.Integer”>  
2.     <generator class=”native”/>  
3. id>  

 

上面是一个简单的id映射配置，id属性对应映射类中的属性，column对应数据库中表字段。

重点是这个generator<generator></generator><generator class="native"></generator><generator class="”native”"></generator>，其中class属性可以有以下几种可选类型。

l         Assigned

主键由应用逻辑产生，即我们在代码里面指定id，数据交由Hibernate保存时，主键已经设置完成，无需Hibernate干预。

l         <st1:place w:st="on"><st1:city w:st="on">hilo</st1:city></st1:place>

通过hi/lo算法实现的主键生成机制，需要额外的数据库表保存主键生成历史状态。

l         seqhilo

与hilo类似，通过hi/lo算法实现的主键生成机制，只是主键历史状态保存在Sequence里，适合于支持sequence的数据库，例如Oracle。

l         increment

主键按数值顺序递增。此方式的实现机制为在当前应用实例中维持一个变量，以保存着当前的最大值，之后每次需要生成主键的时候将此值加1生成主键。这种方式产生的问题是：如果当前有多个实例访问数据库，那么由于各个实例各自维护主键状态，不同实例可能生成同样的主键，从而造成主键重复异常。因此如果同一数据库由多个实例访问，必须避免这种方式。

l         identity

采用数据库提供的主键生成机制，如SQLServer、MYSQL提供的自增主键生成机制。

l         sequence

采用数据库提供的sequence机制生成主键，如Oracle sequence。

l         native

同hibernate根据数据库适配器中的定义，自动采用identity、hilo、sequence中的一种作为主键生成机制。

l         uuid.hex

由hibernate基于128位惟一值产生算法，根据当前设备IP，时间，JVM启动时间，内部自增量等四个参数生成16进制数值(编码后以32位的字符串表示)作为主键。

l         uuid.string

和uuid.hex类似，只是生成的主键未生成编码(长度16位)，在某些数据库中可能出现问题，如PostgreSQL。

l         foreign

使用外部表的字段作为主键。

l         select

hibernate3中引入新的主键生成机制，主要针对遗留系统的改造工程。

(摘自《深入浅出Hibernate》)

原文链接：：：http://aone.iteye.com/blog/47746