Hibernate是Java應(yīng)用和關(guān)系數(shù)據(jù)庫之間的橋梁，它負(fù)責(zé)Java對(duì)象和關(guān)系數(shù)據(jù)之間的映射。Hibernate內(nèi)部封裝了通過JDBC訪問數(shù)據(jù)庫的操作，向上層應(yīng)用提供了面向?qū)ο蟮臄?shù)據(jù)訪問API。在Java應(yīng)用中使用Hibernate包含以下步驟。

　　（1）創(chuàng)建Hibernate的配置文件。

　　（2）創(chuàng)建持久化類。

　　（3）創(chuàng)建對(duì)象-關(guān)系映射文件。

　　（4）通過Hibernate API編寫訪問數(shù)據(jù)庫的代碼。

　　本章通過一個(gè)簡(jiǎn)單的例子helloapp應(yīng)用，演示如何運(yùn)用Hibernate來訪問關(guān)系數(shù)據(jù)庫。helloapp應(yīng)用的功能非常簡(jiǎn)單：通過Hibernate保存、更新、刪除、加載及查詢Customer對(duì)象。圖1顯示了Hibernate在helloapp應(yīng)用中所處的位置。

　　圖1 Hibernate在helloapp應(yīng)用中所處的位置

　　helloapp應(yīng)用既能作為獨(dú)立的Java程序運(yùn)行，還能作為Java Web應(yīng)用運(yùn)行，該應(yīng)用的源代碼位于配套光盤的sourcecode/chapter2/helloapp目錄下。

　　2.1 創(chuàng)建Hibernate的配置文件

　　Hibernate從其配置文件中讀取和數(shù)據(jù)庫連接有關(guān)的信息，這個(gè)配置文件應(yīng)該位于應(yīng)用的classpath中。Hibernate的配置文件有兩種形式：一種是XML格式的文件；還有一種是Java屬性文件，采用"健=值"的形式。

　　下面介紹如何以Java屬性文件的格式來創(chuàng)建Hibernate的配置文件。這種配置文件的默認(rèn)文件名為hibernate.properties，例程2-1為示范代碼。

　　例程2-1 hibernate.properties

　　hibernate.dialect=
　　net.sf.hibernate.dialect.MySQLDialect
　　hibernate.connection.driver_class=
　　com.mysql.jdbc.Driver
　　hibernate.connection.url=jdbc:mysql:
　　//localhost:3306/SAMPLEDB
　　hibernate.connection.username=root
　　hibernate.connection.password=1234
　　hibernate.show_sql=true

　　以上hibernate.properties文件包含了一系列屬性及其屬性值，Hibernate將根據(jù)這些屬性來連接數(shù)據(jù)庫，本例為連接MySQL數(shù)據(jù)庫的配置代碼。表2-1對(duì)以上hibernate.properties文件中的所有屬性做了描述。

　　表2-1 Hibernate配置文件的屬性

　　Hibernate能夠訪問多種關(guān)系數(shù)據(jù)庫，如MySQL、Oracle和Sybase等。盡管多數(shù)關(guān)系數(shù)據(jù)庫都支持標(biāo)準(zhǔn)的SQL語言，但是它們往往還有各自的SQL方言，就像不同地區(qū)的人既能說標(biāo)準(zhǔn)的普通話，還能講各自的方言一樣。

　　hibernate.dialect屬性用于指定被訪問數(shù)據(jù)庫使用的SQL方言，當(dāng)Hibernate生成SQL查詢語句，或者使用native對(duì)象標(biāo)識(shí)符生成策略時(shí)，都會(huì)參考本地?cái)?shù)據(jù)庫的SQL方言。本書第5章（映射對(duì)象標(biāo)識(shí)符）介紹了Hibernate的各種對(duì)象標(biāo)識(shí)符生成策略。

　　在Hibernate軟件包的etc目錄下，有一個(gè)hibernate.properties文件，它提供了連接各種關(guān)系數(shù)據(jù)庫的配置代碼樣例。

　　2.2 創(chuàng)建持久化類

　　持久化類是指其實(shí)例需要被Hibernate持久化到數(shù)據(jù)庫中的類。持久化類通常都是域模型中的實(shí)體域類。持久化類符合JavaBean的規(guī)范，包含一些屬性，以及與之對(duì)應(yīng)的getXXX()和setXXX()方法。例程2-2定義了一個(gè)名為Customer的持久化類。

　　例程2-2 Customer.java

　　package mypack;
　　import java.io.Serializable;
　　import java.sql.Date;
　　import java.sql.Timestamp;

