## 7 Hibernate对象关系映射文件

Java源码网 8月前 ⋅ 289 阅读

7 Hibernate对象关系映射文件

7.1 对象关系映射文件概述

POJO 类和数据库的映射文件*.hbm.xml

  • POJO 类和关系数据库之间的映射可以用一个XML文档来定义。
  • 通过 POJO 类的数据库映射文件,Hibernate可以理解持久化类和数据表之间的对应关系,也可以理解持久化类属性与数据库表列之间的对应关系
  • 在运行时 Hibernate 将根据这个映射文件来生成各种 SQL 语句
  • 映射文件的扩展名为 .hbm.xml

7.2 映射文件说明

hibernate-mapping

  • 类层次:class
    • 主键:id
    • 基本类型:property
    • 实体引用类: many-to-one | one-to-one
    • 集合:set | list | map | array
      • one-to-many
      • many-to-many
    • 子类:subclass | joined-subclass
    • 其它:component | any 等
  • 查询语句:query(用来放置查询语句,便于对数据库查询的统一管理和优化) 每个Hibernate-mapping中可以同时定义多个类. 但更推荐为每个类都创建一个单独的映射文件

7.2.1 元素属性(root元素)

hibernate-mapping 是 hibernate 映射文件的根元素

  • schema: 指定所映射的数据库schema的名称。若指定该属性, 则表明会自动添加该 schema 前缀
  • catalog:指定所映射的数据库catalog的名称。
  • default-cascade(默认为 none): 设置hibernate默认的级联风格. 若配置 Java 属性, 集合映射时没有指定 cascade 属性, 则 Hibernate 将采用此处指定的级联风格.
  • default-access (默认为 property): 指定 Hibernate 的默认的属性访问策略。默认值为 property, 即使用 getter, setter 方法来访问属性. 若指定 access, 则 Hibernate 会忽略 getter/setter 方法, 而通过反射访问成员变量.
  • default-lazy(默认为 true): 设置 Hibernat morning的延迟加载策略. 该属性的默认值为 true, 即启用延迟加载策略. 若配置 Java 属性映射, 集合映射时没有指定 lazy 属性, 则 Hibernate 将采用此处指定的延迟加载策略
  • auto-import (默认为 true): 指定是否可以在查询语言中使用非全限定的类名(仅限于本映射文件中的类)。
  • package (可选): 指定一个包前缀,如果在映射文档中没有指定全限定的类名, 就使用这个作为包名。

7.2.2 元素属性(hibernate-mapping子元素)

class 元素用于指定类和表的映射

  • name:指定该持久化类映射的持久化类的类名(与package配合使用)
  • table:指定该持久化类映射的表名, Hibernate 默认以持久化类的类名作为表名
  • dynamic-insert: 若设置为 true, 表示当保存一个对象时, 会动态生成 insert 语句, insert 语句中仅包含所有取值不为 null 的字段. 默认值为 false
  • dynamic-update: 若设置为 true, 表示当更新一个对象时, 会动态生成 update 语句, update 语句中仅包含所有取值需要更新的字段. 默认值为 false
  • select-before-update:设置 Hibernate 在更新某个持久化对象之前是否需要先执行一次查询. 默认值为 false
  • batch-size:指定根据 OID 来抓取实例时每批抓取的实例数.
  • lazy: 指定是否使用延迟加载.
  • mutable: 若设置为 true, 等价于所有的 元素的 update 属性为 false, 表示整个实例不能被更新. 默认为 true.
  • discriminator-value: 指定区分不同子类的值. 当使用 元素来定义持久化类的继承关系时需要使用该属性
7.2.2.1 映射对象标识符
  • Hibernate 使用对象标识符(OID) 来建立内存中的对象和数据库表中记录的对应关系. 对象的 OID 和数据表的主键对应. Hibernate 通过标识符生成器来为主键赋值
  • Hibernate 推荐在数据表中使用代理主键, 即不具备业务含义的字段. 代理主键通常为整数类型, 因为整数类型比字符串类型要节省更多的数据库空间.
  • 在对象-关系映射文件中, 元素用来设置对象标识符. 子元素用来设定标识符生成器.
  • Hibernate 提供了标识符生成器接口: IdentifierGenerator, 并提供了各种内置实现

