hk2000c — Sat, 01 Dec 2007 17:13:00 GMT

　　在过��d��q�里�Q�Hibernate不断发展�Q�几乎成为Java数据库持久性的事实标准。它非常强大、灵�z�，而且具备了优异的性能。在本文中，我们��了解如何��用Java 5 注释来简化Hibernate代码�Q��ƈ使持久层的编码过�E�变得更��松�?/p>

　　传统上，Hibernate的配�|�依赖于外部 XML 文�g�Q�数据库映射被定义�ؓ一�l?XML 映射文�g�Q��ƈ且在启动时进行加载。创��些映��有很多�Ҏ��Q�可以从已有数据库模式或Java�c�L��型中自动创徏�Q�也可以手工创徏。无论如何，您最�l�将获得大量�?Hibernate 映射文�g。此外，�q�可以��用工��P��通过javadoc样式的注释生成映��文�Ӟ��管�q�样会给您的构徏�q�程增加一个步骤�?/p>

　　在最�q�发布的几个Hibernate版本中，出现了一�U�基�?Java 5 注释的更为��y妙的新方法。借助新的 Hibernate Annotation 库，卛_��一�ơ性地分配所有旧映射文�g——一切都会按照您的想法来定义——注释直接嵌入到您的 Java �c�M��Q��ƈ提供一�U�强大及灉|��的方法来声明持久性映��。籍��p��动代码完成和语法�H�出昄��功能�Q�最�q�发布的Java IDE也�ؓ其提供了有力的支持�?/p>

　　Hibernate Annotation�q�支持新�?EJB 3 持久性规范。这些规范旨在提供一�U�标准化�?Java 持久性机制。由�?Hibernate 3 �q�提供了一些扩展，因此您可以十分轻村֜�遵从�q�些标准�Q��ƈ使用 EJB 3 �~�程模型来对 Hibernate 持久层进行编码�?/p>

　　现在�Q�让我们来动手��用Hibernate Annotation�?/p>

安装 Hibernate Annotation

　　要��?Hibernate Annotation�Q�您臛_��需要具�?Hibernate 3.2和Java 5。可以从 Hibernate 站点下蝲 Hibernate 3.2 �?Hibernate Annotation库。除了标准的 Hibernate JAR 和依赖项之外�Q�您�q�需�?Hibernate Annotations .jar 文�g�Q?em>hibernate-annotations.jar�Q�、Java 持久�?API �Q?em>lib/ejb3-persistence.jar�Q�。如果您正在使用 Maven�Q�只需要向 POM 文�g��d��相应的依赖项卛_��Q�如下所�C�：

    ...

org.hibernate
hibernate
3.2.1.ga


org.hibernate
hibernate-annotations
3.2.0.ga


javax.persistence
persistence-api
1.0

...

　　下一步就是获�?Hibernate 会话工厂。尽��无需惊天的修改，但这一工作与��?Hibernate Annotations有所不同。您需要��?AnnotationConfiguration �c�L��建立会话工厂�Q?/p>

sessionFactory = new

AnnotationConfiguration().buildSessionFactory();

　　��管通常使用元素来声明持久性类�Q�您�q�是需要在 Hibernate 配置文�g�Q�通常�?hibernate.cfg.xml�Q�中声明持久性类�Q?/p>

　　�q�期的许�?Java ��目都��用了轻量�U�的应用框架�Q�例�?Spring。如果您正在使用 Spring 框架�Q�可以��?AnnotationSessionFactoryBean �c�轻村־�立一个基于注释的 Hibernate 会话工厂�Q�如下所�C�：








org.hibernate.dialect.DerbyDialect
create
...




com.onjava.modelplanes.domain.PlaneType
com.onjava.modelplanes.domain.ModelPlane
...

�W�一个持久性类

　　既然已经知道了如何获得注释所支持�?Hibernate 会话�Q�下面让我们来了解一下带注释的持久性类的情况：

　　像在其他��M�� Hibernate应用�E�序中一��P��带注释的持久性类也是普�?POJO。差不多可以说是。您需要向 Java 持久�?API �Q?em>javax.persistence.*�Q�添加依赖项�Q�如果您正在使用��M��特定�?Hibernate的扩展，那很可能��是 Hibernate Annotation �E�序包（org.hibernate.annotations.*�Q�，但除此之外，它们只是具备了持久性注释的普�?POJO 。下面是一个简单的例子�Q?/p>

