创建数据库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反射机制先识