7.2.3 元素属性(class元素子元素)

id元素设定持久化类的 OID 和表的主键的映射

  • name: 标识持久化类 OID 的属性名
  • column: 设置标识属性所映射的数据表的列名(主键字段的名字).
  • unsaved-value:若设定了该属性, Hibernate 会通过比较持久化类的 OID 值和该属性值来区分当前持久化类的对象是否为临时对象
  • type:指定 Hibernate 映射类型. Hibernate 映射类型是 Java 类型与 SQL 类型的桥梁. 如果没有为某个属性显式设定映射类型, Hibernate 会运用反射机制先识别出持久化类的特定属性的 Java 类型, 然后自动使用与之对应的默认的 Hibernate 映射类型
  • Java 的基本数据类型和包装类型对应相同的 Hibernate 映射类型. 基本数据类型无法表达 null, 所以对于持久化类的 OID 推荐使用包装类型

7.2.4 元素属性(id元素子元素)

generator:设定持久化类设定标识符生成器

  • class: 指定使用的标识符生成器全限定类名或其缩写名
7.2.4.1 主键生成策略
标识符生成器查询方法
increment适用代理主键。由Hibernate自动以自增的方式生成(只适用于测试范围)
identity适用代理主键。由底层数据库生成标识符
sequence适用代理主键。Hibernate根据底层数据库的序列生成标识符,这要求底层数据库支持序列
hilo适用代理主键。Hibernate分局high/low算法生成标识符
seqhilo适用代理主键。使用一个高/低位算法来高校的生成long,short或者int类型的标识符
native适用代理主键。根据底层数据库对自动生成标识符的方式,自动选择identity,sequence或者hilo
uuid.hex适用代理主键。hibernate采用128位的UUID算法生成标识符
uuid.string适用代理主键。UUID被编码为16字符长度的字符串
assigned自然主键。有Java应用程序负责生成标识符
foreign适用代理主键。使用另外一个相关联的对象标识符
7.2.4.1.1 主键生成策略-INCREMENT

increment 标识符生成器由 Hibernate 以递增的方式为代理主键赋值。Hibernate 会先读取 NEWS 表中的主键的最大值, 而接下来向 NEWS 表中插入记录时, 就在 max(id) 的基础上递增, 增量为 1.

  • 适用范围:
    • 由于 increment 生存标识符机制不依赖于底层数据库系统, 因此它适合所有的数据库系统
    • 适用于只有单个 Hibernate 应用进程访问同一个数据库的场合, 在集群环境下不推荐使用它
    • OID 必须为 long, int 或 short 类型, 如果把 OID 定义为 byte 类型, 在运行时会抛出异常
Hibernate:
    select
        max(EMPNO) 
    from
        EMP
Hibernate: 
    insert 
    into
        SCOTT.EMP
        (ENAME, EMPNO) 
    values
        (?, ?)
7.2.4.1.2 主键生成策略-IDENTITY

identity 标识符生成器由底层数据库来负责生成标识符, 它要求底层数据库把主键定义为自动增长字段类型

  • 适用范围:
    • 由于 identity 生成标识符的机制依赖于底层数据库系统, 因此, 要求底层数据库系统必须支持自动增长字段类型. 支持自动增长字段类型的数据库包括: DB2, Mysql, MSSQLServer, Sybase 等
    • OID 必须为 long, int 或 short 类型, 如果把 OID 定义为 byte 类型, 在运行时会抛出异常 由于Oracle不支持主键自增长,所以使用该种方式指定主键生成策略会抛出异常:SQLIntegrityConstraintViolationException
7.2.4.1.3 主键生成策略-SEQUENCE

sequence 标识符生成器利用底层数据库提供的序列来生成标识符. Hibernate 在持久化一个 News 对象时, 先从底层数据库的 news_seq 序列中获得一个唯一的标识号, 再把它作为主键值

  • 适用范围:
    • 由于 sequence 生成标识符的机制依赖于底层数据库系统的序列, 因此, 要求底层数据库系统必须支持序列. 支持序列的数据库包括: DB2, Oracle 等
    • OID 必须为 long, int 或 short 类型, 如果把 OID 定义为 byte 类型, 在运行时会抛出异常