　　public class Customer implements Serializable
　　{
　　private Long id;
　　private String name;
　　private String email;
　　private String password;
　　private int phone;
　　private boolean married;
　　private String address;
　　private char sex;
　　private String description;
　　private byte[] image;
　　private Date birthday;
　　private Timestamp registeredTime;

　　public Customer(){}

　　public Long getId()
　　{
　　return id;
　　}

　　public void setId(Long id)
　　{
　　this.id = id;
　　}

　　public String getName()
　　{
　　return name;
　　}

　　public void setName(String name)
　　{
　　this.name=name;
　　}

　　//此處省略email、password和phone
　　等屬性的getXXX()和setXXX()方法
　　……
　　}

　　持久化類符合JavaBean的規(guī)范，包含一些屬性，以及與之對(duì)應(yīng)的getXXX()和setXXX()方法。getXXX()和setXXX()方法必須符合特定的命名規(guī)則，"get"和"set"后面緊跟屬性的名字，并且屬性名的首字母為大寫，例如name屬性的get方法為getName()，如果把get方法寫為getname()或者getNAME()，會(huì)導(dǎo)致Hibernate在運(yùn)行時(shí)拋出以下異常：

　　net.sf.hibernate.PropertyNotFoundException:
　　Could not find a getter
　　for property name in class mypack.Customer

　　如果持久化類的屬性為boolean類型，那么它的get方法名既可以用"get"作為前綴，也可以用"is"作為前綴。例如Customer類的married屬性為boolean類型，因此以下兩種get方法是等價(jià)的：


　　public boolean isMarried()
　　{
　　return married;
　　}

　　或者：

　　public boolean getMarried()
　　{
　　return married;
　　}

　　Hibernate并不要求持久化類必須實(shí)現(xiàn)java.io.Serializable接口，但是對(duì)于采用分布式結(jié)構(gòu)的Java應(yīng)用，當(dāng)Java對(duì)象在不同的進(jìn)程節(jié)點(diǎn)之間傳輸時(shí)，這個(gè)對(duì)象所屬的類必須實(shí)現(xiàn)Serializable接口，此外，在Java Web應(yīng)用中，如果希望對(duì)HttpSession中存放的Java對(duì)象進(jìn)行持久化，那么這個(gè)Java對(duì)象所屬的類也必須實(shí)現(xiàn)Serializable接口。

　　Customer持久化類有一個(gè)id屬性，用來惟一標(biāo)識(shí)Customer類的每個(gè)對(duì)象。在面向?qū)ο笮g(shù)語中，這個(gè)id屬性被稱為對(duì)象標(biāo)識(shí)符（OID，Object Identifier），通常它都用整數(shù)表示，當(dāng)然也可以設(shè)為其他類型。如果customerA.getId().equals(customerB.getId())的結(jié)果是true，就表示customerA和customerB對(duì)象指的是同一個(gè)客戶，它們和CUSTOMERS表中的同一條記錄對(duì)應(yīng)。

　　Hibernate要求持久化類必須提供一個(gè)不帶參數(shù)的默認(rèn)構(gòu)造方法，在程序運(yùn)行時(shí)，Hibernate運(yùn)用Java反射機(jī)制，調(diào)用java.lang.reflect.Constructor.newInstance()方法來構(gòu)造持久化類的實(shí)例。

　　如果對(duì)這個(gè)持久化類使用延遲檢索策略，為了使Hibernate能夠在運(yùn)行時(shí)為這個(gè)持久化類創(chuàng)建動(dòng)態(tài)代理，要求持久化類的默認(rèn)構(gòu)造方法的訪問級(jí)別必須是public或protected類型，而不能是default或private類型。

　　在本書第10章（Hibernate的檢索策略）介紹了Hibernate的延遲檢索策略及動(dòng)態(tài)代理的概念。

　　在Customer類中沒有引入任何Hibernate API，Customer類不需要繼承Hibernate的類，或?qū)崿F(xiàn)Hibernate的接口，這提高了持久化類的獨(dú)立性。如果日后要改用其他的ORM產(chǎn)品，比如由Hibernate改為OJB，不需要修改持久化類的代碼。

　　本書第1章介紹了J2EE的持久化方案，無論是基于CMP的實(shí)體EJB，還是基于BMP的實(shí)體EJB，它們的共同特點(diǎn)是都必須運(yùn)行在EJB容器中。而Hibernate支持的持久化類不過是普通的Java類，它們能夠運(yùn)行在任何一種Java環(huán)境中。?

　　創(chuàng)建數(shù)據(jù)庫Schema 在本例中，與Customer類對(duì)應(yīng)的數(shù)據(jù)庫表名為CUSTOMERS，它在MySQL數(shù)據(jù)庫中的DDL定義如下：

　　create table CUSTOMERS (
　　ID bigint not null primary key,
　　NAME varchar(15) not null,
　　EMAIL varchar(128) not null,
　　PASSWORD varchar(8) not null,
　　PHONE int ,
　　ADDRESS varchar(255),
　　SEX char(1) ,
　　IS_MARRIED bit,
　　DESCRIPTION text,
　　IMAGE blob,
　　BIRTHDAY date,
　　REGISTERED_TIME timestamp
　　);

