Hibernate映射文件元素属性说明

Hibernate映射文件元素属性说明


Doctype
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping DTD 3.0//EN" "http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">
<!-- Generated 2008-10-1 20:56:03 by Hibernate Tools 3.2.1.GA -->


根元素hibernate-mapping


属性：


schema：数据库的schema名称


catalog：数据库的catalog名称


default-cascade：默认的级联方式 默认值为none


default-access：默认的属性访问方式 默认值为property


default-lazy：对没有指定延迟加载的映射类和集合设定为延迟加载 默认值为true


auto-import：设定此映射文件中是否可以在HQL中使用非完整的类名（不包括包名） 默认值为true


package：此映射文件中类默认的包名


子元素：


meta：用于设置类或属性的元数据属性


typedef：定义新的Hibernate数据类型


import：显示的引用一个类，避免在HQL语句中使用全类名


class：定义一个持久类


subclass：在进行多态持久化时定义父类的子类


joined-subclass：定义一个连接子类


union-subclass：定义一个联合子类


query：定义一个HQL查询


sql-query：定义一个SQL查询


filter-def：定义过滤器


class元素


属性：


name：持久化类的全名


table：对应的数据库表名 默认值为类名


discriminator-value：子类识别标识 默认值为类名


mutable：表明该类的实例是否是可变的 默认值为false


schema：数据库的schema名称


catalog：数据库的catalog名称


proxy：指定延迟加载代理类


dynamic-update：指定用于update的SQL语句是否动态生成 默认值为false


dynamic-insert：指定用于insert的SQL语句是否动态生成 默认值为false


insert-before-update：设定在Hibernate执行update之前是否通过select语句来确定对象是否确实被修改了，如果该对象的值没有改变，update语句将不会被执行 默认值为false


polymorphism：指定使用多态查询的方式 默认值为implicit


where：指定一个附加的SQL语句的where条件


persister：指定一个Persister类


batch-size：设定批量操作记录的数目 默认值为1


optimistic-lock：指定乐观锁定的策略 默认值为vesion


lazy：指定是否使用延迟加载


entity-name：实体名称 默认值为类名


check：指定一个SQL语句用于Schema前的条件检查


rowid：指定是否支持ROWID


subselect：将不可变的只读实体映射到数据库的子查询中


abstract：用于在联合子类中标识抽象的超类 默认值为false


 


子元素：


meta：设置类或属性的元数据属性


subselect：定义一个子查询


cache：定义缓存的策略


synchronize：定义持久化类所需要的同步资源


comment：定义表的注释


id：映射类中与数据库对应表主键相对应的标识字段（表中为独立字段的主键）


composite-id：映射类中与数据库对应表主键相对应的标识字段（表中为联合字段的主键）


natural-id：声明一个唯一的业务主键


discriminator：定义一个鉴别器


vesion：指定表所包含的附带版本信息的数据


timestamp：指定表中包含时间戳的数据


property：定义一个持久化类的属性


many-to-one：定义对象间的多对一的关联关系


one-to-one：定义对象间的一对一的关联关系


component：定义组件映射


dynamic-component：定义动态组件映射


properties：定义一个包含多个属性的逻辑分组


any：定义any映射类型


map：map类型的集合映射


set：set类型的集合映射


list：list类型的集合映射


bag：bag类型的集合映射


array：array类型的集合映射


primitive-array：primitive-array类型的集合映射


query-list：映射由查询返回的集合


join：将一个类的属性映射到多张表中


sub-class：声明多态映射中的子类


joined-subclass：生命多态映射中的来连接子类


union-subclass：声明多态映射中的联合子类


loader：定义持久化对象的加载器


sql-insert：使用定制的SQL语句执行insert操作


sql-update：使用定制的SQL语句执行update操作


sql-delete：使用定制的SQL语句执行delete操作


filter：定义Hibernate使用的过滤器


query：定义装载实体的HQL语句


sql-query：定义装载实体的SQL语句


id 元素


属性：


name：映射类中与主键相对应的属性名


type：主键属性的数据类型


column：主键字段的名称 默认值为属性名称


unsaved-value：判断此对象是否进行了保存


access：Hibernate访问主键属性的策略 默认值为property


子元素：


generator：为持久化实例产生一个唯一标识


generator 元素


属性：


class：定义实例生成器


increment（递增）用于为long, short或者int类型生成唯一标识。只有在没有其他进程往同一张表中插入数据时才能使用。 在集群下不要使用。 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_hi）作为高位值得来源。高/低位算法生成的标识符只在一个特定的数据库中是唯一的。在使用JTA获得的连接或者用户自行提供的连接中，不要使用这种生成器。 
seqhilo（使用序列的高低位） 使用一个高/低位算法来高效的生成long, short或者 int类型的标识符，给定一个数据库序列（sequence)的名字。 
uuid.hex 用一个128-bit的UUID算法生成字符串类型的标识符。在一个网络中唯一（使用了IP地址）。UUID被编码为一个32位16进制数字的字符串。 
uuid.string 使用同样的UUID算法。UUID被编码为一个16个字符长的任意ASCII字符组成的字符串。不能使用在PostgreSQL数据库中 
native（本地） 根据底层数据库的能力选择identity, sequence 或者hilo中的一个。 
assigned（程序设置） 让应用程序在save()之前为对象分配一个标示符。 
foreign（外部引用） 使用另外一个相关联的对象的标识符。和<one-to-one>联合一起使用。
name：映射类属性的名字


