hibernate.txt

struts spring hibernate 学习可以参考的资料哦！

cascade="all" 表示所有情况下均进行级联操作
inverse="true" 表示双向关联


   set节点有以下属性（摘自Hibernate文档）：
(1)  name 集合属性的名称 
 
(2)  table （可选——默认为属性的名称）这个集合表的名称(不能在一对多的关联关系中使用) 
 
(3)  schema (可选) 表的schema的名称, 他将覆盖在根元素中定义的schema 
 
(4)  lazy (可选——默认为false) lazy(可选--默认为false) 允许延迟加载（lazy initialization ）(不能在数组中使用) 
 
(5)  inverse (可选——默认为false) 标记这个集合作为双向关联关系中的方向一端。 
 
(6)  cascade (可选——默认为none) 让操作级联到子实体 
 
(7)  sort (可选)指定集合的排序顺序, 其可以为自然的(natural)或者给定一个用来比较的类。 
 
(8)  order-by (可选, 仅用于jdk1.4) 指定表的字段(一个或几个)再加上asc或者desc(可选), 定义Map,Set和Bag的迭代顺序 
 
(9)  where (可选) 指定任意的SQL where条件, 该条件将在重新载入或者删除这个集合时使用(当集合中的数据仅仅是所有可用数据的一个子集时这个条件非常有用) 
 
(10)  outer-join (可选)指定这个集合,只要可能,应该通过外连接(outer join)取得。在每一个SQL语句中, 只能有一个集合可以被通过外连接抓取(译者注: 这里提到的SQL语句是取得集合所属类的数据的Select语句) 
 
(11)  batch-size (可选, 默认为1) 指定通过延迟加载取得集合实例的批处理块大小（"batch size"）。 
 
(12)  access (可选-默认为属性property):Hibernate取得属性值时使用的策略 
 



many-to-one节点有以下属性（摘自Hibernate文档）：
(1) name: 属性名。 
 
(2) column (可选): 字段名。 
 
(3) class (可选 - 默认是通过反射得到属性类型): 关联的类的名字。 
 
(4) cascade（级联） (可选): 指明哪些操作会从父对象级联到关联的对象。 
 
(5) outer-join（外连接） (可选 - 默认为 自动): 当设置hibernate.use_outer_join的时候，对这个关联允许外连接抓取。 
 
(6) update, insert (可选 - defaults to true) 指定对应的字段是否在用于UPDATE 和/或 INSERT的SQL语句中包含。如果二者都是false,则这是一个纯粹的“外源性（derived）”关联，它的值是通过映射到同一个（或多个）字段的某些其他属性得到的，或者通过trigger(除法器），或者是其他程序。 
 
(7) property-ref: (可选) 指定关联类的一个属性，这个属性将会和本外键相对应。如果没有指定，会使用对方关联类的主键。 
 
(8) access (可选 - 默认是 property): Hibernate用来访问属性的策略。 
 
****
数据库适配器（dialect）用于对特定数据库提供支持，其中包含了针对特定数据库特性的实现，如hibernate数据类型到特定数据库数据类型的映射等。


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




<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)
        entity-name="EntityName"                      (22)
        node="element-name"                           (23)
/>
(1) name (可选): 持久化类（或者接口）的Java全限定名。 如果这个属性不存在，Hibernate将假定这是一个非POJO的实体映射。 
 
(2) table (可选 - 默认是类的非全限定名): 对应的数据库表名。 
 
(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 将会在运行时动态生成，并且只包含那些非空值字段。 
 
(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 (optional): 通过设置lazy="false"， 所有的延迟加载（Lazy fetching）功能将未被激活（disabled）。 
 
(17) entity-name (可选): Hibernate3允许一个类进行多次映射（ 默认情况是映射到不同的表），并且允许使用Maps或XML代替Java层次的实体映射 （也就是实现动态领域模型，不用写持久化类－译注）。 更多信息请看第 5.4 节 “动态模型(Dynamic models)” and 第 19 章 XML映射。 
 
(18) check (可选): 这是一个SQL表达式， 用于为自动生成的schema添加多行（multi-row）约束检查。 
 
(19) rowid (可选): Hibernate可以使用数据库支持的所谓的ROWIDs，例如： Oracle数据库，如果你设置这个可选的rowid， Hibernate可以使用额外的字段rowid实现快速更新。ROWID是这个功能实现的重点， 它代表了一个存储元组（tuple）的物理位置。 
 
(20) subselect (可选): 它将一个不可变（immutable）并且只读的实体映射到一个数据库的 子查询中。它用于实现一个视图代替一张基本表，但是最好不要这样做。更多的介绍请看下面内容。 
 
(21) abstract (可选): 用于在<union-subclass>的继承结构 （hierarchies）中标识抽象超类。 
 
(22) entity-name (可选, 默认为类名): 显式指定实体名 
 




*******************************************
被映射的类必须定义对应数据库表主键字段。大多数类有一个JavaBeans风格的属性， 为每一个实例包含唯一的标识。<id> 元素定义了该属性到数据库表主键字段的映射。 

<id
        name="propertyName"                                          (1)
        type="typename"                                              (2)
        column="column_name"                                         (3)
        unsaved-value="null|any|none|undefined|id_value"             (4)
        access="field|property|ClassName"                            (5)
        node="element-name|@attribute-name|element/@attribute|.">

        <generator class="generatorClass"/>
</id>
(1) name (可选): 标识属性的名字。 
 
(2) type (可选): 标识Hibernate类型的名字。 
 
(3) column (可选 - 默认为属性名): 主键字段的名字。 
 
(4) unsaved-value (可选 - 默认为一个字段判断（sensible）的值): 一个特定的标识属性值，用来标志该实例是刚刚创建的，尚未保存。 这可以把这种实例和从以前的session中装载过（可能又做过修改--译者注） 但未再次持久化的实例区分开来。 
 
(5) access (可选 - 默认为property): Hibernate用来访问属性值的策略。 
 

如果 name属性不存在，会认为这个类没有标识属性。 

unsaved-value 属性很重要！如果你的类的标识属性不是默认为 正常的Java默认值（null或零），你应该指定正确的默认值。 

还有一个另外的<composite-id>定义可以访问旧式的多主键数据。 我们强烈不建议使用这种方式。

***************************************************



********************************************************
可选的<generator>子元素是一个Java类的名字， 用来为该持久化类的实例生成唯一的标识。如果这个生成器实例需要某些配置值或者初始化参数， 用<param>元素来传递。 

<id name="id" type="long" column="cat_id">
        <generator class="org.hibernate.id.TableHiLoGenerator">
                <param name="table">uid_table</param>