　　CUSTOMERS表有一個(gè)ID字段，它是表的主鍵，它和Customer類的id屬性對(duì)應(yīng)。CUSTOMERS表中的字段使用了各種各樣的SQL類型，參見表2-2。

　　表2-2 CUSTOMERS表的字段使用的SQL類型


　　2.4 創(chuàng)建對(duì)象-關(guān)系映射文件

　　Hibernate采用XML格式的文件來指定對(duì)象和關(guān)系數(shù)據(jù)之間的映射。在運(yùn)行時(shí)，Hibernate將根據(jù)這個(gè)映射文件來生成各種SQL語句。在本例中，將創(chuàng)建一個(gè)名為Customer.hbm.xml的文件，它用于把Customer類映射到CUSTOMERS表，這個(gè)文件應(yīng)該和Customer.class文件存放在同一個(gè)目錄下。例程2-3為Customer.hbm.xml文件的代碼。

　　例程2-3 Customer.hbm.xml

　　<?xml version="1.0"?>
　　<!DOCTYPE hibernate-mapping PUBLIC "-
　　//Hibernate/Hibernate Mapping DTD 2.0
　　//EN"
　　"http://hibernate.sourceforge.net
　　/hibernate-mapping-2.0.dtd">

　　<hibernate-mapping>
　　<class name="mypack.Customer"
　　table="CUSTOMERS">

　　<id name="id" column="ID" type="long">
　　<generator class="increment"/>
　　</id>

　　<property name="name"
　　column="NAME"　type="string"
　　not-null="true" />
　　<property name="email"
　　column="EMAIL"　　 type="string"
　　not-null="true" />
　　<property name="password"
　　column="PASSWORD"　type="string"
　　not-null="true"/>
　　<property name="phone"
　　column="PHONE"　　 type="int" />
　　<property name="address"
　　column="ADDRESS"　 type="string" />
　　<property name="sex"
　　column="SEX"　　　 type="character"/>
　　<property name="married"
　　column="IS_MARRIED"　type="boolean"/>
　　<property name="description"
　　column="DESCRIPTION"　type="text"/>
　　<property name="image"
　　column="IMAGE"　　　　type="binary"/>
　　<property name="birthday"
　　column="BIRTHDAY"　　 type="date"/>
　　<property name="registeredTime"
　　column="REGISTERED_TIME"
　　type="timestamp"/>
　　</class>
　　</hibernate-mapping>

　　2.4.1 映射文件的文檔類型定義（DTD）

　　在例程2-3的Customer.hbm.xml文件的開頭聲明了DTD（Document Type Definition，文檔類型定義），它對(duì)XML文件的語法和格式做了定義。Hibernate的XML解析器將根據(jù)DTD來核對(duì)XML文件的語法。

　　每一種XML文件都有獨(dú)自的DTD文件。Hibernate的對(duì)象-關(guān)系映射文件使用的DTD文件的下載網(wǎng)址為：http://hibernate.sourceforge.net/hibernate-mapping-2.0.dtd。此外，在Hibernate軟件包的src\net\sf\hibernate目錄下也提供了hibernate-mapping-2.0.dtd文件。在這個(gè)文件中，描述頂層元素的代碼如下：

　　<!ELEMENT hibernate-mapping (meta*,
　　import*, (class|subclass|joined-subclass)*,
　　query*,
　　sql-query*)>

　　描述頂層元素的子元素的代碼如下：

　　<!ELEMENT class (
　　meta*,
　　(cache|jcs-cache)?,
　　(id|composite-id),
　　discriminator?,
　　(version|timestamp)?,
　　(property|many-to-one|one-to-one
　　|component|dynamic-component|any
　　|map|set|list|bag|idbag|array
　　|primitive-array)*,
　　((subclass*)|(joined-subclass*))
　　)>

　　元素是對(duì)象-關(guān)系映射文件的根元素，其他元素（即以上DTD代碼中括號(hào)以內(nèi)的元素，如子元素）必須嵌入在元素以內(nèi)。在元素中又嵌套了好多子元素。

　　在以上DTD代碼中，還使用了一系列的特殊符號(hào)來修飾元素，表2-3描述了這些符號(hào)的作用。在創(chuàng)建自己的對(duì)象-關(guān)系映射文件時(shí)，如果不熟悉某種元素的語法，可以參考DTD文件。

　　表2-3 DTD中特殊符號(hào)的作用

　　根據(jù)表2-3可以看出，在元素中，、、和等子元素可以不存在，或者存在一次或者多次；在元素中，子元素必須存在且只能存在一次，元素可以不存在，或者存在一次或者多次。

