配置文件中映射元素详解
对象关系的映射是用一个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 被编码成一个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 官方文档或相关资料,这里不再详细介绍。
3 、连接池
c3p0 连接池
c3p0 连接池是Hibernate 推荐使用的连接池,若需要使用该连接池时,需要将c3p0 的jar 包加入到classpath 中。c3p0 连接池的配置示例如下:
hibernate.cfg.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>
<!-- SQL 方言,这边设定的是MySQL -->
<property name="dialect">net.sf.hibernate.dialect.MySQLDialect</property>
<!-- 驱动程序,在后续的章节中将讲述mysql 、sqlserver 和Oracle 数据库的配置 -->
<property name="connection.driver_class">……</property>
<!-- JDBC URL -->
<property name="connection.url">……</property>
<!-- 数据库用户名 -->
<property name="connection.username">user</property>
<!-- 数据库密码 -->
<property name="connection.password">pass</property>
<property name="c3p0.min_size">5</property>
<property name="c3p0.max_size">20</property>
<property name="c3p0.timeout">1800</property>
<property name="c3p0.max_statements">50</property>
<!-- 对象与数据库表格映像文件 -->
<mapping resource="com/amigo/pojo/User.hbm.xml"/>
<mapping resource="com/amigo/pojo/Org.hbm.xml"/>
</session-factory>
</hibernate-configuration>
在上述配置中,Hibernate 根据配置文件生成连接,再交给c3p0 管理。
3. proxool 连接池
proxool 跟c3p0 以及dbcp 不一样,它是自己生成连接的,因此连接信息放在proxool 配置文件中。使用它时,需要将proxool-0.8.3.jar 加入到classespath 中。配置举例如下:
hibernate.cfg.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>
<!-- SQL 方言,这边设定的是MySQL -->
<property name="dialect">net.sf.hibernate.dialect.MySQLDialect</property>
<!—proxool 的配置 -->
<property name="proxool.pool_alias">pool1</property>
<property name="proxool.xml">ProxoolConf.xml</property>
<property name="connection.provider_class">net.sf.hibernate.connection.ProxoolConnectionProvider</property>
<!-- 对象与数据库表格映像文件 -->
<mapping resource="com/amigo/pojo/User.hbm.xml"/>
<mapping resource="com/amigo/pojo/Org.hbm.xml"/>
</session-factory>
</hibernate-configuration>
在hibernate.cfg.xml 的同目录下编写proxool 的配置文件:ProxoolConf.xml ,该文件的配置实例如下:
ProxoolConf.xml
<?xml version="1.0" encoding="utf-8"?>
<!-- the proxool configuration can be embedded within your own application's.
Anything outside the "proxool" tag is ignored. -->
<something-else-entirely>
<proxool>
<alias>pool1</alias>
<!--proxool 只能管理由自己产生的连接-->
<!-- 驱动的url-->
<!-- jdbc:mysql://localhost:3306/dbname?useUnicode=true&characterEncoding=GBK-->
<driver-url>… </driver-url>
<!-- 驱动类,eg. com.mysql.jdbc.Driver-->
<driver-class>… </driver-class>
<driver-properties>
<!-- 数据库用户名,eg. value 为root-->
<property name="user" value="…"/>
<!-- 数据库密码,eg. value 为root-->
<property name="password" value="…."/>
</driver-properties>
<!-- proxool 自动侦察各个连接状态的时间间隔( 毫秒), 侦察到空闲的连接就马上回收, 超时的销毁-->
<house-keeping-sleep-time>90000</house-keeping-sleep-time>
<!-- 指因未有空闲连接可以分配而在队列中等候的最大请求数, 超过这个请求数的用户连接就不会被接受-->
<maximum-new-connections>20</maximum-new-connections>
<!-- 最少保持的空闲连接数-->
<prototype-count>5</prototype-count>
<!-- 允许最大连接数, 超过了这个连接,再有请求时,就排在队列中等候,最大的等待请求数由maximum-new-connections 决定-->
<maximum-connection-count>100</maximum-connection-count>
<!-- 最小连接数-->
<minimum-connection-count>10</minimum-connection-count>
</proxool>
</something-else-entirely>
4. dbcp 连接池
在hibernate3.0 中,已经不再支持dbcp 了,hibernate 的作者在hibernate.org 中,明确指出在实践中发现dbcp 有 BUG, 在某些种情会产生很多空连接不能释放,所以抛弃了对dbcp 的支持。若需要使用dbcp ,开发人员还需要将commons-pool-1.2.jar 和commons-dbcp-1.2.1.jar 两个jar 包加入到classpath 中。dbcp 与c3p0 一样,都是由hibernate 建立连接的。
在hibernate2.0 中的配置建立如下:
hibernate.cfg.xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE hibernate-configuration PUBLIC
"-//Hibernate/Hibernate Configuration DTD 2.0//EN"
"http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd ">
<hibernate-configuration>
<session-factory>
<!-- 显示实际操作数据库时的SQL -->
<property name="show_sql">true</property>
<!-- SQL 方言,这边设定的是MySQL -->
<property name="dialect">net.sf.hibernate.dialect.MySQLDialect</property>
<!-- 驱动程序,在后续的章节中将讲述mysql 、sqlserver 和Oracle 数据库的配置 -->
<property name="connection.driver_class">……</property>
<!-- JDBC URL -->
<property name="connection.url">……</property>
<!-- 数据库用户名,eg. root -->
<property name="connection.username">…</property>
<!-- 数据库密码, eg. root-->
<property name="connection.password">…</property>
<property name="dbcp.maxActive">100</property>
<property name="dbcp.whenExhaustedAction">1</property>
<property name="dbcp.maxWait">60000</property>
<property name="dbcp.maxIdle">10</property>
<property name="dbcp.ps.maxActive">100</property>
<property name="dbcp.ps.whenExhaustedAction">1</property>
<property name="dbcp.ps.maxWait">60000</property>
<property name="dbcp.ps.maxIdle">10</property>
<!-- 对象与数据库表格映像文件 -->
<mapping resource="com/amigo/pojo/User.hbm.xml"/>
<mapping resource="com/amigo/pojo/Org.hbm.xml"/>
</session-factory>
</hibernate-configuration>