第 4 章持久化类(Persistent Classes)

在应用程序中，用来实现业务问题实体的（如，在电子商务应用程序中的Customer和Order）类就是持久化类。不能认为所有的持久化类的实例都是持久的状态——一个实例的状态也可能是瞬时的或脱管的。

如果这些持久化类遵循一些简单的规则，Hibernate能够工作得更好，这些规则也被称作简单传统Java对象(POJO:Plain Old Java Object)编程模型。但是这些规则并不是必需的。实际上，Hibernate3对于你的持久化类几乎不做任何设想。你可以用其他的方法来表达领域模型：比如，使用Map实例的树型结构。

4.1. 一个简单的POJO例子

大多数Java程序需要用一个持久化类来表示猫科动物。

package eg;
import java.util.Set;
import java.util.Date;

public class Cat {
    private Long id; // identifier

    private Date birthdate;
    private Color color;
    private char sex;
    private float weight;
    private int litterId;

    private Cat mother;
    private Set kittens = new HashSet();

    private void setId(Long id) {
        this.id=id;
    }
    public Long getId() {
        return id;
    }

    void setBirthdate(Date date) {
        birthdate = date;
    }
    public Date getBirthdate() {
        return birthdate;
    }

    void setWeight(float weight) {
        this.weight = weight;
    }
    public float getWeight() {
        return weight;
    }

    public Color getColor() {
        return color;
    }
    void setColor(Color color) {
        this.color = color;
    }

    void setSex(char sex) {
        this.sex=sex;
    }
    public char getSex() {
        return sex;
    }

    void setLitterId(int id) {
        this.litterId = id;
    }
    public int getLitterId() {
        return litterId;
    }

    void setMother(Cat mother) {
        this.mother = mother;
    }
    public Cat getMother() {
        return mother;
    }
    void setKittens(Set kittens) {
        this.kittens = kittens;
    }
    public Set getKittens() {
        return kittens;
    }
    
    // addKitten not needed by Hibernate
    public void addKitten(Cat kitten) {
    	kitten.setMother(this);
	kitten.setLitterId( kittens.size() ); 
        kittens.add(kitten);
    }
}

这里要遵循四条主要的规则：

4.1.1. 实现一个默认的（即无参数的）构造方法（constructor）

Cat有一个无参数的构造方法。所有的持久化类都必须有一个默认的构造方法（可以不是public的），这样的话Hibernate就可以使用 Constructor.newInstance()来实例化它们。我们强烈建议，在Hibernate中，为了运行期代理的生成，构造方法至少是 包(package)内可见的。

4.1.2. 提供一个标识属性（identifier property）（可选）

Cat有一个属性叫做id。这个属性映射数据库表的主键字段。这个属性可以叫任何名字，其类型可以是任何的原始类型、原始类型的包装类型、 java.lang.String 或者是 java.util.Date。（如果你的遗留数据库表有联合主键，你甚至可以用一个用户自定义的类，该类拥有这些类型的属性。参见后面的关于联合标识符的章节。）

标识符属性是可选的。可以不用管它，让Hibernate内部来追踪对象的识别。但是我们并不推荐这样做。

实际上，一些功能只对那些声明了标识符属性的类起作用：

托管对象的传播性再连接（级联更新或级联合并） ——参阅第 10.11 节 “传播性持久化(transitive persistence)”
Session.saveOrUpdate()
Session.merge()

我们建议你对持久化类声明命名一致的标识属性。我们还建议你使用一个可以为空（也就是说，不是原始类型）的类型。

4.1.3. 使用非final的类 (可选)

代理（proxies）是Hibernate的一个重要的功能，它依赖的条件是，持久化类或者是非final的，或者是实现了一个所有方法都声明为public的接口。

你可以用Hibernate持久化一个没有实现任何接口的final类，但是你不能使用代理来延迟关联加载，这会限制你进行性能优化的选择。

你也应该避免在非final类中声明 public final的方法。如果你想使用一个有public final方法的类，你必须通过设置lazy="false" 来明确地禁用代理。

4.1.4. 为持久化字段声明访问器(accessors)和是否可变的标志(mutators)(可选)

Cat为它的所有持久化字段声明了访问方法。很多其他ORM工具直接对实例变量进行持久化。我们相信，在关系数据库schema和类的内部数据结构之间引入间接层(原文为"非直接"，indirection)会好一些。默认情况下Hibernate持久化JavaBeans风格的属性，认可 getFoo，isFoo 和 setFoo这种形式的方法名。如果需要，你可以对某些特定属性实行直接字段访问。

属性不需要要声明为public的。Hibernate可以持久化一个有 default、protected或private的get/set方法对的属性进行持久化。

TODO：property和proxy包里的用户扩展框架文档。