@Entity
public class ModelPlane {
private Long id;
private String name;
@Id
public Long getId() {
return id;
}
public void setId(Long id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
}

　　正像我们所提到的，�q�非常简单。@Entity 注释声明该类为持久类。@Id 注释可以表明哪种属性是该类中的独特标识�W�。事实上�Q�您既可以保持字�D�（注释成员变量�Q�，也可以保持属性（注释getter�Ҏ��Q�的持久性。后文中��用基于属性的注释。基于注释的持久性的优点之一在于大量使用了默认��|��最大的优点��是 “惯例优先原则�Q�convention over configuration�Q?#8221;�Q�。例如，您无需说明每个属性的持久性——�Q何属性都被假定�ؓ持久的，除非您��?@Transient 注释来说明其他情��c��这��化了代码�Q�相对��用老的 XML 映射文�g而言也大�q�地减少了输入工作量�?/p>

生成主键

　　Hibernate 能够��地自动生成主键。Hibernate/EBJ 3 注释也可以�ؓ主键的自动生成提供丰富的支持�Q�允许实现各�U�策略。下面的�C�Z��说明了一�U�常用的�Ҏ��Q�其�?Hibernate ��会�Ҏ��底层数据库来��定一�U�恰当的键生成策略：

@Id
@GeneratedValue(strategy=GenerationType.AUTO)
public Long getId() {
return id;
}

定制表和字段映射

　　默认情况下，Hibernate 会将持久�c�M��匚w��的名�U�映��到表和字段中。例如，前一个类可以与映��到以如下代码创建的表中�Q?/p>

CREATE TABLE MODELPLANE
(
ID long,
NAME varchar
)

　　如果您是自己生成�q�维护数据库�Q�那么这�U�方法很有效�Q�通过省略代码可以大大��化代码维护。然而，�q��ƈ不能满��所有�h的需求。有些应用程序需要访问外部数据库�Q�而另一些可能需要遵从公司的数据库命名惯例。如果有必要�Q�您可以使用 @Table �?@Column 注释来定制您自己的持久性映��，如下所�C�：

@Entity
@Table(name="T_MODEL_PLANE")
public class ModelPlane {
private Long id;
private String name;
@Id
@Column(name="PLANE_ID")
public Long getId() {
return id;
}
public void setId(Long id) {
this.id = id;
}
@Column(name="PLANE_NAME")
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
}

　　该内容将映射��C��表中�Q?/p>

CREATE TABLE T_MODEL_PLANE
(
PLANE_ID long,
PLANE_NAME varchar
)

　　也可以��用其他图和列的属性来定制映射。这使您可以指定诸如列长度、非�I�约束等详细内容。Hibernate支持大量针对�q�些注释的属性。下例中��包含了几种属性：

    ...
@Column(name="PLANE_ID", length=80, nullable=true)
public String getName() {
return name;
}
...

映射关系

　　Java 持久性映��过�E�中最重要和最复杂的一环就是确定如何映��表间的关系。像其他产品一��P�� Hibernate 在该领域中提供了高度的灵�z�L��，但却是以复杂度的增加��Z��仗��我们将通过研究几个常见案例来了解如何��用注释来处理�q�一问题�?/p>

　　其中一�U�最常用的关�p�d��是多对一的关�p�R��假定在以上�C�Z��中每�?ModelPlane 通过多对一的关�p�（也就是说�Q�每个飞机模型只与一�U�飞机类型徏立联�p�，��管指定的飞机类型可以与七种飞机模型建立联系�Q�来�?PlaneType 建立联系。可如下�q�行映射�Q?/p>

    @ManyToOne( cascade = {CascadeType.PERSIST, CascadeType.MERGE} )
public PlaneType getPlaneType() {
return planeType;
}

　　CascadeType ��D��?Hibernate 应如何处理��联操作�?/p>

　　另一�U�常用的关系与上�q�关�pȝ��反：一对多再对一关系�Q�也�U�Cؓ集合。在老式�?Hibernate 版本中进行映��或使用注释�Ӟ��集合令�h头疼�Q�这里我们将��要加以探讨，以��您了解如何处理集合，例如�Q�在以上�C�Z��中每�?PlaneType 对象都可能会包含一�?ModelPlanes 集合。可映射如下�Q?/p>

 @OneToMany(mappedBy="planeType",
cascade=CascadeType.ALL,
fetch=FetchType.EAGER)
@OrderBy("name")
public List getModelPlanes() {
return modelPlanes;
}

命名查询

　　Hibernate 最优秀的功能之一��在于它能够在您的映��文件中声明命名查询。随后即可通过代码中的名称调用此类查询�Q�这使您可以专注于查询，而避免了 SQL 或�?HQL 代码分散于整个应用程序中的情��c�?/p>

　　也可以��用注释来实现命名查询�Q�可以��?@NamedQueries �?@NamedQuery 注释�Q�如下所�C�：

@NamedQueries(
{
@NamedQuery(
name="planeType.findById",
query="select p from PlaneType p left join fetch p.modelPlanes where id=:id"
),
@NamedQuery(
name="planeType.findAll",
query="select p from PlaneType p"
),
@NamedQuery(
name="planeType.delete",
query="delete from PlaneType where id=:id"
)
}
)

　　一旦完成了定义�Q�您��可以像调用其他��M��其他命名查询一��h��调用它们�?/p>