hibernate.cfg.xml 配置详解
配置文件中映射元素详解
对象关系的映射是用一个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>
