hibernate2 参考文档之五.txt

Hibernate使用说明书

根据底层数据库的能力选择identity, sequence 或者hilo中的一个。 

assigned（程序设置）
让应用程序在save()之前为对象分配一个标示符。 

foreign（外部引用）
使用另外一个相关联的对象的标识符。和<one-to-one>联合一起使用。 


5.1.4.2. 高/低位算法（Hi/Lo Algorithm）
hilo 和 seqhilo生成器给出了两种hi/lo算法的实现，这是一种很令人满意的标识符生成算法。第一种实现需要一个“特殊”的数据库表来保存下一个可用的“hi”值。第二种实现使用一个Oracle风格的序列（在被支持的情况下）。 

<id name="id" type="long" column="cat_id">
        <generator class="hilo">
                <param name="table">hi_value</param>
                <param name="column">next_value</param>
                <param name="max_lo">100</param>
        </generator>
</id>
<id name="id" type="long" column="cat_id">
        <generator class="seqhilo">
                <param name="sequence">hi_value</param>
                <param name="max_lo">100</param>
        </generator>
</id>
很不幸，你在为Hibernate自行提供Connection，或者Hibernate使用JTA获取应用服务器的数据源连接的时候无法使用hilo 。Hibernate必须能够在一个新的事务中得到一个"hi"值。在EJB环境中实现hi/lo算法的标准方法是使用一个无状态的session bean。 

5.1.4.3. UUID算法（UUID Algorithm ）
UUID包含：IP地址，JVM的启动时间（精确到1/4秒），系统时间和一个计数器值（在JVM中唯一）。在Java代码中不可能获得MAC地址或者内存地址，所以这已经是我们在不使用JNI的前提下的能做的最好实现了。 

不要试图在PostgreSQL中使用uuid.string。 

5.1.4.4. 标识字段和序列（Identity Columns and Sequences）
对于内部支持标识字段的数据库(DB2,MySQL,Sybase,MS SQL)，你可以使用identity关键字生成。对于内部支持序列的数据库（DB2,Oracle, PostgreSQL, Interbase, McKoi,SAP DB),你可以使用sequence风格的关键字生成。这两种方式对于插入一个新的对象都需要两次SQL查询。 

<id name="id" type="long" column="uid">
        <generator class="sequence">
                <param name="sequence">uid_sequence</param>
        </generator>
</id>
<id name="id" type="long" column="uid" unsaved-value="0">
        <generator class="identity"/>
</id>
对于跨平台开发，native策略会从identity, sequence 和hilo中进行选择，取决于底层数据库的支持能力。 

5.1.4.5. 程序分配的标识符（Assigned Identifiers）
如果你需要应用程序分配一个标示符（而非Hibernate来生成它们），你可以使用assigned生成器。这种特殊的生成器会使用已经分配给对象的标识符属性的标识符值。用这种特性来分配商业行为的关键字要特别小心（基本上总是一种可怕的设计决定）。 

5.1.5. composite-id 联合ID
<composite-id
        name="propertyName"
        class="ClassName"
        unsaved-value="any|none">

        <key-property name="propertyName" type="typename" column="column_name"/>
        <key-many-to-one name="propertyName" class="ClassName" column="column_name"/>
        ......
</composite-id>
如果表使用联合主键，你可以把类的多个属性组合成为标识符属性。<composite-id>元素接受<key-property>属性映射和<key-many-to-one>属性映射作为子元素。 

<composite-id>
        <key-property name="medicareNumber"/>
        <key-property name="dependent"/>
</composite-id>
你的持久化类必须重载equals()和hashCode()方法，来实现组合的标识符判断等价.也必须实现Serializable接口。 

不幸的是，这种组合关键字的方法意味着一个持久化类是它自己的标识。除了对象自己之外，没有什么方便的“把手”可用。你必须自己初始化持久化类的实例，在使用组合关键字load()持久化状态之前，必须填充他的联合属性。我们会在Section 7.4, “作为联合标识符(As Composite Identifiers)”章中说明一种更加方便的方法，把联合标识实现为一个独立的类，下面描述的属性只对这种备用方法有效: 

