摘自：http://article.pchome.net/content-330924.html

       在過去幾年里，Hibernate不斷發展，幾乎成為Java數據庫持久性的事實標準。它非常強大、靈活，而且具備了優異的性能。在本文中，我們將了解如何使用Java 5 注釋來簡化Hibernate代碼，并使持久層的編碼過程變得更為輕松。

　　傳統上，Hibernate的配置依賴于外部 XML 文件：數據庫映射被定義為一組 XML 映射文件，并且在啟動時進行加載。創建這些映射有很多方法，可以從已有數據庫模式或Java類模型中自動創建，也可以手工創建。無論如何，您最終將獲得大量的 Hibernate 映射文件。此外，還可以使用工具，通過javadoc樣式的注釋生成映射文件，盡管這樣會給您的構建過程增加一個步驟。

　　在最近發布的幾個Hibernate版本中，出現了一種基于 Java 5 注釋的更為巧妙的新方法。借助新的 Hibernate Annotation 庫，即可一次性地分配所有舊映射文件——一切都會按照您的想法來定義——注釋直接嵌入到您的 Java 類中，并提供一種強大及靈活的方法來聲明持久性映射。籍由自動代碼完成和語法突出顯示功能，最近發布的Java IDE也為其提供了有力的支持。

　　Hibernate Annotation還支持新的 EJB 3 持久性規范。這些規范旨在提供一種標準化的 Java 持久性機制。由于 Hibernate 3 還提供了一些擴展，因此您可以十分輕松地遵從這些標準，并使用 EJB 3 編程模型來對 Hibernate 持久層進行編碼。

　　現在，讓我們來動手使用Hibernate Annotation。

安裝 Hibernate Annotation

　　要使用 Hibernate Annotation，您至少需要具備 Hibernate 3.2和Java 5。可以從 Hibernate 站點 下載 Hibernate 3.2 和 Hibernate Annotation庫。除了標準的 Hibernate JAR 和依賴項之外，您還需要 Hibernate Annotations .jar 文件（hibernate-annotations.jar）、Java 持久性 API （lib/ejb3-persistence.jar）。如果您正在使用 Maven，只需要向 POM 文件添加相應的依賴項即可，如下所示：

 ...

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 類來建立會話工廠：

sessionFactory = new

AnnotationConfiguration().buildSessionFactory();

　　盡管通常使用 元素來聲明持久性類，您還是需要在 Hibernate 配置文件（通常是 hibernate.cfg.xml）中聲明持久性類：

　　近期的許多 Java 項目都使用了輕量級的應用框架，例如 Spring。如果您正在使用 Spring 框架，可以使用 AnnotationSessionFactoryBean 類輕松建立一個基于注釋的 Hibernate 會話工廠，如下所示：

org.hibernate.dialect.DerbyDialect
create
...




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

第一個持久性類

　　既然已經知道了如何獲得注釋所支持的 Hibernate 會話，下面讓我們來了解一下帶注釋的持久性類的情況：

　　像在其他任何 Hibernate應用程序中一樣，帶注釋的持久性類也是普通 POJO。差不多可以說是。您需要向 Java 持久性 API （javax.persistence.*）添加依賴項，如果您正在使用任何特定于 Hibernate的擴展，那很可能就是 Hibernate Annotation 程序包（org.hibernate.annotations.*），但除此之外，它們只是具備了持久性注釋的普通 POJO 。下面是一個簡單的例子：

@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;
}
}

　　正像我們所提到的，這非常簡單。@Entity 注釋聲明該類為持久類。@Id 注釋可以表明哪種屬性是該類中的獨特標識符。事實上，您既可以保持字段（注釋成員變量），也可以保持屬性（注釋getter方法）的持久性。后文中將使用基于屬性的注釋。基于注釋的持久性的優點之一在于大量使用了默認值（最大的優點就是 “慣例優先原則（convention over configuration）”）。例如，您無需說明每個屬性的持久性——任何屬性都被假定為持久的，除非您使用 @Transient 注釋來說明其他情況。這簡化了代碼，相對使用老的 XML 映射文件而言也大幅地減少了輸入工作量。

生成主鍵

　　Hibernate 能夠出色地自動生成主鍵。Hibernate/EBJ 3 注釋也可以為主鍵的自動生成提供豐富的支持，允許實現各種策略。下面的示例說明了一種常用的方法，其中 Hibernate 將會根據底層數據庫來確定一種恰當的鍵生成策略：

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

定制表和字段映射

　　默認情況下，Hibernate 會將持久類以匹配的名稱映射到表和字段中。例如，前一個類可以與映射到以如下代碼創建的表中：

CREATE TABLE MODELPLANE
(
ID long,
NAME varchar
)

　　如果您是自己生成并維護數據庫，那么這種方法很有效，通過省略代碼可以大大簡化代碼維護。然而，這并不能滿足所有人的需求。有些應用程序需要訪問外部數據庫，而另一些可能需要遵從公司的數據庫命名慣例。如果有必要，您可以使用 @Table 和 @Column 注釋來定制您自己的持久性映射，如下所示：

@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;
}
}

　　該內容將映射到下表中：

CREATE TABLE T_MODEL_PLANE
(
PLANE_ID long,
PLANE_NAME varchar
)

　　也可以使用其他圖和列的屬性來定制映射。這使您可以指定諸如列長度、非空約束等詳細內容。Hibernate支持大量針對這些注釋的屬性。下例中就包含了幾種屬性：

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

映射關系

　　Java 持久性映射過程中最重要和最復雜的一環就是確定如何映射表間的關系。像其他產品一樣， Hibernate 在該領域中提供了高度的靈活性，但卻是以復雜度的增加為代價。我們將通過研究幾個常見案例來了解如何使用注釋來處理這一問題。

　　其中一種最常用的關系就是多對一的關系。假定在以上示例中每個 ModelPlane 通過多對一的關系（也就是說，每個飛機模型只與一種飛機類型建立聯系，盡管指定的飛機類型可以與七種飛機模型建立聯系）來與 PlaneType 建立聯系。可如下進行映射：

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

　　CascadeType 值表明 Hibernate 應如何處理級聯操作。

　　另一種常用的關系與上述關系相反：一對多再對一關系，也稱為集合。在老式的 Hibernate 版本中進行映射或使用注釋時，集合令人頭疼，這里我們將簡要加以探討，以使您了解如何處理集合，例如，在以上示例中每個 PlaneType 對象都可能會包含一個 ModelPlanes 集合。可映射如下：

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

命名查詢

　　Hibernate 最優秀的功能之一就在于它能夠在您的映射文件中聲明命名查詢。隨后即可通過代碼中的名稱調用此類查詢，這使您可以專注于查詢，而避免了 SQL 或者 HQL 代碼分散于整個應用程序中的情況。

　　也可以使用注釋來實現命名查詢，可以使用 @NamedQueries 和 @NamedQuery 注釋，如下所示：

@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"
)
}
)

　　一旦完成了定義，您就可以像調用其他任何其他命名查詢一樣來調用它們。

結束語

　　Hibernate 3 注釋提供了強大而精致的 API，簡化了 Java 數據庫中的持久性代碼，本文中只進行了簡單的討論。您可以選擇遵從標準并使用 Java 持久性 API，也可以利用特定于 Hibernate的擴展，這些功能以損失可移植性為代價提供了更為強大的功能和更高的靈活性。無論如何，通過消除對 XML 映射文件的需求，Hibernate 注釋將簡化應用程序的維護，同時也可以使您對EJB 3 有初步認識。來試試吧！