hibernate学习之第三篇（映射文件的配置）

  如果不希望使用默认的hibernate.cfg.xml 文件作为配置文件，我们也可以指定配置文件名：
File file = new File("C:\\myhibernate.xml");
Configuration config = new Configuration().configure(file);

<class
        name="ClassName"                             
        table="tableName"                            
        discriminator-value="discriminator_value"    
        mutable="true|false"                         
        schema="owner"                               
        proxy="ProxyInterface"                       
        dynamic-update="true|false"                  
        dynamic-insert="true|false"                  
        select-before-update="true|false"            
        polymorphism="implicit|explicit"             
        where="arbitrary sql where condition"         (11)
        persister="PersisterClass"                    (12)
        batch-size="N"                                (13)
        optimistic-lock="none|version|dirty|all"      (14)
        lazy="true|false"                             (15)
/>

 

        select-before-update (可选，默认值为false): 指定Hibernate除非确定对象的确被修改了，不会执行SQL UPDATE操作。在特定场合（实际上，只会发生在一个临时对象关联到一个新的session中去，执行update()的时候），这说明Hibernate会在UPDATE之前执行一次额外的SQL SELECT操作，来决定是否应该进行UPDATE。
        使用select-before-update通常会降低性能.当是在防止数据库不必要的触发update触发器，这就很有用了。

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

        (15) lazy（延迟） (可选): 假若设置 lazy="true"，就是设置这个类自己的名字作为proxy接口的一种等价快捷形式。
 
        polymorphism（多形，多态） (可选, 默认值为 implicit (隐式)): 界定是隐式还是显式的使用查询多态。

        Implicit (隐式)的多态是指，如果查询中给出的是任何超类、该类实现的接口或者该类的名字，都会返回这个类的实例；如果查询中给出的是子类的名字，则会返回子类的实例。 Explicit （显式）的多态是指，只有在查询中给出的明确是该类的名字时才会返回这个类的实例；同时只有当在这个<class>的定义中作为<subclass>或者<joined-subclass>出现的子类，才会可能返回。 大多数情况下，默认的polymorphism="implicit"都是合适的。 显式的多态在有两个不同的类映射到同一个表的时候很有用。（允许一个“轻型”的类，只包含部分表字段）。

<id
        name="propertyName"                     
        type="typename"                         
        column="column_name"                    
        unsaved-value="any|none|null|id_value"  
        access="field|property|ClassName">      

        <generator class="generatorClass"/>
</id>

 

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

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

生成器：
increment （递增）
用于为long, short或者int类型生成唯一标识。只有在没有其他进程往同一张表中插入数据时才能使用。 在集群下不要使用。
不同于mysql数据库的自增长。这个increment是hibernate内部用一个计数器进行累加，不过累加有限，会出现重复，不适用于集群。

identity
指自增长的主键生成方式。对DB2,MySQL, MS SQL Server, Sybase和HypersonicSQL的内置标识字段提供支持。返回的标识符是long, short 或者int类型的。

sequence （序列）
在DB2,PostgreSQL, Oracle, SAP DB, McKoi中使用序列（sequence)，而在Interbase中使用生成器(generator)。返回的标识符是long, short或者 int类型的。

hilo （高低位）
使用一个高/低位算法来高效的生成long, short或者 int类型的标识符。给定一个表和字段（默认分别是是hibernate_unique_key 和next）作为高位值得来源。高/低位算法生成的标识符只在一个特定的数据库中是唯一的。在使用JTA获得的连接或者用户自行提供的连接中，不要使用这种生成器。
主键有两部分组成。高位是通过从数据库获得。在数据库中有个表用来维护高位值。
表hibernate_unique_key:
+---------+
| next_hi|
+---------+
|      0    |
+---------+
低位是hibernate内部在累加。

seqhilo（使用序列的高低位）
使用一个高/低位算法来高效的生成long, short或者 int类型的标识符，给定一个数据库序列（sequence)的名字。

uuid.hex
用一个128-bit的UUID算法生成字符串类型的标识符。在一个网络中唯一（使用了IP地址）。UUID被编码为一个32位16进制数字的字符串。 a

uuid.string
使用同样的UUID算法。UUID被编码为一个16个字符长的任意ASCII字符组成的字符串。不能使用在PostgreSQL数据库中

与高低位相比，不需要访问数据库获得主键，可以由hibernate在内部生成，而且保证任意两张表的主键唯一性。在插入时不需要访问数据库，插入的性能较高，使用插入频繁的情况。而且这种方式的可移植性较好，因为它和数据库没有关系，不受数据的约束。但是它按照主键查询时，由于是字符串，效率不如整型的高。

native（本地）
根据底层数据库的能力选择identity, sequence 或者hilo中的一个。 数据库，对于mysql会选择使用identity，对于oracle会选择使用sequence。如果这两种都不支持，则使用高低位。

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



识别器（discriminator）

<discriminator
        column="discriminator_column" 
        type="discriminator_type"     
        force="true|false"            
/>

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


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中设置你自定义策略类的名字。


       property-ref: (可选) 指定关联类的一个属性，这个属性将会和本外键相对应。如果没有指定，会使用对方关联类的主键。