　　此外，在映射文件中，父元素中的各種子元素的定義必須符合特定的順序。例如，根據(jù)元素的DTD可以看出，必須先定義子元素，再定義子元素，以下映射代碼顛倒了和子元素的位置：

　　<class name="mypack.Customer"
　　table="CUSTOMERS">
　　<property name="name"
　　column="NAME"　type="string"
　　not-null="true" />
　　<property name="email"
　　column="EMAIL"
　　type="string" not-null="true" />

　　<id name="id" column="ID" type="long">
　　<generator class="increment"/>
　　</id>
　　……
　　</class>

　　Hibernate的XML解析器在運(yùn)行時(shí)會(huì)拋出MappingException：

　　[java] 21:27:51,610 ERROR XMLHelper:
　　48 - Error parsing XML:
　　XML InputStream (24)
　　The content of element type "class"
　　must match "(meta*,(cache|jcs-cache)?,
　　(
　　id|composite-id),
　　discriminator?,(version|timestamp)?,
　　(property|many-to-one|one-to-one|component|
　　dynamic-component|any|map|set
　　|list|bag|idbag|array|primitive-array)*,
　　(subclass*|joined-subclass*))".

　　[java] net.sf.hibernate.MappingException:
　　Error reading resource:
　　mypack/Customer.hbm.xml
　　at net.sf.hibernate.cfg.Configuration.addClass
　　(Configuration.java:357)

　　2.4.2 把Customer持久化類映射到CUSTOMERS表

　　例程2-3的Customer.hbm.xml文件用于映射Customer類。如果需要映射多個(gè)持久化類，那么既可以在同一個(gè)映射文件中映射所有類，也可以為每個(gè)類創(chuàng)建單獨(dú)的映射文件，映射文件和類同名，擴(kuò)展名為"hbm.xml"。后一種做法更值得推薦，因?yàn)樵趫F(tuán)隊(duì)開發(fā)中，這有利于管理和維護(hù)映射文件。

　　元素指定類和表的映射，它的name屬性設(shè)定類名，table屬性設(shè)定表名。以下代碼表明和Customer類對(duì)應(yīng)的表為CUSTOMERS表：

　　<class name="mypack.Customer"
　　table="CUSTOMERS">

　　如果沒有設(shè)置元素的table屬性，Hibernate將直接以類名作為表名，也就是說，在默認(rèn)情況下，與mypack.Customer類對(duì)應(yīng)的表為Customer表。

　　元素包含一個(gè)子元素及多個(gè)子元素。子元素設(shè)定持久化類的OID和表的主鍵的映射。以下代碼表明Customer類的id屬性和CUSTOMERS表中的ID字段對(duì)應(yīng)。

　　<id name="id" column="ID" type="long">
　　<generator class="increment"/>
　　</id>

　　元素的子元素指定對(duì)象標(biāo)識(shí)符生成器，它負(fù)責(zé)為OID生成惟一標(biāo)識(shí)符。本書第5章（映射對(duì)象標(biāo)識(shí)符）詳細(xì)介紹了Hibernate提供的各種對(duì)象標(biāo)識(shí)符生成器的用法。

　　子元素設(shè)定類的屬性和表的字段的映射。子元素主要包括name、type、column和not-null屬性。

　　1．元素的name屬性

　　元素的name屬性指定持久化類的屬性的名字。

　　2．元素的type屬性

　　元素的type屬性指定Hibernate映射類型。Hibernate映射類型是Java類型與SQL類型的橋梁。表2-4列出了Customer類的屬性的Java類型、Hibernate映射類型，以及CUSTOMERS表的字段的SQL類型這三者之間的對(duì)應(yīng)關(guān)系。

　　表2-4 Java類型、Hibernate映射類型以及SQL類型之間的對(duì)應(yīng)關(guān)系

　　從表2-4看出，如果Customer類的屬性為java.lang.String類型，并且與此對(duì)應(yīng)的CUSTOMERS表的字段為VARCHAR類型，那么應(yīng)該把Hibernate映射類型設(shè)為string，例如：

　　<property name="name"
　　column="NAME"　type="string"
　　not-null="true" />

　　如果Customer類的屬性為java.lang.String類型，并且與此對(duì)應(yīng)的CUSTOMERS表的字段為TEXT類型，那么應(yīng)該把Hibernate映射類型設(shè)為text，例如：

　　<property name="description"
　　column="DESCRIPTION"　type="text"/>

　　如果Customer類的屬性為byte[]類型，并且與此對(duì)應(yīng)的CUSTOMERS表的字段為BLOB類型，那么應(yīng)該把Hibernate映射類型設(shè)為binary，例如：

　　<property name="image"　column="IMAGE"
　　type="binary"/>

　　如果沒有顯式設(shè)定映射類型，Hibernate會(huì)運(yùn)用Java反射機(jī)制先識(shí)

?

Java對(duì)象持久化技術(shù)之Hibernate