POJO 类和数据库的映射文件*.hbm.xml
hbm:hibernate mapping
POJO 类和关系数据库之间的映射可以用一个XML文档来定义。
通过 POJO 类的数据库映射文件，Hibernate可以理解持久化类和数据表之间的对应关系，也可以理解持久化类属性与数据库表列之间的对应关系
在运行时 Hibernate 将根据这个映射文件来生成各种 SQL 语句
映射文件的扩展名为 .hbm.xml
映射文件说明
>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中可以同时定义多个类. 但更推荐为每个类都创建一个单独的映射文件
hibernate-mapping
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 (可选): 指定一个包前缀，如果在映射文档中没有指定全限定的类名， 就使用这个作为包名。
class
class 元素用于指定类和表的映射
-name:指定该持久化类映射的持久化类的类名
-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: 若设置为 false, 等价于所有的 <property> 元素的 update 属性为 false, 表示整个实例不能被更新. 默认为 true.
-discriminator-value: 指定区分不同子类的值. 当使用 <subclass/> 元素来定义持久化类的继承关系时需要使用该属性
映射对象标识符
Hibernate 使用对象标识符(OID) 来建立内存中的对象和数据库表中记录的对应关系. 对象的 OID 和数据表的主键对应. Hibernate 通过标识符生成器来为主键赋值
Hibernate 推荐在数据表中使用代理主键, 即不具备业务含义的字段. 代理主键通常为整数类型, 因为整数类型比字符串类型要节省更多的数据库空间.
在对象-关系映射文件中, <id> 元素用来设置对象标识符. <generator> 子元素用来设定标识符生成器.
Hibernate 提供了标识符生成器接口: IdentifierGenerator, 并提供了各种内置实现
id
id：设定持久化类的 OID 和表的主键的映射
name: 标识持久化类 OID 的属性名
column: 设置标识属性所映射的数据表的列名(主键字段的名字).
unsaved-value:若设定了该属性, Hibernate 会通过比较持久化类的 OID 值和该属性值来区分当前持久化类的对象是否为临时对象
type:指定 Hibernate 映射类型. Hibernate 映射类型是 Java 类型与 SQL 类型的桥梁. 如果没有为某个属性显式设定映射类型, Hibernate 会运用反射机制先识别出持久化类的特定属性的 Java 类型, 然后自动使用与之对应的默认的 Hibernate 映射类型
type字段的值既可以为持久化对象属性的java类型也可以是hibernate映射类型
Java 的基本数据类型和包装类型对应相同的 Hibernate 映射类型. 基本数据类型无法表达 null, 所以对于持久化类的 OID 推荐使用包装类型
generator
generator：设定持久化类的标识符生成器
class: 指定使用的标识符生成器全限定类名或其缩写名
主键生成策略generator
Hibernate提供的内置标识符生成器:
increment 标识符生成器
increment 标识符生成器由 Hibernate 以递增的方式为代理主键赋值
Hibernate 会先读取目标表中的主键的最大值, 而接下来向目标表中插入记录时, 就在 max(id) 的基础上递增, 增量为 1.
解读：其工作原理是在插入记录到目标表之前先获取目标表主键的最大值，然后用最大值加一作为新主键插入数据。这个方式在并发场景会引起主键冲突，实际项目中较少使用。
适用范围:
由于 increment 生存标识符机制不依赖于底层数据库系统, 因此它适合所有的数据库系统
适用于只有单个 Hibernate 应用进程访问同一个数据库的场合, 在集群环境下不推荐使用它
OID 必须为 long, int 或 short 类型, 如果把 OID 定义为 byte 类型, 在运行时会抛出异常
identity 标识符生成器
identity 标识符生成器由底层数据库来负责生成标识符, 它要求底层数据库把主键定义为自动增长字段类型
适用范围:
由于 identity 生成标识符的机制依赖于底层数据库系统, 因此, 要求底层数据库系统必须支持自动增长字段类型. 支持自动增长字段类型的数据库包括: DB2, Mysql, MSSQLServer, Sybase 等
OID 必须为 long, int 或 short 类型, 如果把 OID 定义为 byte 类型, 在运行时会抛出异常
sequence 标识符生成器
sequence 标识符生成器利用底层数据库提供的序列来生成标识符.
Hibernate 在持久化一个 目标对象时, 先从底层数据库的 news_seq 序列中获得一个唯一的标识号, 再把它作为主键值
适用范围:
由于 sequence 生成标识符的机制依赖于底层数据库系统的序列, 因此, 要求底层数据库系统必须支持序列. 支持序列的数据库包括: DB2, Oracle 等
OID 必须为 long, int 或 short 类型, 如果把 OID 定义为 byte 类型, 在运行时会抛出异常
hilo 标识符生成器
hilo 标识符生成器由 Hibernate 按照一种 high/low 算法生成标识符, 它从数据库的特定表的字段中获取 high 值.
Hibernate 在持久化一个 目标对象时, 由 Hibernate 负责生成主键值. hilo 标识符生成器在生成标识符时, 需要读取并修改 HI_TABLE 表中的 NEXT_VALUE 值.
适用范围:
由于 hilo 生存标识符机制不依赖于底层数据库系统, 因此它适合所有的数据库系统
OID 必须为 long, int 或 short 类型, 如果把 OID 定义为 byte 类型, 在运行时会抛出异常
hilo 和 seqhilo生成器给出了两种hi/lo算法的实现
第一种情况：
<id name="id" type="id" column="id">
<generator class="hilo">
<param name="table">zhxy_hilo_tbl</param>
<param name="column">next_value</param>
<param name="max_lo">100</param>
</generator>
</id>
第二种情况
<id name="id" type="long" column="cat_id">
<generator class="seqhilo">
<param name="sequence">hi_value</param>
<param name="max_lo">100</param>
</generator>
</id>
第二种情况需要sequence的支持，这里只讨论更通用的第一种情况
默认请况下使用的表是
hibernate_unique_key，默认字段叫作next_hi。next_hi必须有一条记录否则会出现错误。
几个简写解释：
hi：高值-从数据库取得的那个值
lo：低值-hibernate自动维护，取值1到max_low
max_low:映射文件中配置的那个值
那hibernate怎样生成主键呢？
1.从数据库中取得hi值，数据库的next_value值加1
2.hibernate取得lo值（0到max_lo-1循环，lo到max_lo时，执行步骤1，然后lo继续从0到max_lo-1循环）
根据下面的公式计算值：
hi*(max_lo+1)+lo;
例如hi初始为2，max_lo为3
生成的值依次是：
读取hi为2，写到数据库为3
2*(3+1)+0=8
2*(3+1)+1=9
2*(3+1)+2=10
2*(3+1)+3=11
这有次读写表zhxy_hilo_tbl操作，hi变为3，数据库成为4
3*(3+1)+0=12
3*(3+1)+1=13
关闭数据库，下次打开时，读取hi值为4，数据库变为5
4*(3+1)+0=16
但是有一种特殊情况，就是hi是0的时候，那么第一个值不是0*(max_lo+1)+0=0
而是跳过0，直接就是1
native 标识符生成器
native 标识符生成器依据底层数据库对自动生成标识符的支持能力, 来选择使用 identity, sequence 或 hilo 标识符生成器.
适用范围:
由于 native 能根据底层数据库系统的类型, 自动选择合适的标识符生成器, 因此很适合于跨数据库平台开发
OID 必须为 long, int 或 short 类型, 如果把 OID 定义为 byte 类型, 在运行时会抛出异常
Property
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 等类型的数据列有效.
-formula：设置一个 SQL 表达式, Hibernate 将根据它来计算出派生属性的值.
派生属性: 并不是持久化类的所有属性都直接和表的字段匹配, 持久化类的有些属性的值必须在运行时通过计算才能得出来, 这种属性称为派生属性。使用 formula 属性时，formula=“(sql)” 的英文括号不能少。Sql 表达式中的列名和表名都应该和数据库对应, 而不是和持久化对象的属性对应。如果需要在 formula 属性中使用参数, 这直接使用 where cur.id=id 形式, 其中 id 就是参数, 和当前持久化对象的 id 属性对应的列的 id 值将作为参数传入.
Java 类型, Hibernate 映射类型及 SQL 类型之间的对应关系
映射类型 java 类型 标准 sql 类型
integer int or Integer INTEGER
long long or java.lang.Long BIGINT
short short or java.lang.Short SMALLINT
float float or java.lang.Float FLOAT
double double or java.lang.Double DOUBLE
big_decimal java.math.BigDecimal NUMERIC
character java.lang.String CHAR(1)
string java.lang.String VARCHAR
byte byte or java.lang.Byte TINYINT
boolean boolean or java.lang.Boolean BIT
yes_no boolean or java.lang.Boolean CHAR(1)('Y' or 'N')
true_false boolean or java.lang.Boolean CHAR(1)('Y' or 'N')
date java.util.Date or java.sql.Date DATE
time java.util.Date or java.sql.Time TIME
timestamp java.util.Date or java.sql.TimeStamp TIMESTAMP
calendar java.util.Calendar TIMESTAMP
calendar_date java.util.Calendar DATE
binary byte[] VARBINARY( or BLOB)
text java.lang.String CLOB
serializable java.io.Serializable VARBINARY (or BLOB)
clob java.sql.Clob CLOB
blob java.sql.Blob BLOB
class java.lang.Class VARCHAR
locale java.util.Locale VARCHAR
timezone java.util.TimeZone VARCHAR
currency java.util.Currency VARCHAR
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 内置映射类型
以下情况下必须显式指定 Hibernate 映射类型
一个 Java 类型可能对应多个 Hibernate 映射类型. 例如: 如果持久化类的属性为 java.util.Date 类型, 对应的 Hibernate 映射类型可以是 date, time 或 timestamp. 此时必须根据对应的数据表的字段的 SQL 类型, 来确定 Hibernate 映射类型. 如果字段为 DATE 类型, 那么 Hibernate 映射类型为 date; 如果字段为 TIME 类型, 那么 Hibernate 映射类型为 time; 如果字段为 TIMESTATMP 类型, 那么 Hibernate 映射类型为 timestamp.
示例
1. 模型类
package org.rabbitx.hibernate4.mapping.date;
import java.util.Date;
public class DateBean {
private Integer id;
private Date date;
private Date time;
private Date timestamp;
public Integer getId() {
return id;
}
public void setId(Integer id) {
this.id = id;
}
public Date getDate() {
return date;
}
public void setDate(Date date) {
this.date = date;
}
public Date getTime() {
return time;
}
public void setTime(Date time) {
this.time = time;
}
public Date getTimestamp() {
return timestamp;
}
public void setTimestamp(Date timestamp) {
this.timestamp = timestamp;
}
}
2. 映射文件配置(使用sql-type类精确配置)
<?xml version="1.0"?>
<!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">
<!-- Generated 2015-8-21 9:12:13 by Hibernate Tools 3.4.0.CR1 -->
<hibernate-mapping>
<class name="org.rabbitx.hibernate4.mapping.date.DateBean" table="TBL_DATEBEAN">
<id name="id" type="java.lang.Integer">
<column name="ID" />
<generator class="native" />
</id>
<property name="date">
<column name="DATE" sql-type="date"/>
</property>
<property name="time">
<column name="TIME" sql-type="time"/>
</property>
<property name="timestamp">
<column name="TIMESTAMP" sql-type="timestamp"/>
</property>
</class>
</hibernate-mapping>
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 更方便
示例
1. 添加模型类
package org.rabbitx.hibernate4.mapping;
import java.sql.Blob;
public class LobBean {
private Integer id;
private String content;
private Blob image;
public Integer getId() {
return id;
}
public void setId(Integer id) {
this.id = id;
}
public String getContent() {
return content;
}
public void setContent(String content) {
this.content = content;
}
public Blob getImage() {
return image;
}
public void setImage(Blob image) {
this.image = image;
}
}
2. 添加映射配置文件
<?xml version="1.0"?>
<!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">
<!-- Generated 2015-8-21 9:53:54 by Hibernate Tools 3.4.0.CR1 -->
<hibernate-mapping>
<class name="org.rabbitx.hibernate4.mapping.LobBean" table="TBL_LOBBEAN">
<id name="id" type="java.lang.Integer">
<column name="ID" />
<generator class="native" />
</id>
<!-- 映射大对象 -->
<!-- 若希望精确映射 SQL 类型, 可以使用 sql-type 属性. -->
<property name="content">
<column name="CONTENT" sql-type="mediumtext"></column>
</property>
<property name="image">
<column name="IMAGE" sql-type="mediumblob"></column>
</property>
</class>
</hibernate-mapping>
3. 添加测试代码
/**
* Blob类型测试
* 把图片存入数据库
* @throws IOException
*/
@Test
public void testBlob001() throws IOException
{
InputStream input = new FileInputStream("image/girls.jpg");
Blob image = Hibernate.getLobCreator(session).createBlob(input, input.available());
LobBean bean = new LobBean();
bean.setContent("girls");
bean.setImage(image);
session.save(bean);
}
/**
* 从数据库下载图片
* @throws IOException/SQLException
*/
@Test
public void testBlob002() throws IOException, SQLException
{
LobBean bean = (LobBean)session.get(LobBean.class, 1);
InputStream input = bean.getImage().getBinaryStream();
OutputStream output = new FileOutputStream("download.jpg");
byte[] buf = new byte[1024];
int len = -1;
while((len = input.read(buf)) != -1)
{
output.write(buf, 0, len);
}
input.close();
output.flush();
output.close();
}
映射组成关系
建立域模型和关系数据模型有着不同的出发点:
域模型: 由程序代码组成, 通过细化持久化类的的粒度可提高代码的可重用性, 简化编程
组成关系中, 整件拥有部件的生命周期, 所以整件删除时, 部件一定会跟着删除. 而且, 多个整件不可以同时共享同一个部件。
在没有数据冗余的情况下, 应该尽可能减少表的数目, 简化表之间的参照关系, 以便提高数据的访问速度
Hibernate 把持久化类的属性分为两种:
值(value)类型：没有 OID, 不能被单独持久化, 生命周期依赖于所属的持久化类的对象的生命周期
实体(entity)类型：有 OID, 可以被单独持久化, 有独立的生命周期
显然无法直接用 property 映射 pay 属性
Hibernate 使用 <component> 元素来映射组成关系, 该元素表明 pay 属性是 Worker 类一个组成部分, 在 Hibernate 中称之为组件
component
-<component> 元素来映射组成关系
class:设定组成关系属性的类型, 此处表明 pay 属性为 Pay 类型
-<parent> 元素指定组件属性所属的整体类
name: 整体类在组件类中的属性名
示例
1. 添加模型类
package org.rabbitx.hibernate4.mapping.component;
public class Worker {
private Integer id;
private String name;
private Pay pay;
setter,getter method ...
}
package org.rabbitx.hibernate4.mapping.component;
public class Pay {
private int monthlyPay;
private int yearPay;
private int vocationWithPay;
private Worker worker;
setter,getter method ...
}
2. 添加映射文件
<?xml version="1.0"?>
<!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">
<hibernate-mapping package="org.rabbitx.hibernate4.mapping.component">
<class name="Worker" table="TBL_WORKER">
<id name="id" type="java.lang.Integer">
<column name="ID" />
<generator class="native" />
</id>
<property name="name" type="java.lang.String">
<column name="NAME" />
</property>
<!-- 映射组成关系 -->
<component name="pay" class="Pay">
<parent name="worker"/>
<!-- 指定组成关系的组件的属性 -->
<property name="monthlyPay" column="MONTHLY_PAY"></property>
<property name="yearPay" column="YEAR_PAY"></property>
<property name="vocationWithPay" column="VOCATION_WITH_PAY"></property>
</component>
</class>
</hibernate-mapping>
3. 进行测试
/**
* component测试
*/
@Test
public void testComponent001() throws IOException
{
Pay pay = new Pay();
pay.setMonthlyPay(11);
pay.setVocationWithPay(12);
pay.setYearPay(13);
Worker worker = new Worker();
worker.setName("test component");
worker.setPay(pay);
session.save(worker);
}
@Test
public void testComponent002() throws IOException
{
Worker worker = (Worker)session.get(Worker.class, 1);
System.out.println(worker);
}