創建數據庫Schema 在本例中,與Customer類對應的數據庫表名為CUSTOMERS,它在MySQL數據庫中的DDL定義如下:
  
  create table CUSTOMERS (
  ID bigint not null primary key,
  NAME varchar(15not null,
  EMAIL varchar(128not null,
  PASSWORD varchar(8not null,
  PHONE int ,
  ADDRESS varchar(255),
  SEX char(1) ,
  IS_MARRIED bit,
  DESCRIPTION text,
  IMAGE blob,
  BIRTHDAY date,
  REGISTERED_TIME timestamp
  );
  
  CUSTOMERS表有一個ID字段,它是表的主鍵,它和Customer類的id屬性對應。CUSTOMERS表中的字段使用了各種各樣的SQL類型,參見表2-2。
  
  表2-2 CUSTOMERS表的字段使用的SQL類型
   
   
  2.4 創建對象-關系映射文件
  
  Hibernate采用XML格式的文件來指定對象和關系數據之間的映射。在運行時,Hibernate將根據這個映射文件來生成各種SQL語句。在本例中,將創建一個名為Customer.hbm.xml的文件,它用于把Customer類映射到CUSTOMERS表,這個文件應該和Customer.class文件存放在同一個目錄下。例程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,文檔類型定義),它對XML文件的語法和格式做了定義。Hibernate的XML解析器將根據DTD來核對XML文件的語法。
  
  每一種XML文件都有獨自的DTD文件。Hibernate的對象-關系映射文件使用的DTD文件的下載網址為:http://hibernate.sourceforge.net/hibernate-mapping-2.0.dtd。此外,在Hibernate軟件包的src\net\sf\hibernate目錄下也提供了hibernate-mapping-2.0.dtd文件。在這個文件中,描述頂層元素的代碼如下:
  
  <!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*))
  )
>
  
  元素是對象-關系映射文件的根元素,其他元素(即以上DTD代碼中括號以內的元素,如子元素)必須嵌入在元素以內。在元素中又嵌套了好多子元素。
  
  在以上DTD代碼中,還使用了一系列的特殊符號來修飾元素,表2-3描述了這些符號的作用。在創建自己的對象-關系映射文件時,如果不熟悉某種元素的語法,可以參考DTD文件。
  
  表2-3 DTD中特殊符號的作用
   
  根據表2-3可以看出,在元素中,、、和等子元素可以不存在,或者存在一次或者多次;在元素中,子元素必須存在且只能存在一次,元素可以不存在,或者存在一次或者多次。
  
  此外,在映射文件中,父元素中的各種子元素的定義必須符合特定的順序。例如,根據元素的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解析器在運行時會拋出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類。如果需要映射多個持久化類,那么既可以在同一個映射文件中映射所有類,也可以為每個類創建單獨的映射文件,映射文件和類同名,擴展名為"hbm.xml"。后一種做法更值得推薦,因為在團隊開發中,這有利于管理和維護映射文件。
  
  元素指定類和表的映射,它的name屬性設定類名,table屬性設定表名。以下代碼表明和Customer類對應的表為CUSTOMERS表:
  
  <class name="mypack.Customer"
  table="CUSTOMERS">
  
  如果沒有設置元素的table屬性,Hibernate將直接以類名作為表名,也就是說,在默認情況下,與mypack.Customer類對應的表為Customer表。
  
  元素包含一個子元素及多個子元素。子元素設定持久化類的OID和表的主鍵的映射。以下代碼表明Customer類的id屬性和CUSTOMERS表中的ID字段對應。
  
  <id name="id" column="ID" type="long">
  <generator class="increment"/>
  </id>
  
  元素的子元素指定對象標識符生成器,它負責為OID生成惟一標識符。本書第5章(映射對象標識符)詳細介紹了Hibernate提供的各種對象標識符生成器的用法。
  
  子元素設定類的屬性和表的字段的映射。子元素主要包括name、type、column和not-null屬性。
  
  1.元素的name屬性
  
  元素的name屬性指定持久化類的屬性的名字。
  
  2.元素的type屬性
  
  元素的type屬性指定Hibernate映射類型。Hibernate映射類型是Java類型與SQL類型的橋梁。表2-4列出了Customer類的屬性的Java類型、Hibernate映射類型,以及CUSTOMERS表的字段的SQL類型這三者之間的對應關系。
  
  表2-4 Java類型、Hibernate映射類型以及SQL類型之間的對應關系
  
  從表2-4看出,如果Customer類的屬性為java.lang.String類型,并且與此對應的CUSTOMERS表的字段為VARCHAR類型,那么應該把Hibernate映射類型設為string,例如:
  
  <property name="name"
  column
="NAME" type="string"
  not-null
="true" />
  
  如果Customer類的屬性為java.lang.String類型,并且與此對應的CUSTOMERS表的字段為TEXT類型,那么應該把Hibernate映射類型設為text,例如:
  
  <property name="description"
  column
="DESCRIPTION" type="text"/>
  
  如果Customer類的屬性為byte[]類型,并且與此對應的CUSTOMERS表的字段為BLOB類型,那么應該把Hibernate映射類型設為binary,例如:
  
  <property name="image" column="IMAGE"
  type
="binary"/>
  
  如果沒有顯式設定映射類型,Hibernate會運用Java反射機制先識