name (可选）：一个组件类型，持有联合标识（参见下一节）。 

class (可选 - 默认为通过反射(reflection)得到的属性类型) : 作为联合标识的组件类名(参见下一节)。 

unsaved-value (可选 - 默认为 none): 假如被设置为非none的值，就表示新创建，尚未被持久化的实例将持有的值。 

5.1.6. 识别器（discriminator）
在"一棵对象继承树对应一个表"的策略中,<discriminator>元素是必需的,它声明了表的识别器字段。识别器字段
识别器字段包含标志值，用于告知持久化层应该为某个特定的行创建哪一个子类的实例。只能使用如下受到限制的一些类型： string, character, integer, byte, short, boolean, yes_no, true_false. 

<discriminator
        column="discriminator_column"  
        type="discriminator_type"      
        force="true|false"             
/>
 column (可选 - 默认为 class) 识别器字段的名字 
 
 type (可选 - 默认为 string) 一个Hibernate字段类型的名字 
 
 force(强制) (可选 - 默认为 false) "强制"Hibernate指定允许的识别器值,就算取得的所有实例都是根类的。 
 

标识器字段的实际值是根据<class> 和<subclass>元素的discriminator-value得来的. 

force属性仅仅是在表包含一些未指定应该映射到哪个持久化类的时候才是有用的。这种情况不是经常会遇到。 

5.1.7. 版本（version）(可选)
<version>元素是可选的，表明表中包含附带版本信息的数据。这在你准备使用 长事务（long transactions）的时候特别有用。（见后） 

<version
        column="version_column"   
        name="propertyName"       
        type="typename"           
        access="field|property|ClassName"                  
        unsaved-value="null|negative|undefined"            
/>
 column (可选 - 默认为属性名): 指定持有版本号的字段名。 
 
 name: 持久化类的属性名。 
 
 type (可选 - 默认是 integer): 版本号的类型。 
 
 access (可选 - 默认是 property): Hibernate用于访问属性值的策略。 
 
 unsaved-value (可选 - 默认是undefined): 用于标明某个实例时刚刚被实例化的（尚未保存）版本属性值，依靠这个值就可以把这种情况和已经在先前的session中保存或装载的实例区分开来。（undefined指明使用标识属性值进行这种判断。） 
 

版本号必须是以下类型：long, integer, short, timestamp或者calendar。 

5.1.8. 时间戳（timestamp ）(可选)
可选的<timestamp>元素指明了表中包含时间戳数据。这用来作为版本的替代。时间戳本质上是一种对乐观锁定的一种不是特别安全的实现。当然，有时候应用程序可能在其他方面使用时间戳。 

<timestamp
        column="timestamp_column"      
        name="propertyName"            
        access="field|property|ClassName"   
        unsaved-value="null|undefined"      
/>
 column (可选 - 默认为属性名): 持有时间戳的字段名。 
 
 name: 在持久化类中的JavaBeans风格的属性名，其Java类型是 Date 或者 Timestamp的。 
 
 access (可选 - 默认是 property): Hibernate用于访问属性值的策略。 
 
 unsaved-value (可选 - 默认是null): 用于标明某个实例时刚刚被实例化的（尚未保存）版本属性值，依靠这个值就可以把这种情况和已经在先前的session中保存或装载的实例区分开来。（undefined指明使用标识属性值进行这种判断。） 
 

注意，<timestamp> 和<version type="timestamp">是等价的。 

5.1.9. property
<property>元素为类声明了一个持久化的,JavaBean风格的属性。 

<property
        name="propertyName"                 
        column="column_name"                
        type="typename"                     
        update="true|false"                 
        insert="true|false"                 
        formula="arbitrary SQL expression"  
        access="field|property|ClassName"   
/>
 name: 属性的名字,以小写字母开头。 
 
 column (可选 - 默认为属性名字): 对应的数据库字段名。 
 
 type (可选): 一个Hibernate类型的名字。 
 
 update, insert (可选 - 默认为 true) :表明在用于UPDATE 和/或 INSERT的SQL语句中是否包含这个字段。这二者如果都设置为false则表明这是一个“外源性（derived）”的属性，它的值来源于映射到同一个（或多个）字段的某些其他属性，或者通过一个trigger(触发器），或者其他程序。 
 
 formula (可选): 一个SQL表达式，定义了这个计算（computed） 属性的值。计算属性没有和它对应的数据库字段。 
 
 access (可选 - 默认值为 property): Hibernate用来访问属性值的策略。 
 

typename可以是如下几种： 

Hibernate基础类型之一（比如：integer, string, character,date, timestamp, float, binary, serializable, object, blob）。 

一个Java类的名字，这个类属于一种默认基础类型 (比如： int, float,char, java.lang.String, java.util.Date, java.lang.Integer, java.sql.Clob)。 

一个PersistentEnum的子类的名字。(比如：. eg.Color)。 

一个可以序列化的Java类的名字。 

一个自定义类型的类的名字。（比如： com.illflow.type.MyCustomType)。 

如果你没有指定类型，Hibernarte会使用反射来得到这个名字的属性，以此来猜测正确的Hibernate类型。Hibernate会对属性读取器(getter方法）的返回类进行解释，按照规则2,3,4的顺序。然而，这并不足够。 在某些情况下你仍然需要type属性。（比如，为了区别Hibernate.DATE和Hibernate.TIMESTAMP,或者为了指定一个自定义类型。） 

access属性用来让你控制Hibernate如何在运行时访问属性。在默认情况下，Hibernate会使用属性的get/set方法对。如果你指明access="field",Hibernate会忽略get/set方法对，直接使用反射来访问成员变量。你也可以指定你自己的策略，这就需要你自己实现net.sf.hibernate.property.PropertyAccessor接口，再在access中设置你自定义策略类的名字。 

5.1.10. 多对一（many-to-one）
通过many-to-one元素,可以定义一种常见的与另一个持久化类的关联。这种关系模型是多对一关联。（实际上是一个对象引用。） 

<many-to-one
        name="propertyName"                      
        column="column_name"                     
        class="ClassName"                        
        cascade="all|none|save-update|delete"    
        outer-join="true|false|auto"             
        update="true|false"                      
        insert="true|false"                      
        property-ref="propertyNameFromAssociatedClass"     
        access="field|property|ClassName"                  
/>
 name: 属性名。 
 
 column (可选): 字段名。 
 
 class (可选 - 默认是通过反射得到属性类型): 关联的类的名字。 
 
 cascade（级联） (可选): 指明哪些操作会从父对象级联到关联的对象。 
 
 outer-join（外连接） (可选 - 默认为 自动): 当设置hibernate.use_outer_join的时候，对这个关联允许外连接抓取。 
 
 update, insert (可选 - defaults to true) 指定对应的字段是否在用于UPDATE 和/或 INSERT的SQL语句中包含。如果二者都是false,则这是一个纯粹的“外源性（derived）”关联，它的值是通过映射到同一个（或多个）字段的某些其他属性得到的，或者通过trigger(除法器），或者是其他程序。 
 
 property-ref: (可选) 指定关联类的一个属性，这个属性将会和本外键相对应。如果没有指定，会使用对方关联类的主键。 
 
 access (可选 - 默认是 property): Hibernate用来访问属性的策略。