Hibernate映射文件*.hbm.xml的元素及属性详解

映射文件用于向 Hibernate 提供对象持久化到关系型数据库中的相关信息,每个映射文件的结构基本相同,其示例代码如下所示:
<?xml version="1.0" encoding="UTF-8"?>
<!--映射文件的dtd约束信息-->
<!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">
<hibernate-mapping>
    <!-- name代表的是完整类名(包含的类名),table代表的是表名 -->
    <class name="className" table="tableName">
        <!-- name代表的是className类中的唯一标识属性,column代表的是tableName表中的主键id -->
        <id name="id" column="id">
            <!-- 主键生成策略 -->
            <generator class="native" />
        </id>
        <!-- name表示className的普通属性 column表示tableName表的普通字段 type 表示字段类型-->
        <property name="attrName" column="fieIdName" type="string" />
    </class>
</hibernate-mapping>
在上述代码中,首先进行了 xml 声明,然后定义了映射文件的 dtd 信息,此 dtd 信息读者不需要去手写,可以在项目的 Web App Libraries 目录(或 Referenced Libraries 目录)中,找到 hibernate 的核心 JAR 包 hibernate3.jar,打开此 JAR 包后,在 org.hibernate 包中即可找到 hibernate-mapping-3.0.dtd 文件。

打开此文件后,在文件的最上方即有此 dtd 信息,只需要将此 dtd 信息复制到映射文件中使用即可。hibernate-mapping-3.0.dtd 文件中的 dtd 信息如图 1 所示。

映射文件的dtd信息
图 1  映射文件的 dtd 信息

在上述映射文件代码的 dtd 信息下面,就是 Hibernate 映射的具体配置。下面将对其配置中的每个元素的常用属性进行详细讲解。

1. <hibernate-mapping> 元素

<hibernate-mapping> 元素是映射文件的根元素,它所定义的属性在映射文件的所有节点都有效。<hibernate-mapping> 元素所包含的常用属性及其含义说明如表 1 所示。

表 1  <hibernate-mapping> 元素的常用属性及其说明
属性名 是否必须 说   明
package 为映射文件中的类指定一个包前缀,用于非全限定类名
schema 指定数据库 schema 名
catalog 指定数据库 catalog 名
default-access 否  指定 Hibernate 用于访问属性时所使用的策略,默认为 property。 当 default-access="property" 时,使用 getter 和 setter 方法访问成员变量;当 default-access = "field"时,使用反射访问成员变量
default-cascade 否  指定默认的级联样式,默认为空
default-lazy 指定 Hibernate 默认所采用的延迟加载策略,默认为 true

2. <class> 元素

<class> 元素主要用于指定持久化类和数据表的映射关系,它是 XML 配置文件中的主要配置内容。其常用属性及其含义说明如表 2 所示。
表 2 <class>元素的常用属性及其说明
属性名 是否必须 说   明
name 持久化类或接口的全限定名。如果未定义该属性,则 Hibernate 将 该映射视为非 POJO 实体的映射
table 持久化类对应的数据库表名,默认为持久化类的非限定类名
catalog 数据库 catalog 名称,如果指定该属性,则会覆盖 hibernate-mapping 元素中指定的 catalog 属性值
lazy 指定是否使用延迟加载

3. <id>元素

<class> 元素内包含了一个 <id> 元素,该属性用于设定持久化类的 OID(Object identifier,对象标识符)和表的主键的映射,其常用属性及其含义说明如表 3 所示。
表 3 <id>元素常用属性及其说明
属性名 是否必须 说   明
name 标识持久化类 OID 的属性名
type 持久化类中标识属性的数据类型。如果没有为某个属性显式设定映射类型,Hibernate 会运用反射机制先识别出持久化类的特定属性的 Java 类型,然后自动使用与之对应的默认 Hibernate 映射类型。
Java 的基本数据类型和包装类型对应相同的 Hibernate 映射类型,基本数据类型无法表达 null,所以对于持久化类的 OID,推荐使用包装类型(integer,long,string 等)
column 设置标识属性所映射的数据列的列名(主键字段的名字)
access 指定 Hibernate 对标识属性的访问策略,默认为 property。若此处指定了该属性,则会覆盖 <hibemate-mapping> 元素中指定的 default-access 属性

