5.1.3. class

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

  1. <class
  2.         name="ClassName"
  3.         table="tableName"
  4.         discriminator-value="discriminator_value"
  5.         mutable="true|false"
  6.         schema="owner"
  7.         catalog="catalog"
  8.         proxy="ProxyInterface"
  9.         dynamic-update="true|false"
  10.         dynamic-insert="true|false"
  11.         select-before-update="true|false"
  12.         polymorphism="implicit|explicit"
  13.         where="arbitrary sql where condition"
  14.         persister="PersisterClass"
  15.         batch-size="N"
  16.         optimistic-lock="none|version|dirty|all"
  17.         lazy="true|false"
  18.         entity-name="EntityName"
  19.         check="arbitrary sql check condition"
  20.         rowid="rowid"
  21.         subselect="SQL expression"
  22.         abstract="true|false"
  23.         node="element-name"
  24. />
1name (可选): 持久化类（或者接口）的Java全限定名。 如果这个属性不存在，Hibernate将假定这是一个非POJO的实体映射。
2table (可选 - 默认是类的非全限定名): 对应的数据库表名。
3discriminator-value (可选 - 默认和类名一样): 一个用于区分不同的子类的值，在多态行为时使用。它可以接受的值包括 null 和 not null。
4mutable (可选，默认值为true): 表明该类的实例是可变的或者不可变的。
5schema (可选): 覆盖在根&lt;hibernate-mapping&gt;元素中指定的schema名字。
6catalog (可选): 覆盖在根&lt;hibernate-mapping&gt;元素中指定的catalog名字。
7proxy (可选): 指定一个接口，在延迟装载时作为代理使用。 你可以在这里使用该类自己的名字。
8dynamic-update (可选, 默认为 false): 指定用于UPDATE 的SQL将会在运行时动态生成，并且只更新那些改变过的字段。
9dynamic-insert (可选, 默认为 false): 指定用于INSERT的 SQL 将会在运行时动态生成，并且只包含那些非空值字段。
10select-before-update (可选, 默认为 false): 指定Hibernate除非确定对象真正被修改了（如果该值为true－译注），否则不会执行SQL UPDATE操作。在特定场合（实际上，它只在一个瞬时对象（transient object）关联到一个 新的session中时执行的update()中生效），这说明Hibernate会在UPDATE 之前执行一次额外的SQL SELECT操作，来决定是否应该执行 UPDATE。
11polymorphism（多态） (可选, 默认值为 implicit (隐式) ): 界定是隐式还是显式的使用多态查询（这只在Hibernate的具体表继承策略中用到－译注）。
12where (可选) 指定一个附加的SQLWHERE 条件， 在抓取这个类的对象时会一直增加这个条件。
13persister (可选): 指定一个定制的ClassPersister。
14batch-size (可选,默认是1) 指定一个用于 根据标识符（identifier）抓取实例时使用的"batch size"（批次抓取数量）。
15optimistic-lock（乐观锁定） (可选，默认是version): 决定乐观锁定的策略。
(16)lazy (可选): 通过设置lazy="false"， 所有的延迟加载（Lazy fetching）功能将被全部禁用（disabled）。
(17)entity-name (可选，默认为类名): Hibernate3允许一个类进行多次映射（ 前提是映射到不同的表），并且允许使用Maps或XML代替Java层次的实体映射 （也就是实现动态领域模型，不用写持久化类－译注）。 更多信息请看第 4.4 节 “动态模型(Dynamic models)” and 第 18 章 XML映射。
(18)check (可选): 这是一个SQL表达式， 用于为自动生成的schema添加多行（multi-row）约束检查。
(19)rowid (可选): Hibernate可以使用数据库支持的所谓的ROWIDs，例如： Oracle数据库，如果你设置这个可选的rowid， Hibernate可以使用额外的字段rowid实现快速更新。ROWID是这个功能实现的重点， 它代表了一个存储元组（tuple）的物理位置。
(20)subselect (可选): 它将一个不可变（immutable）并且只读的实体映射到一个数据库的 子查询中。当你想用视图代替一张基本表的时候，这是有用的，但最好不要这样做。更多的介绍请看下面内容。
(21)abstract (可选): 用于在&lt;union-subclass&gt;的继承结构 （hierarchies）中标识抽象超类。

若指明的持久化类实际上是一个接口，这也是完全可以接受的。 之后你可以用元素&lt;subclass&gt;来指定该接口的实际实现类。 你可以持久化任何static（静态的）内部类。 你应该使用标准的类名格式来指定类名，比如：Foo$Bar。

不可变类，mutable="false"不可以被应用程序更新或者删除。 这可以让Hibernate做一些小小的性能优化。

可选的proxy属性允许延迟加载类的持久化实例。 Hibernate开始会返回实现了这个命名接口的CGLIB代理。当代理的某个方法被实际调用的时候， 真实的持久化对象才会被装载。参见下面的“用于延迟装载的代理”。

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

persister属性可以让你定制这个类使用的持久化策略。 你可以指定你自己实现 org.hibernate.persister.EntityPersister的子类，你甚至可以完全从头开始编写一个 org.hibernate.persister.ClassPersister接口的实现， 比如是用储存过程调用、序列化到文件或者LDAP数据库来实现。 参阅org.hibernate.test.CustomPersister，这是一个简单的例子 （“持久化”到一个Hashtable）。

请注意dynamic-update和dynamic-insert的设置并不会继承到子类， 所以在&lt;subclass&gt;或者&lt;joined-subclass&gt;元素中可能 需要再次设置。这些设置是否能够提高效率要视情形而定。请用你的智慧决定是否使用。

使用select-before-update通常会降低性能。如果你重新连接一个脱管（detache）对象实例 到一个Session中时，它可以防止数据库不必要的触发update。 这就很有用了。

如果你打开了dynamic-update，你可以选择几种乐观锁定的策略：

  • version（版本检查） 检查version/timestamp字段

  • all（全部） 检查全部字段

  • dirty（脏检查）只检察修改过的字段

  • none（不检查）不使用乐观锁定

我们非常强烈建议你在Hibernate中使用version/timestamp字段来进行乐观锁定。 对性能来说，这是最好的选择，并且这也是唯一能够处理在session外进行操作的策略（例如： 在使用Session.merge()的时候）。

对Hibernate映射来说视图和表是没有区别的，这是因为它们在数据层都是透明的（ 注意：一些数据库不支持视图属性，特别是更新的时候）。有时你想使用视图，但却不能在数据库 中创建它（例如：在遗留的schema中）。这样的话，你可以映射一个不可变的（immutable）并且是 只读的实体到一个给定的SQL子查询表达式：

  1. <class name="Summary">
  2.     <subselect>
  3.         select item.name, max(bid.amount), count(*)
  4.         from item
  5.         join bid on bid.item_id = item.id
  6.         group by item.name
  7.     </subselect>
  8.     <synchronize table="item"/>
  9.     <synchronize table="bid"/>
  10.     <id name="name"/>
  11.     ...
  12. </class>

定义这个实体用到的表为同步（synchronize），确保自动刷新（auto-flush）正确执行， 并且依赖原实体的查询不会返回过期数据。&lt;subselect&gt;在属性元素 和一个嵌套映射元素中都可见。