007---Hibernate基本映射标签和属性介绍(一)

一、映射文件的基本结构举例：

<?xml version="1.0"?>

<!DOCTYPE hibernate-mapping PUBLIC

    "-//Hibernate/Hibernate Mapping DTD 3.0//EN"

    "http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">

<hibernate-mapping>

    <!--

        class标签 实体类映射到数据表

        * name属性：实体类的完整路径

        * table属性：实体类映射到数据库中的表名，如果省略，则为实体类的类名称

    -->

    <class name="com.wjt276.hibernate.User">

        <!-- 映射数据库主键 映射到数据表中的字段名默认为类属性名，但可以利用column重新指定-->

        <id name="id" column="id">

            <!-- generator设置主键生成策略

                uuid:一万年内生成唯一的字符串

            -->

            <generator class="uuid"/>

        </id>

        <!-- property 映射普通属性  映射到数据表中的字段名默认为类属性名，但可以利用column重新指定-->

        <property name="name" column="name"/>

        <property name="password"/>

        <property name="createTime"/><!--Hibernate会自动根据实体类属性类型生成数据库表中字段类型 -->

        <property name="expireTime"/>

    </class>

</hibernate-mapping>

 

------2009/10/19--------------

 

通常实体类需要映射成表，这个类与通常类不一样的。

实体类---->表

实体类中的普通属性(基本Java数据类型)---表字段

使用<class>标签映射成数据库表，通过<property>标签将普通属性映射成数据表字段。

所有普通属性：不包括自定义类、集合和数组等的Java基本数据类型。

 

二、<hibernate-mapping>标签：

这个元素包括一些可选的属性。schema和catalog属性， 指明了这个映射所连接（refer）的表所在的schema和/或catalog名称。 假若指定了这个属性，表名会加上所指定的schema和catalog的名字扩展为全限定名。假若没有指定，表名就不会使用全限定名。 default-cascade指定了未明确注明cascade属性的Java属性和 集合类Hibernate会采取什么样的默认级联风格。auto-import属性默认让我们在查询语言中可以使用 非全限定名的类名。

<hibernate-mapping

         schema="schemaName"                          (1)

         catalog="catalogName"                        (2)

         default-cascade="cascade_style"              (3)

         default-access="field|property|ClassName"    (4)

         default-lazy="true|false"                    (5)

         auto-import="true|false"                     (6)

         package="package.name"                       (7)

 />

(1)  schema (可选): 数据库schema的名称。

(2)  catalog (可选): 数据库catalog的名称。

(3)  default-cascade (可选 - 默认为 none): 默认的级联风格。

(4)  default-access (可选 - 默认为 property): Hibernate用来访问所有属性的策略。可以通过实现PropertyAccessor接口 自定义。

(5)  default-lazy (可选 - 默认为 true): 指定了未明确注明lazy属性的Java属性和集合类， Hibernate会采取什么样的默认加载风格。

(6)  auto-import (可选 - 默认为 true): 指定我们是否可以在查询语言中使用非全限定的类名（仅限于本映射文件中的类）。

(7)  package (可选): 指定一个包前缀，如果在映射文档中没有指定全限定的类名， 就使用这个作为包名。

假若你有两个持久化类，它们的非全限定名是一样的（就是两个类的名字一样，所在的包不一样--译者注）， 你应该设置auto-import="false"。如果你把一个“import过”的名字同时对应两个类， Hibernate会抛出一个异常。

 

注意hibernate-mapping 元素允许你嵌套多个如上所示的 <class>映射。但是最好的做法（也许一些工具需要的）是一个 持久化类（或一个类的继承层次）对应一个映射文件，并以持久化的超类名称命名，例如： Cat.hbm.xml， Dog.hbm.xml，或者如果使用继承，Animal.hbm.xml。

三、<class>标签

你可以使用class元素来定义一个持久化类：

<class

        name="ClassName"                              (1)

        table="tableName"                             (2)

        discriminator-value="discriminator_value"     (3)

        mutable="true|false"                          (4)

        schema="owner"                                (5)

        catalog="catalog"                             (6)

        proxy="ProxyInterface"                        (7)

        dynamic-update="true|false"                   (8)

        dynamic-insert="true|false"                   (9)

        select-before-update="true|false"             (10)

        polymorphism="implicit|explicit"              (11)

        where="arbitrary sql where condition"         (12)

        persister="PersisterClass"                    (13)

        batch-size="N"                                (14)

        optimistic-lock="none|version|dirty|all"      (15)

        lazy="true|false"                             (16)

        entity-name="EntityName"                      (17)

        check="arbitrary sql check condition"         (18)

        rowid="rowid"                                 (19)

        subselect="SQL expression"                    (20)

        abstract="true|false"                         (21)

        node="element-name"

/>

    (1) name (可选): 持久化类（或者接口）的Java全限定名。 如果这个属性不存在，Hibernate将假定这是一个非POJO的实体映射。

    (2) table (可选 - 默认是类的非全限定名): 对应的数据库表名，生成DDL时数据表名，如果省略，则名称同持久化类名称。

    (3) discriminator-value (可选 - 默认和类名一样): 一个用于区分不同的子类的值，在多态行为时使用。它可以接受的值包括 null 和 not null。

    (4) mutable (可选，默认值为true): 表明该类的实例是可变的或者不可变的。

    (5) schema (可选): 覆盖在根<hibernate-mapping>元素中指定的schema名字。

    (6) catalog (可选): 覆盖在根<hibernate-mapping>元素中指定的catalog名字。

    (7) proxy (可选): 指定一个接口，在延迟装载时作为代理使用。 你可以在这里使用该类自己的名字。

    (8) dynamic-update (可选, 默认为 false): 指定用于UPDATE 的SQL将会在运行时动态生成，并且只更新那些改变过的字段(只更新修改的字段，没有修改的字段不进行更新)。

    (9) dynamic-insert (可选, 默认为 false): 指定用于INSERT的 SQL 将会在运行时动态生成，并且只包含那些非空值字段(在添加记录时，只添加非null的字段)。

    (10) select-before-update (可选, 默认为 false): 指定Hibernate除非确定对象真正被修改了（如果该值为true－译注），否则不会执行SQL UPDATE操作。在特定场合（实际上，它只在一个瞬时对象（transient object）关联到一个 新的session中时执行的update()中生效），这说明Hibernate会在UPDATE 之前执行一次额外的SQL SELECT操作，来决定是否应该执行 UPDATE。

    (11) polymorphism（多态） (可选, 默认值为 implicit (隐式) ): 界定是隐式还是显式的使用多态查询（这只在Hibernate的具体表继承策略中用到－译注）。

    (12) where (可选) 指定一个附加的SQLWHERE 条件， 在抓取这个类的对象时会一直增加这个条件。

    (13) persister (可选): 指定一个定制的ClassPersister。

    (14) batch-size (可选,默认是1) 指定一个用于 根据标识符（identifier）抓取实例时使用的"batch size"（批次抓取数量）。

    (15) optimistic-lock（乐观锁定） (可选，默认是version): 决定乐观锁定的策略。

    (16) lazy (可选): 通过设置lazy="false"， 所有的延迟加载（Lazy fetching）功能将被全部禁用（disabled）。

    (17) entity-name (可选，默认为类名): Hibernate3允许一个类进行多次映射（ 前提是映射到不同的表），并且允许使用Maps或XML代替Java层次的实体映射 （也就是实现动态领域模型，不用写持久化类－译注）。