分类: Java
2007-02-27 14:15:54
对象关系的映射是用一个XML文档来说明的。映射文档可以使用工具来生成,如XDoclet,Middlegen和AndroMDA等。下面从一个映射的例子开始讲解映射元素,映射文件的代码如下。
"-//Hibernate/Hibernate Mapping DTD 3.0//EN"
"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">
update="false"/>
update="false"/>
order-by="id">
一对多映射-->
组件有两种类型,即组件(component)和动态组件(dynamic-component)。在配置文件中,component元素为子对象的元素与父类对应表的字段建立起映射关系。然后组件可以声明它们自己的属性、组件或者集合。component元素的定义如下所示:
class="className"
insert="true|false"
upate="true|false"
access="field|property|ClassName">
........
在这段代码中,name是指属性名,class是类的名字,insert指的是被映射的字段是否出现在SQL的INSERT语句中,upate指出被映射的字段是否出现在SQL的UPDATE语句中,access指出访问属性的策略。
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配置文件的示例如下所示:
"-//Hibernate/Hibernate Configuration DTD 3.0//EN"
"">
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。
标识的生成可以使用不同的策略,表4.1为Hibernate内置的标识生成策略。
表 4.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采用映射类型作为Java类型和SQL类型的桥梁。Hibernate映射类型分为2种:内置映射类型和自定义映射类型。
1 内置映射类型
Hibernate对所有的Java原生类型、常用的Java类型如String、Date等都定义了内置的映射类型。表4.2列出了Hibernate映射类型、对应的Java类型以及对应的标准SQL类型。
表4.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官方文档或相关资料,这里不再详细介绍。
Hibernate中,持久化对象间的一对一关联是通过one-to-one元素定义的。其定义方式如下所示。
class="ClassName"
cascade="all|none|save-update|delete"
constrained="true|false"
outer-join="true|false|auto"
property-ref="propertyNameFromAssociatedClass"
access="field|property|ClassName"
/>
在这段代码中,name是指属性的名字,class指的是被关联的类的名字。cascade是可选项,表明操作是否从父对象级联到被关联的对象。constrained表明该类对应的表对应的数据库表,和被关联的对象所对应的数据库表之间,通过一个外键引用对主键进行约束。
outer-join也是可选项,它指的是当设置hibernate.use_outer_join的时候,对这个关联允许外连接抓取。property-ref指定关联类的一个属性,这个属性将会和本外键相对应。如果没有指定,会使用对方关联类的主键。access是Hibernate用来访问属性的策略。
一对一关联有两种不同的形式,即主键关联和唯一外键关联:
1 主键关联
主键关联不需要额外的表字段。如下所示的代码,将Student和Person表的主键进行一对一关联:
Person和Student两个表中相关字段是对等的。在下面的代码中,Person表的主键将采用foreign的方式生成。
employee
...
constrained="true"/>
2 惟一外键关联
此种关联方式是指一个外键与一个惟一的关键字相关联,上面的Student和Person的例子,如果使这种关联方式,应该表达成:
持久化对象间的多对一关联是通过many-to-one元素定义的。其定义方式如下所示。
column="column_name"
class="ClassName"
cascade="all|none|save-update|delete"
outer-join="true|false|auto"
update="true|false"
insert="true|false"
property-ref="propertyNameFromAssociatedClass"
access="field|property|ClassName"
/>
在这段代码中,name指类的属性名,column指表的字段名,class是可选项,指关联的类的名字。cascade指明哪些操作会从父对象级联到关联的对象,outer-join指的是当设置hibernate.use_outer_join的时候,对这个关联允许外连接抓取。update用于指定对应的字段是否用于UPDATE,property-ref用于指定关联类的一个属性,这个属性将会和本外键相对应,access为可选项,指访问属性的策略。
Hibernate的检索方式主要有HQL、QBC、QBE检索等几种方式。Hibernate查询语言(Hibernate Query Language,简称HQL)是一种面向对象的查询语言。HQL功能强大且简单易学,它具有以下功能。
Session接口的find()方法及Query接口都支持HQL检索方式。如下代码是一个使用Query接口查询的示例。
//创建一个Query对象
Query query = session.createQuery ( “form User as u where u.name=:userName” + “ and u.age=:userAge” ) ;
//动态绑定参数
query.setString( “userName” , “Bush” );
query.setString( “userAge” , “50” );
//执行查询语句,返回查询结果X
List results = query.list();
Query By Criteria(QBC)和Query By Example(QBE)提供了检索对象的其他方式,这些检索方式主要由Criteria接口、Criterion接口、Expression类和Example类组成,支持在运行时动态生成查询语句。关于QBC和QBE的内容可以参考Hibernate官方文档或相关书籍,这里不再详细介绍。