本文中将讲述hibernate的基本配置及配置文件的应用,这对于正确熟练使用hibernate是相当关键的。
配置文件中映射元素详解
对象关系的映射是用一个xml文档来说明的。映射文档可以使用工具来生成,如xdoclet,middlegen和andromda等。下面从一个映射的例子开始讲解映射元素,映射文件的代码如下。
<?xml version="1.0"?>
<!--
所有的xml映射文件都需要定义如下所示的doctype。
hibernate会先在它的类路径(classptah)中搜索dtd文件。
-->
<!doctype hibernate-mapping public
"-//hibernate/hibernate mapping dtd 3.0//en"
"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">
<!--
hibernate-mapping有几个可选的属性:
schema属性指明了这个映射的表所在的schema名称。
default-cascade属性指定了默认的级联风格 可取值有 none、save、update。
auto-import属性默认让我们在查询语言中可以使用非全限定名的类名 可取值有 true、false。
package属性指定一个包前缀。
-->
<hibernate-mapping schema="schemaname" default-cascade="none"
auto-import="true" package="test">
<!--用class元素来定义一个持久化类 -->
<class name="people" table="person">
<!-- id元素定义了属性到数据库表主键字段的映射。-->
<id name="id">
<!-- 用来为该持久化类的实例生成唯一的标识 -->
<generator class="native"/>
</id>
<!-- discriminator识别器 是一种定义继承关系的映射方法-->
<discriminator column="subclass" type="character"/>
<!-- property元素为类声明了一个持久化的,javabean风格的属性-->
<property name="name" type="string">
<column name="name" length="64" not-null="true" />
</property>
<property name="sex"
not-null="true"
update="false"/>
<!--多对一映射关系-->
<many-to-one name="friend"
column="friend_id"
update="false"/>
<!--设置关联关系-->
<set name="friends" inverse="true" order-by="id">
<key column="friend_id"/>
<!—一对多映射-->
<one-to-many class="cat"/>
</set>
</class>
</hibernate-mapping>
组件应用的方法
组件有两种类型,即组件(component)和动态组件(dynamic-component)。在配置文件中,component元素为子对象的元素与父类对应表的字段建立起映射关系。然后组件可以声明它们自己的属性、组件或者集合。component元素的定义如下所示:
<component name="propertyname" class="classname" insert="true|false"
upate="true|false" access="field|property|classname">
<property ...../>
<many-to-one .... />
........
</component>
在这段代码中,name是指属性名,class是类的名字,insert指的是被映射的字段是否出现在sql的insert语句中,upate指出被映射的字段是否出现在sql的update语句中,access指出访问属性的策略。
hiebernate的基本配置
hibernate的数据库连接信息是从配置文件中加载的。hibernate的配置文件有两种形式:一种是xml格式的文件,一种是properties属性文件。properties形式的配置文件默认文件名是hibernate.properties,一个properties形式的配置文件内容如下所示:
#指定数据库使用的驱动类
hibernate.connection.driver_class = com.mysql.jdbc.driver r
#指定数据库连接串
hibernate.connection.url = jdbc:mysql://localhost:3306/db
#指定数据库连接的用户名
hibernate.connection.username = user
#指定数据库连接的密码
hibernate.connection.password = password
#指定数据库使用的方言
hibernate.dialect = net.sf.hibernate.dialect.mysqldialect
#指定是否打印sql语句
hibernate.show_sql=true
在配置文件中包含了一系列属性的配置,hibernate将根据这些属性来连接数据库。
在xml格式的配置文件中,除了基本的hibernate配置信息,还可以指定具体的持久化类的映射文件,这可以避免将持久化类的配置文件硬编码在程序中。xml格式的配置文件的默认文件名为hibernate.cfg.xml,一个xml配置文件的示例如下所示:
<?xml version='1.0' encoding='utf-8'?>
<!doctype hibernate-configuration public
"-//hibernate/hibernate configuration dtd 3.0//en"
"http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd">
<hibernate-configuration>
<session-factory>
<!--显示执行的sql语句-->
<property name="show_sql">true</property>
<!--连接字符串-->
<property name="connection.url">jdbc:mysql://localhost:3306/stu</property>
<!--连接数据库的用户名-->
<property name="connection.username">root</property>
<!--数据库用户密码-->
<property name="connection.password">root</property>
<!--数据库驱动-->
<property name="connection.driver_class">com.mysql.jdbc.driver</property>
<!--选择使用的方言-->
<property name="dialect">org.hibernate.dialect.mysqldialect</property>
<!--映射文件 -->
<mapping resource="com/stuman/domain/admin.hbm.xml" />
<!--映射文件-->
<mapping resource="com/stuman/domain/student.hbm.xml" />
</session-factory>
</hibernate-configuration>
properties形式的配置文件和xml格式的配置文件可以同时使用。当同时使用两种类型的配置文件时,xml配置文件中的设置会覆盖properties配置文件的相同的属性。
对象标识符号
在关系数据库表中,主键(primary key)用来识别记录,并保证每条记录的唯一性。在java语言中,通过比较两个变量所引用对象的内存地址是否相同,或者比较两个变量引用的对象值是否相同来判断两对象是否相等。hibernate为了解决两者之间的不同,使用对象标识符(oid)来标识对象的唯一性。oid是关系数据库中主键在java对象模型中的等价物。在运行时,hibernate根据oid来维持java对象和数据库表中记录的对应关系。如下代码所示,三次调用了session的load()方法,分别加载oid为1或3的user对象。
transaction tx = session.begintransaction();
user user1 = (user)session.load(user.class,new long(1));
user user2 = (user)session.load(user.class,new long(1));
user user3 = (user)session.load(user.class,new long(3));
system.out.println( user1 == user2 );
system.out.println( user1 == user3 );
应用程序在执行上述代码时,第一次加载oid为1的user对象,从数据库中查找id为1的记录,然后创建相应的user实例,并把它保存在session缓存中,最后将该实例的引用赋值给变量user1。第二次加载oid为1的对象时,直接把session缓存中oid为1的实例的引用赋值给变量user2。因此,表达式user1==user2的结果为true。
标识的生成可以使用不同的策略,表1为hibernate内置的标识生成策略。
表1 hibernate标识生成策略
标识符生成器
| 描述 |
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 | 适用于代理主键。使用另外一个相关联的对象的标识符。 |
hibernate映射类型
在对象/关系映射文件中,hibernate采用映射类型作为java类型和sql类型的桥梁。hibernate映射类型分为2种:内置映射类型和自定义映射类型。
1、内置映射类型
hibernate对所有的java原生类型、常用的java类型如string、date等都定义了内置的映射类型。表2列出了hibernate映射类型、对应的java类型以及对应的标准sql类型。
表2 hibernate内置映射类型
hibernate映射类型 | java类型 | 标准sql类型 | 大小 |
integer/int | java.lang.integer/int | integer | 4字节 |
long | java.lang.long/long | bigint | 8字节 |
short | java.lang.short/short | smallint | 2字节 |
byte | java.lang.byte/byte | tinyint | 1字节 |
float | java.lang.float/float | float | 4字节 |
double | java.lang.double/double | double | 8字节 |
big_decimal | java.math.bigdecimal | numeric | |
character | java.lang.character/java.lang.string/char | char(1) | 定长字符 |
string | java.lang.string | varchar | 变长字符 |
boolean/ yes_no/true_false | java.lang.boolean/boolean | bit | 布尔类型 |
date | java.util.date/java.sql.date | date | 日期 |
timestamp | java.util.date/java.util.timestamp | timestamp | 日期 |
calendar | java.util.calendar | timestamp | 日期 |
calendar_date | java.util.calendar | date | 日期 |
binary | byte[] | blob
| blob |
text | java.lang.string | text | clob |
serializable | 实现java.io.serializablej接口的任意java类 | blob | blob |
clob | java.sql.clob | clob | clob |
blob | java.sql.blob | blob | blob |
class | java.lang.class | varchar | 定长字符 |
locale | java.util.locale | varchar | 定长字符 |
timezone | java.util.timezone | varchar | 定长字符 |
currency | java.util.currency | varchar | 定长字符 |
2、自定义映射类型
hibernate提供了自定义映射类型接口,允许用户以编程的方式创建自定义的映射类型。用户自定义的映射类型需要实现net.sf.hibernate.usertype或net.sf.hibernate.compositeusertype接口。具体的创建自定义映射类型的方法请参考hibernate官方文档或相关资料,这里不再详细介绍。