創(chuàng)建數(shù)據(jù)庫(kù)Schema 在本例中，與Customer類(lèi)對(duì)應(yīng)的數(shù)據(jù)庫(kù)表名為CUSTOMERS，它在MySQL數(shù)據(jù)庫(kù)中的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類(lèi)的id屬性對(duì)應(yīng)。CUSTOMERS表中的字段使用了各種各樣的SQL類(lèi)型，參見(jiàn)表2-2。
表2-2 CUSTOMERS表的字段使用的SQL類(lèi)型
2.4 創(chuàng)建對(duì)象-關(guān)系映射文件
Hibernate采用XML格式的文件來(lái)指定對(duì)象和關(guān)系數(shù)據(jù)之間的映射。在運(yùn)行時(shí)，Hibernate將根據(jù)這個(gè)映射文件來(lái)生成各種SQL語(yǔ)句。在本例中，將創(chuàng)建一個(gè)名為Customer.hbm.xml的文件，它用于把Customer類(lèi)映射到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 映射文件的文檔類(lèi)型定義（DTD）
在例程2-3的Customer.hbm.xml文件的開(kāi)頭聲明了DTD（Document Type Definition，文檔類(lèi)型定義），它對(duì)XML文件的語(yǔ)法和格式做了定義。Hibernate的XML解析器將根據(jù)DTD來(lái)核對(duì)XML文件的語(yǔ)法。
每一種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)以?xún)?nèi)的元素，如子元素）必須嵌入在元素以?xún)?nèi)。在元素中又嵌套了好多子元素。
在以上DTD代碼中，還使用了一系列的特殊符號(hào)來(lái)修飾元素，表2-3描述了這些符號(hào)的作用。在創(chuàng)建自己的對(duì)象-關(guān)系映射文件時(shí)，如果不熟悉某種元素的語(yǔ)法，可以參考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持久化類(lèi)映射到CUSTOMERS表
例程2-3的Customer.hbm.xml文件用于映射Customer類(lèi)。如果需要映射多個(gè)持久化類(lèi)，那么既可以在同一個(gè)映射文件中映射所有類(lèi)，也可以為每個(gè)類(lèi)創(chuàng)建單獨(dú)的映射文件，映射文件和類(lèi)同名，擴(kuò)展名為"hbm.xml"。后一種做法更值得推薦，因?yàn)樵趫F(tuán)隊(duì)開(kāi)發(fā)中，這有利于管理和維護(hù)映射文件。
元素指定類(lèi)和表的映射，它的name屬性設(shè)定類(lèi)名，table屬性設(shè)定表名。以下代碼表明和Customer類(lèi)對(duì)應(yīng)的表為CUSTOMERS表：
<class name="mypack.Customer"
table="CUSTOMERS">
如果沒(méi)有設(shè)置元素的table屬性，Hibernate將直接以類(lèi)名作為表名，也就是說(shuō)，在默認(rèn)情況下，與mypack.Customer類(lèi)對(duì)應(yīng)的表為Customer表。
元素包含一個(gè)子元素及多個(gè)子元素。子元素設(shè)定持久化類(lèi)的OID和表的主鍵的映射。以下代碼表明Customer類(lèi)的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í)符。本書(shū)第5章（映射對(duì)象標(biāo)識(shí)符）詳細(xì)介紹了Hibernate提供的各種對(duì)象標(biāo)識(shí)符生成器的用法。
子元素設(shè)定類(lèi)的屬性和表的字段的映射。子元素主要包括name、type、column和not-null屬性。
1．元素的name屬性
元素的name屬性指定持久化類(lèi)的屬性的名字。
2．元素的type屬性
元素的type屬性指定Hibernate映射類(lèi)型。Hibernate映射類(lèi)型是Java類(lèi)型與SQL類(lèi)型的橋梁。表2-4列出了Customer類(lèi)的屬性的Java類(lèi)型、Hibernate映射類(lèi)型，以及CUSTOMERS表的字段的SQL類(lèi)型這三者之間的對(duì)應(yīng)關(guān)系。
表2-4 Java類(lèi)型、Hibernate映射類(lèi)型以及SQL類(lèi)型之間的對(duì)應(yīng)關(guān)系
從表2-4看出，如果Customer類(lèi)的屬性為java.lang.String類(lèi)型，并且與此對(duì)應(yīng)的CUSTOMERS表的字段為VARCHAR類(lèi)型，那么應(yīng)該把Hibernate映射類(lèi)型設(shè)為string，例如：
<property name="name"
column="NAME" type="string"
not-null="true" />
如果Customer類(lèi)的屬性為java.lang.String類(lèi)型，并且與此對(duì)應(yīng)的CUSTOMERS表的字段為T(mén)EXT類(lèi)型，那么應(yīng)該把Hibernate映射類(lèi)型設(shè)為text，例如：
<property name="description"
column="DESCRIPTION" type="text"/>
如果Customer類(lèi)的屬性為byte[]類(lèi)型，并且與此對(duì)應(yīng)的CUSTOMERS表的字段為BLOB類(lèi)型，那么應(yīng)該把Hibernate映射類(lèi)型設(shè)為binary，例如：
<property name="image" column="IMAGE"
type="binary"/>
如果沒(méi)有顯式設(shè)定映射類(lèi)型，Hibernate會(huì)運(yùn)用Java反射機(jī)制先識(shí)