Hibernate: 
    select
        hibernate_sequence.nextval 
    from
        dual
Hibernate: 
    insert 
    into
        SCOTT.EMP
        (ENAME, EMPNO) 
    values
        (?, ?)
7.2.4.1.4 主键生成策略-HILO

hilo 标识符生成器由 Hibernate 按照一种 high/low 算法*生成标识符, 它从数据库的特定表的字段中获取 high 值. Hibernate 在持久化一个 News 对象时, 由 Hibernate 负责生成主键值. hilo 标识符生成器在生成标识符时, 需要读取并修改 HI_TABLE 表中的 NEXT_VALUE 值.

  • 适用范围:
    • 由于 hilo 生存标识符机制不依赖于底层数据库系统, 因此它适合所有的数据库系统
    • OID 必须为 long, int 或 short 类型, 如果把 OID 定义为 byte 类型, 在运行时会抛出异常
Hibernate: 
    select
        next_hi 
    from
        hibernate_unique_key for update
            
Hibernate: 
    update
        hibernate_unique_key 
    set
        next_hi = ? 
    where
        next_hi = ?
Hibernate: 
    insert 
    into
        SCOTT.EMP
        (ENAME, EMPNO) 
    values
        (?, ?)
7.2.4.1.5 主键生成策略-NATIVE

native 标识符生成器依据底层数据库对自动生成标识符的支持能力, 来选择使用 identity, sequence 或 hilo 标识符生成器.

  • 适用范围:
    • 由于 native 能根据底层数据库系统的类型, 自动选择合适的标识符生成器, 因此很适合于跨数据库平台开发
    • OID 必须为 long, int 或 short 类型, 如果把 OID 定义为 byte 类型, 在运行时会抛出异常
Hibernate: 
    select
        hibernate_sequence.nextval 
    from
        dual
Hibernate: 
    insert 
    into
        SCOTT.EMP
        (ENAME, EMPNO) 
    values
        (?, ?)
7.2.4.1.6 主键生成策略-UUID

The UUID contains: IP address, startup time of the JVM that is accurate to a quarter second, system time and a counter value that is unique within the JVM. It is not possible to obtain a MAC address or memory address from Java code, so this is the best option without using JNI.

7.2.5 元素属性(class元素子元素)

property 元素用于指定类的属性和表的字段的映射

  • name:指定该持久化类的属性的名字
  • column:指定与类的属性映射的表的字段名. 如果没有设置该属性, Hibernate 将直接使用类的属性名作为字段名.
  • type:指定 Hibernate 映射类型. Hibernate 映射类型是 Java 类型与 SQL 类型的桥梁. 如果没有为某个属性显式设定映射类型, Hibernate 会运用反射机制先识别出持久化类的特定属性的 Java 类型, 然后自动使用与之对应的默认的 Hibernate 映射类型.
  • not-null:若该属性值为 true, 表明不允许为 null, 默认为 false
  • access:指定 Hibernate 的默认的属性访问策略。默认值为 property, 即使用 getter, setter 方法来访问属性. 若指定 field, 则 Hibernate 会忽略 getter/setter 方法, 而通过反射访问成员变量
  • unique: 设置是否为该属性所映射的数据列添加唯一约束.
  • index: 指定一个字符串的索引名称. 当系统需要 Hibernate 自动建表时, 用于为该属性所映射的数据列创建索引, 从而加快该数据列的查询.
  • length: 指定该属性所映射数据列的字段的长度
  • scale: 指定该属性所映射数据列的小数位数, 对 double, float, decimal 等类型的数据列有效.
  • update: 指定该属性是否可以被修改,默认为true,意为可以修改
  • formula:设置一个 SQL 表达式, Hibernate 将根据它来计算出派生属性的值.
    • formula=“(sql)” 的英文括号不能少
    • Sql 表达式中的列名和表名都应该和数据库对应, 而不是和持久化对象的属性对应
    • 如果需要在 formula 属性中使用参数, 这直接使用 where cur.id=id 形式, 其中 id 就是参数, 和当前持久化对象的 id 属性对应的列的 id 值将作为参数传入.
  • 派生属性: 并不是持久化类的所有属性都直接和表的字段匹配, 持久化类的有些属性的值必须在运行时通过计算才能得出来, 这种属性称为派生属性

