這些年來(lái),Hibernate幾乎已經(jīng)成為java世界中數(shù)據(jù)庫(kù)持久化方面事實(shí)上的標(biāo)準(zhǔn),它強(qiáng)大靈活并且性能優(yōu)秀.在這篇文章中，我們來(lái)看一下Java 5的注解功能怎么簡(jiǎn)單地用在你的hibernate代碼中讓你的持久化層變得更容易.

在過(guò)去,Hibernate 依靠外部的XML文件來(lái)配置持久化對(duì)象,數(shù)據(jù)庫(kù)映射文件定義在一組XML映射文件里并且在程序開始的時(shí)候被裝載.有很多辦法來(lái)創(chuàng)建這些映射文件,或者自動(dòng)從一個(gè)已存在的數(shù)據(jù)庫(kù)模式里創(chuàng)建，或者手動(dòng)從java類對(duì)象中創(chuàng)建.不管那種情況,你都得產(chǎn)生一大堆Hibernate 映射文件而結(jié)束工作.,你也可以利用外部工具從javadoc-style 的注解中生成映射文件,但這給你的開發(fā)流程增加了額外的負(fù)擔(dān).

在最近的Hibernate版本里,一個(gè)新的建立在Java 5 注解之上更為優(yōu)雅的方法出現(xiàn)了.利用新的Hibernate Annonations 庫(kù),你可以發(fā)布一次如你以前的映射文件所定義的信息,你猜到了-注解直接嵌入你的Java類文件里.注解帶來(lái)了一種強(qiáng)大靈活地聲明持久化映射的辦法.在最新版的幾個(gè)Java集成開發(fā)環(huán)境里都很好的支持,并帶有代碼自動(dòng)完成和語(yǔ)法高亮功能.

Hibernate annotations 也支持最新的EJB 3持久化規(guī)范,這些規(guī)范目的是提供一個(gè)標(biāo)準(zhǔn)的Java持久化機(jī)制.當(dāng)然Hibernate 3也提供了更多的解決方案,你能非常容易的靠近保準(zhǔn)并且利用EJB 3編程模型編寫你的Hibernate持久化層.

現(xiàn)在讓我們一步步了解Hibernate Annotations.


版權(quán)聲明：任何獲得Matrix授權(quán)的網(wǎng)站，轉(zhuǎn)載時(shí)請(qǐng)務(wù)必保留以下作者信息和鏈接
作者:kjj
原文:http://www./resource/article/2007-04-09/Hibernate+Annotations_62c034f4-e62a-11db-b1bd-fb5572962927.html
關(guān)鍵字:Hibernate Annotations

安裝 Hibernate Annotations

為了使用Hibernate Annotations,你需要最新的Hibernate 3.2 ,當(dāng)然還有Java 5 你可以在Hibernate web site 這個(gè)網(wǎng)站下載Hibernate 3.2和Hibernate Annotations庫(kù).除了標(biāo)準(zhǔn)的Hibernate 庫(kù)文件和必須的依賴庫(kù)之外,還需要下載 Hibernate Annotations庫(kù)和Java 持久化API ---ejb3-persstence.jar文件.如果你正在使用Maven，僅僅添加相應(yīng)的依賴到你的DOM文件里，如下所示:

 ...
    <dependency>
      <groupId>org.hibernate</groupId>
      <artifactId>hibernate</artifactId>
      <version>3.2.1.ga</version>
    </dependency>
    <dependency>
      <groupId>org.hibernate</groupId>
      <artifactId>hibernate-annotations</artifactId>
      <version>3.2.0.ga</version>
    </dependency>
    <dependency>
      <groupId>javax.persistence</groupId>
      <artifactId>persistence-api</artifactId>
      <version>1.0</version>
    </dependency>
...

下一步是獲得一個(gè)Hibernate Session 工廠.利用Hibernate Annotations與不使用它創(chuàng)建Hibernate session工廠有一點(diǎn)不同,雖然不需要大幅度修改.你只需須簡(jiǎn)單地使用AnnotationConfiguration類安裝你的session工廠：
    

sessionFactory
=new AnnotationConfiguration().buildSessionFactory();

一般的,你需要通過(guò)<mapping>元素在Hibernate配置文件里(hibernate.cfg.xml)聲明持久化類
  

        <hibernate-configuration>
          <session-factory>
            <mapping class="com.onjava.modelplanes.domain.PlaneType"/>
            <mapping class="com.onjava.modelplanes.domain.ModelPlane"/>
          </session-factory>
  </hibernate-configuration>

如今許多java 工程都使用輕量級(jí)的程序框架例如Spring.如果你正在用Spring框架,你可以容易地利用AnnotationSessionFactory類裝配一個(gè)基于Annotations 的Hibernate Session Factory,如下:

<!-- Hibernate session factory -->
  <bean id="sessionFactory" 
        class="org.springframework.orm.hibernate3.annotation.AnnotationSessionFactoryBean">
   <property name="dataSource">
     <ref bean="dataSource"/>
   </property>
   <property name="hibernateProperties">
     <props>
       <prop key="hibernate.dialect">org.hibernate.dialect.DerbyDialect</prop>
       <prop key="hibernate.hbm2ddl.auto">create</prop>
       ...
     </props>
   </property>
   <property name="annotatedClasses">
     <list>
       <value>com.onjava.modelplanes.domain.PlaneType</value>
       <value>com.onjava.modelplanes.domain.ModelPlane</value>
       ...
     </list>
   </property>
 </bean>