column：对应数据库表的字段名 默认值为属性名


type：字段的类型


update：update操作时是否包含本字段的数据 默认值为true


insert：insert操作时是否包含本字段的数据 默认值为true


formula：定义一个SQL来计算这个属性的值


access：Hibernate访问这个属性的策略 默认值为property


lazy：设置此字段是否采用延迟加载策略 默认值为false


unique：设置该字段值是否唯一 默认值为false


not-null：设置该字段值是否可以为空 默认值为false


optimistic-lock：指定此属性做更新操作时是否需要乐观锁定 默认值为true


set 元素


属性：


name：映射类属性的名字


access：Hibernate访问这个属性的策略 默认值为property


table：关联的目标数据库表


schema：目标数据库表的schema名字


catalog：目标数据库表的catalog名字


lazy：是否采用延迟加载


subselect：定义一个子查询


sort：设置排序的类型 默认值为 unsorted不排序 可选值为 natural自然排序、comparatorClass实现接口类作为排序算法 避免与order-by同时使用


inverse：用于标识双向关联中被动的一方 默认值为false


mutable：标识被关联对象是否可以改变 默认值为true


cascade：设置操作中的级联策略 可选值为 all所有操作情况均进行级联、none所有操作情况均不进行级联、save-update执行更新操作时级联、delete执行删除操作时级联、all-delete-orphan被关联对象失去宿主时将其删除


order-by：设置排序规则


where：增加筛选条件


batch-size：延迟加载时，一次读取数据的数量 默认值为1


fetch：设置抓取数据的策略 可选值为 join外连接抓取、select序列选择抓取


one-to-one 元素


属性：


name：映射类属性的名字


class：映射的目标类


cascade：设置操作中的级联策略 可选值为 all所有操作情况均进行级联、none所有操作情况均不进行级联、save-update执行更新操作时级联、delete执行删除操作时级联


constrained：表明当前类对应的表与被关联的表之间是否存在着外键约束 默认值为false


fetch：设置抓取数据的策略 可选值为 join外连接抓取、select序列选择抓取


property-ref：设置关联类的属性名，此属性和本类的主键相对应 默认值为关联类的主键


access：Hibernate访问这个属性的策略 默认值为property


formula：绝大多数一对一关联都指向其实体的主键。在某些情况下会指向一个或多个字段或是一个表达式，此时可用一个SQL公式来表示


lazy：指定是否采用延迟加载及加载策略 默认值为proxy通过代理进行关联 可选值为 true此对象采用延迟加载并在变量第一次被访问时抓取、false此关联对象不采用延迟加载


entity-name：被关联类的实体名


many-to-one 元素


属性：


name：映射类属性的名字


column：关联的字段


class：关联类的名字


cascade：设置操作中的级联策略 可选值为 all所有操作情况均进行级联、none所有操作情况均不进行级联、save-update执行save和update操作时级联、delete执行删除操作时级联


fetch：设置抓取数据的策略 默认值为select序列选择抓取 可选值为join外连接抓取


update：进行update操作时是否包含此字段


insert：进行insert操作时是否包含此字段




property 元素


属性：


property-ref：设置关联类的属性名，此属性和本类的关联相对应 默认值为关联类的主键


access：Hibernate访问这个属性的策略 默认值为property


unique：设置该字段值是否唯一 默认值为false


not-null：设置该字段值是否可以为空 默认值为false


optimistic-lock：指定此属性做更新操作时是否需要乐观锁定 默认值为true


lazy：指定是否采用延迟加载及加载策略 默认值为proxy通过代理进行关联 可选值为 true此对象采用延迟加载并在变量第一次被访问时抓取、false此关联对象不采用延迟加载


not-found：指定外键引用的数据不存在时如何让处理 默认值为exception产生异常 可选值为ignore对不存在的应用关联到null


entity-name：被关联类的实体名


 


many-to-one 元素


属性：


column：中间关联表映射到目标关联表的关联字段


class：关联的目标类


fetch：设置抓取数据的策略 默认值为select序列选择抓取 可选值为join外连接抓取


lazy：指定是否采用延迟加载及加载策略 默认值为proxy通过代理进行关联 可选值为 true此对象采用延迟加载并在变量第一次被访问时抓取、false此关联对象不采用延迟加载


formula：绝大多数一对一关联都指向其实体的主键。在某些情况下会指向一个或多个字段或是一个表达式，此时可用一个SQL公式来表示


 


not-found：指定外键引用的数据不存在时如何让处理 默认值为exception产生异常 可选值为ignore对不存在的应用关联到null


entity-name：被关联类的实体名


一步一个脚印，方便自己复习，该出手时就出手，有错误，一定要指正，非常感谢，共同进步！