除了上面五个元素以外,<id> 元素还可以包含一个可选的子元素 <generator>。

<generator> 元素指定了主键的生成方式。对于不同的关系型数据库和业务应用来说,其主键的生成方式往往也不同,有的是依赖数据库自增字段生成主键,有的是按照具体的应用逻辑决定,通过 <generator> 元素就可以指定这些不同的实现方式。这些实现方式在 Hibernate 中,又称为主键生成策略。

在讲解 Hibernate 的主键生成策略之前,需要先了解两个概念:自然主键和代理主键。关于这两个概念的描述如下。

1)自然主键

把具有业务含义的字段作为主键,称为自然主键。例如在 user 表中,如果把 name 字段作为主键,其前提条件必须是:每一个用户的姓名不允许为 null,不允许用户重名,并且不允许修改用户姓名。

尽管这些是可行的,但是不能满足不断变化的业务需求,一旦出现了允许用户重名的业务需求,就必须修改数据模型,重新定义表的主键,这给数据库的维护增加了难度。

2)代理主键

把不具备业务含义的字段作为主键,称为代理主键。该字段一般取名为 ID,通常为整数类型,因为整数类型比字符串类型可以节省更多的数据库空间。在上述例子中,显然更合理的方式是使用代理主键。

在 Hibernate 中,提供了几个内置的主键生成策略,其常用主键生成策略的名称和描述如表 4 所示。

表 4 主键生成策略
名   称 描   述
increment 用于 long.short 或 int 类型,由 Hibernate 自动以递增的方式生成唯一标识符,每次增量为 1。只有当没有其他进程向同一张表中插入数据时才可以使用,不能在集群环境下使用,适用于代理主键
identity 采用底层数据库自身提供的主键生成标识符,条件是数据库支持自动增长数据类型。在 DB2、MySQL、SQL Server、Sybase 和 HypersonicSQL 数据库中可以使用该生成器,该生成器要求在数据库中把主键定义成为自增长类型,适用于代理主键
sequence Hibernate 根据底层数据库序列生成标识符。条件是数据库支持序列,适用于代理主键
hilo 使用一个高/低位算法高效地生成 long、short 或 int 类型的标识符。给定一个表和字段(默认的表和字段分别为 hibernate_unique_key 和 next_hi)作为高位值的来源。高/低位算法产生的标识符仅在特定数据库中是唯一的
native  根据底层数据库对自动生成标识符的能力选择 identity、sequence、hilo 三种生成器中的一种,适合跨数据库平台开发,适用于代理主键
uuid Hibernate 采用 128 位的 UUID 算法生成标识符。该算法能够在网络环境中生成唯一的字符串标识符,其 UUID 被编码为一个长度为 32 位的十六进制字符串。这种策略并不流行,因为字符串类型的主键比整数类型的主键占用更多的数据库空间,适用于代理主键
assigned 由 java 程序负责生成标识符,如果不指定 id 元素的 generator 属性,则默认使用该主键生成策略,适用于自然主键

4)<property>元素

<class> 元素内可以包含多个 <property> 子元素,它用于表示持久化类的其他属性和数据表中非主键字段的映射关系。<property> 元素所包含的常用属性及其含义说明如表 5 所示。
表 5 <property>元素常用属性
属性名 说   明
name 持久化类属性的名称,以小写字母开头
column 数据表字段名
type 数据表的字段类型
length 数据表字段定义的长度
lazy 指定当持久化类的实例首次被访问时,是否对该属性使用延迟加载,其默认值是 false
unique 是否对映射列产生一个唯一性约束。常在产生 DDL 语句或创建数据库对象时使用
not-null 是否允许映射列为空