5.1. 映射定义（Mapping declaration）

对象和关系数据库之间的映射通常是用一个XML文档(XML document)来定义的。这个映射文档被设计为易读的， 并且可以手工修改。映射语言是以Java为中心，这意味着映射文档是按照持久化类的定义来创建的， 而非表的定义。

请注意，虽然很多Hibernate用户选择手写XML映射文档，但也有一些工具可以用来生成映射文档， 包括XDoclet,Middlegen和AndroMDA。

让我们从一个映射的例子开始：

  1. <?xml version="1.0"?>
  2. <!DOCTYPE hibernate-mapping PUBLIC
  3.       "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
  4.           "http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">
  6. <hibernate-mapping package="eg">
  8.         <class name="Cat" 
  9.             table="cats"
  10.             discriminator-value="C">
  12.                 <id name="id">
  13.                         <generator class="native"/>
  14.                 </id>
  16.                 <discriminator column="subclass" 
  17.                      type="character"/>
  19.                 <property name="weight"/>
  21.                 <property name="birthdate"
  22.                     type="date" 
  23.                     not-null="true" 
  24.                     update="false"/>
  26.                 <property name="color"
  27.                     type="eg.types.ColorUserType"
  28.                     not-null="true"
  29.                     update="false"/>
  31.                 <property name="sex"
  32.                     not-null="true" 
  33.                     update="false"/>
  35.                 <property name="litterId"
  36.                     column="litterId"
  37.                     update="false"/>
  39.                 <many-to-one name="mother"
  40.                     column="mother_id"
  41.                     update="false"/>
  43.                 <set name="kittens"
  44.                     inverse="true"
  45.                     order-by="litter_id">
  46.                         <key column="mother_id"/>
  47.                         <one-to-many class="Cat"/>
  48.                 </set>
  50.                 <subclass name="DomesticCat"
  51.                     discriminator-value="D">
  53.                         <property name="name" 
  54.                             type="string"/>
  56.                 </subclass>
  58.         </class>
  60.         <class name="Dog">
  61.                 <!-- mapping for Dog could go here -->
  62.         </class>
  64. </hibernate-mapping>

我们现在开始讨论映射文档的内容。我们只描述Hibernate在运行时用到的文档元素和属性。 映射文档还包括一些额外的可选属性和元素，它们在使用schema导出工具的时候会影响导出的数据库schema结果。 （比如， not-null 属性。）