我們第一個(gè)持久化類

現(xiàn)在我們知道如何獲得基于Annotation的Hibernate Session ,讓我們看看這個(gè)注解的持久化類看起來(lái)像什么樣子.
被注解的持久化類是一般的POJO類,就像在其他Hibernate程序里的一樣.好的,差不多了.你需要依賴于Java 持久化API (javax.persistence.*),并且還需要導(dǎo)入注解包類(org.hibernate.annotations.*)如果你使用了任何Hibernate擴(kuò)展的話.但是除此之外,他們僅僅是擁有持久化相關(guān)注解的POJO.這有個(gè)例子:

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

如我們所言,非常簡(jiǎn)單.@Entity注解聲明類將被持久化.@Id注解讓你指示持久化類的唯一性標(biāo)識(shí)屬性.實(shí)際上,你可以持久化字段(注解成員變量)或者持久化屬性(通過(guò)注釋getter方法.在這篇文章的剩余部分,我們將用基于屬性的注解.關(guān)于基于注解的持久化一個(gè)好處是他的缺省行為.例如.你不需要聲明每一個(gè)屬性是否要被持久化-任何屬性都假定將被持久化除非用@Transient注解了他. 對(duì)代碼來(lái)說(shuō)這是簡(jiǎn)單的,并且相對(duì)于舊的XML配置文件來(lái)說(shuō),也節(jié)省了很多打字量.

生成主鍵

Hibernate一個(gè)擅長(zhǎng)的功能是主鍵自動(dòng)生成,Hibernate/EJB 3注解也為主鍵自動(dòng)生成提供了豐富的支持,允許諸多生成策略.下面例子演示了最常見的用途,這里Hibernate 根據(jù)數(shù)據(jù)庫(kù)給出一個(gè)合適的主鍵生成策略.

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

自定義表和字段映射
默認(rèn)情況下,Hibernate將映射持久化類到表,用匹配的字段名映射.例如,上面的類將經(jīng)由下列SQL語(yǔ)句映射到表:

CREATE TABLE MODELPLANE 
(
    ID long,
NAME varchar
)

如果你自己生成和維護(hù)數(shù)據(jù)庫(kù)的話非常好，并且使你的代碼易于維護(hù).然而,他不適合所有需求.有些程序需要訪問外部數(shù)據(jù)庫(kù),并且可能需要公司數(shù)據(jù)庫(kù)命名轉(zhuǎn)換.如果需要的話,你可以使用@Table和@Column注解進(jìn)行你的持久化映射:

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

你可以利用Table和Column屬性自定義映射.它可讓你指定諸如列長(zhǎng)度,not-null約束等等,hibernate支持大量的屬性注解:

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

映射關(guān)系

Java持久化映射中一個(gè)最重要，最復(fù)雜的部分是確定怎么映射表間的關(guān)系.如其他的特性一樣,Hibernate在這方面也提供了大量的靈活性,但是以增加了某種復(fù)雜度為代價(jià)的.我們將瀏覽一系列共同的用例以對(duì)如何使用注解有個(gè)大體認(rèn)識(shí).
最常用的一個(gè)關(guān)系是many-to-one關(guān)系.假定在上面的例子中,每個(gè)ModelPlane經(jīng)由many-to-one關(guān)系被關(guān)聯(lián)到一個(gè)PlaneType (換句話說(shuō)每個(gè)Model plane 被確切的關(guān)聯(lián)到一個(gè) plane type,通過(guò)給定一個(gè)plane type可以被關(guān)聯(lián)到多個(gè) model plane ),你可以映射如下:

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

這個(gè)CascadeType值表示Hibernate將怎么進(jìn)行級(jí)聯(lián)操作
另外一個(gè)常用的關(guān)系是與上面相對(duì)的:one-to-many關(guān)系,也以集合而聞名,集合將映射變得有些復(fù)雜,在舊的和新的注解中,并且我們將撇開表面細(xì)節(jié)直接給你完成的例子以給你一個(gè)大概,例如在上面例子中,每一個(gè)PlaneType對(duì)象可能包含一個(gè)ModelPlane的集合,可以映射如下:

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

命名查詢
Hibernate一個(gè)優(yōu)秀的特征是可以在映射文件申明命名查詢的能力.這些查詢可以通過(guò)名字在代碼里調(diào)用,這可以讓你集中查詢且避免有sql或者Hql代碼分散在程序里.

你也可以通過(guò)注解,利用@NameQueries和@NameQuery注解,如下:

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

一旦定義，可以可以調(diào)用正如其他命名查詢.

總結(jié)

Hibernate 3注解提供了一個(gè)強(qiáng)大而優(yōu)雅的API來(lái)簡(jiǎn)化java數(shù)據(jù)庫(kù)持久化代碼,在這里我們僅僅涉及到表面的知識(shí),你選擇貼近標(biāo)準(zhǔn),并且利用java持久化API或者收益于Hibernate的規(guī)范擴(kuò)展, 在以失去某種輕便性為代價(jià)的基礎(chǔ)上,它提供了更為強(qiáng)大靈活的功能.不管怎么