注意:Oracle的Concat函数只支持两个参数的链接(多参数链接需要使用||连接符),如果concat函数有三个及以上参数,将会抛出如下异常:

java.sql.SQLSyntaxErrorException: ORA-00909: invalid number of arguments

7.3 映射文件说明Java类型、Hibernate类型、标准SQL类型对应关系

参见:http://docs.jboss.org/hibernate/orm/5.2/userguide/html_single/Hibernate_User_Guide.html#basic

7.4 Java 时间和日期类型的 Hibernate 映射

  • 在 Java 中, 代表时间和日期的类型包括: java.util.Date 和 java.util.Calendar. 此外, 在 JDBC API 中还提供了 3 个扩展了 java.util.Date 类的子类: java.sql.Date, java.sql.Time 和 java.sql.Timestamp, 这三个类分别和标准 SQL 类型中的 DATE, TIME 和 TIMESTAMP 类型对应
  • 在标准 SQL 中, DATE 类型表示日期, TIME 类型表示时间, TIMESTAMP 类型表示时间戳, 同时包含日期和时间信息.
Hibernate type (org.hibernate.type package)JDBC typeJava typeBasicTypeRegistry key(s)
TimestampTypeTIMESTAMPjava.sql.Timestamptimestamp, java.sql.Timestamp
TimeTypeTIMEjava.sql.Timetime, java.sql.Time
DateTypeDATEjava.sql.Datedate, java.sql.Date
CalendarTypeTIMESTAMPjava.util.Calendarcalendar, java.util.Calendar
CalendarDateTypeDATEjava.util.Calendarcalendar_date
CalendarTimeTypeTIMEjava.util.Calendarcalendar_time
  • 如何进行映射
  1. 因为java.util.Date是java.sql.Date java.sql.Time java.sql.Timestamp的父类,所以java.util.date可以对应比好准SQL中的 DATE, TIME 和 TIMESTAMP 类型对应
  2. 所以建议大家将持久化类中的时间类型定义为java.util.Date
  • 如何把 java.util.Date 映射为 DATE, TIME 和 TIMESTAMP ?

可以通过 property 的 type 属性来进行映射:

例如:

<property name="date" type="timestamp">
    <column name="DATE" />
</property>

<property name="date" type="data">
    <column name="DATE" />
</property>

<property name="date" type="time">
    <column name="DATE" />
</property>

其中 timestamp, date, time 既不是 Java 类型, 也不是标准 SQL 类型, 而是 hibernate 映射类型.

如果没有指定type,那么就会默认使用Date类型(即对应时间又对应日期)

7.5 Java 大对象类型的 Hiberante 映射

  • 在 Java 中, java.lang.String 可用于表示长字符串(长度超过 255), 字节数组 byte[] 可用于存放图片或文件的二进制数据. 此外, 在 JDBC API 中还提供了 java.sql.Clob 和 java.sql.Blob 类型, 它们分别和标准 SQL 中的 CLOB 和 BLOB 类型对应. CLOB 表示字符串大对象(Character Large Object), BLOB表示二进制对象(Binary Large Object)
  • Mysql 不支持标准 SQL 的 CLOB 类型, 在 Mysql 中, 用 TEXT, MEDIUMTEXT 及 LONGTEXT 类型来表示长度操作 255 的长文本数据
  • 在持久化类中, 二进制大对象可以声明为 byte[] 或 java.sql.Blob 类型; 字符串可以声明为 java.lang.String 或 java.sql.Clob
  • 实际上在 Java 应用程序中处理长度超过 255 的字符串, 使用 java.lang.String 比 java.sql.Clob 更方便

更多

相关笔记:《Hibernate学习》阅读笔记


全部评论: 0

    我有话说: