持久化类(Persistent Classes)
在应用程序中,用来实现业务问题实体的(如,在电子商务应用程序中的Customer和Order)
类就是持久化类。不能认为所有的持久化类的实例都是持久的状态——一个实例的状态也可能
是瞬时的或脱管的。
如果这些持久化类遵循一些简单的规则,Hibernate能够工作得最好,这些规则被称作,
简单传统Java对象(POJO:Plain Old Java Object)编程模型。但是这些规则没有一个是必需的。
实际上,Hibernate3对于你的持久化类几乎不做任何设想。你可以用其他的方法来表达领域模型:
比如,使用Map实例的树型结构。
一个简单的POJO例子
大多数Java程序需要用一个持久化类来表示猫科动物。
这里要遵循四条主要的规则:
为持久化字段声明访问器(accessors)和是否可变的标志(mutators)
Cat为它的所有持久化字段声明了访问方法。很多其他ORM工具直接对
实例变量进行持久化。我们相信从持久化机制中分离这种实现细节要好得多。
Hibernate持久化JavaBeans风格的属性,认可如下形式的方法名:
getFoo, isFoo 和 setFoo。
如果需要,你总是可以切换特定的属性的指示字段的访问方法。
属性不需要要声明为public的。Hibernate默认使用
protected或private的get/set方法对,
对属性进行持久化。
实现一个默认的(即无参数的)构造方法(constructor)
Cat有一个无参数的构造方法。所有的持久化类都必须有一个
默认的构造方法(可以不是public的),这样的话Hibernate就可以使用
Constructor.newInstance()来实例化它们。
我们建议,在Hibernate中,为了运行期代理的生成,构造方法至少是
包(package)内可见的。
提供一个标识属性(identifier property)(可选)
Cat有一个属性叫做id。这个属性映射数据库表的主
键字段。这个属性可以叫任何名字,其类型可以是任何的原始类型、原始类型的包装类型、
java.lang.String 或者是 java.util.Date。
(如果你的老式数据库表有联合主键,你甚至可以用一个用户自定义的类,该类拥有这些类型
的属性。参见后面的关于联合标识符的章节。)
标识符属性是可选的。可以不用管它,让Hibernate内部来追踪对象的识别。
不推荐使用这个属性。
实际上,一些功能只对那些声明了标识符属性的类起作用:
托管对象的传播性重新(和session)关联(级联更新或级联合并)
——参阅
Session.saveOrUpdate()
Session.merge()
我们建议你对持久化类声明命名一致的标识属性。我们还建议你使用一
个可以为空(也就是说,不是原始类型)的类型。
使用非final的类 (可选)
代理(proxies)是Hibernate的一个重要的功能,它依赖的条件是,持久
化类或者是非final的,或者是实现了一个所有方法都声明为public的接口。
你可以用Hibernate持久化一个没有实现任何接口的final类,但是你
不能使用代理来延迟关联加载,这会限制你进行性能优化的选择。
你也应该避免在非final类中声明 public final的方法。如果你想使用一
个有public final方法的类,你必须通过设置lazy="false"
来明确的禁用代理。
实现继承(Inheritance)
子类也必须遵守第一条和第二条规则。它从超类Cat继承了标识属性。
实现equals()和hashCode()
如果你有如下需求,你必须重载
equals() 和 hashCode()方法:
想把持久类的实例放入Set中(当表示多值关联时,推荐这么做)
想重用脱管实例
Hibernate保证,持久化标识(数据库的行)和仅在特定会话范围内的Java标识是等值的。因此,一旦
我们混合了从不同会话中获取的实例,如果我们希望Set有明确的语义,我们必
须实现equals() 和hashCode()。
实现equals()/hashCode()最显而易见的方法是比较两个对象
标识符的值。如果值相同,则两个对象对应于数据库的同一行,因此它们是相等的(如果都被添加到
Set,则在Set中只有一个元素)。不幸的是,对生成的标识不能
使用这种方法。Hibernate仅对那些持久化对象赋标识值,一个新创建的实例将不会有任何标识值。此外,
如果一个实例没有被保存(unsaved),并且在一个Set中,保存它将会给这个对象
赋一个标识值。如果equals() 和 hashCode()是基于标识值
实现的,则其哈希码将会改变,违反Set的契约。建议去Hibernate的站点看关于这个
问题的全部讨论。注意,这不是一个Hibernate问题,而是一般的Java对象标识和相等的语义问题。
我们建议使用业务键值相等(Business key equality)来实现equals()
和 hashCode()。业务键值相等的意思是,equals()方法
仅仅比较来自业务键的属性,一个业务键将标识在真实世界里(一个天生的候选键)
的实例。
注意,业务键不必是象数据库的主键那样是固定不变的(参见)。
对业务键而言,不可变或唯一的属性是好的候选。
动态模型(Dynamic models)
注意,以下特性在当前是基于实验考虑的,可能会在将来改变。
运行期的持久化实体没有必要象POJO类或JavaBean对象一样表示。Hibernate也支持动态模型
(在运行期使用Map的Map)和象DOM4J的树模型那
样的实体表示。使用这种方法,你不用写持久化类,只写映射文件就行了。
Hibernate默认工作在普通POJO模式。你可以使用配置选项default_entity_mode,
对特定的SessionFactory,设置一个默认的实体表示模式。
(参见。)
下面是用Map来表示的例子。首先,在映射文件中,要声明
entity-name来代替(或外加)一个类名。
]]>
注意,虽然是用目标类名来声明关联的,但是关联的目标类型除了是POJO之外,也可以
是一个动态的实体。
在使用dynamic-map为SessionFactory
设置了默认的实体模式之后,可以在运行期使用Map的
Map。
动态映射的好处是,使原型在不需要实体类实现的情况下,快速转变时间。然而,你无法进行
编译期的类型检查,并可能由此会处理很多的运行期异常。幸亏有了Hibernate映射,它使得数
据库的schema能容易的规格化和合理化,并允许稍后添加正确的领域模型的最新实现。
实体表示模式也能在每个Session的基础上设置:
请注意,用EntityMode调用getSession()是在
Session的API中,而不是SessionFactory。
这样,新的Session共享底层的JDBC连接,事务,和其他的上下文信
息。这意味着,你不需要在第二个Session中调用
flush()和close(),同样的,把事务和连接的处理
交给原来的工作单元。
关于XML表示能力的更多信息可以在中找到。
TODO:在property和proxy的包里,用户扩展文件框架。