（九）Hibernate之有關Hibernate升級後註解方式的對象關係映射

我要說的升級指的是我實際中遇到的，由於我之前的項目中Hibernate是3.3.2版本的，那時關於Annotation註解方式的對象關係映射得依賴這麼幾個包：

 

  hibernate-annotations.jar,

  ejb3-persistence.jar

  hibernate-commons-annotations.jar

所以之前的項目如果更換爲3.5.3版本後(當前最新發布的最終版本是3.6.0),那麼這三個依賴包都會沒有了，取而代之的是

\hibernate-distribution-3.6.0.Final\lib\jpa\hibernate-jpa-2.0-api-1.0.0.Final.jar

也就是說這個hibernate-jpa-2.0-api-1.0.0.Final.jar能夠代替上面的三個包的作用

先回顧下一個簡單的註解方式的例子

 

User.java

 

<span style="font-size: large;">package com.javacrazyer.test;

import javax.persistence.Column;
import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;
import javax.persistence.Table;

@Entity
@Table(name = "user")
// 非必要，在表格名稱與類別名稱不同時使用
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.AUTO)
    private Integer id;

    @Column(name = "name")
    // 非必要，在字段名稱與屬性名稱不同時使用
    private String name;

    @Column(name = "age")
    private Integer age; // 非必要，在字段名稱與屬性名稱不同時使用

    // 必須要有一個預設的建構方法
    // 以使得Hibernate可以使用Constructor.newInstance()建立對象
    public User() {
    }

    public Integer getId() {
        return id;
    }

    public void setId(Integer id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public Integer getAge() {
        return age;
    }

    public void setAge(Integer age) {
        this.age = age;
    }
}
</span>

Category.java

<span style="font-size: large;">package com.javacrazyer.test;

import java.io.Serializable;
import java.util.ArrayList;
import java.util.List;

import javax.persistence.CascadeType;
import javax.persistence.Entity;
import javax.persistence.FetchType;
import javax.persistence.GeneratedValue;
import javax.persistence.Id;
import javax.persistence.JoinColumn;
import javax.persistence.ManyToOne;
import javax.persistence.OneToMany;
import javax.persistence.Table;
import javax.persistence.Version;



/**
 * 產品類別
 *
 */
@Entity
@Table(name="category")
public class Category implements Serializable{
    private static final long serialVersionUID = -3942148673242309324L;
    @Id
    @GeneratedValue
    private Integer id;
    @Version
    private Integer version;
    private String name;
    private String description;
    private String path;  //分類路徑

    //Category 自身雙向多對一
    @ManyToOne(cascade={CascadeType.MERGE,CascadeType.PERSIST})
    private Category parent;

    //Category 自身雙向一對多
    @OneToMany(mappedBy="parent",fetch=FetchType.EAGER,cascade=CascadeType.ALL)
    @JoinColumn(name="parent_id")
    private List<Category> child = new ArrayList<Category>();


    public Integer getId() {
        return id;
    }
    public void setId(Integer id) {
        this.id = id;
    }
    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
    public String getDescription() {
        return description;
    }
    public void setDescription(String description) {
        this.description = description;
    }
    public Category getParent() {
        return parent;
    }
    public void setParent(Category parent) {
        this.parent = parent;
    }
    public List<Category> getChild() {
        return child;
    }
    public void setChild(List<Category> child) {
        this.child = child;
    }
    public Integer getVersion() {
        return version;
    }

    @SuppressWarnings("unused")
    private void setVersion(Integer version) {
        this.version = version;
    }
    public String getPath() {
        return path;
    }
    public void setPath(String path) {
        this.path = path;
    }
}</span>

 hibernate.cfg.xml

<span style="font-size: large;"><?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE hibernate-configuration PUBLIC
    "-//Hibernate/Hibernate Configuration DTD 3.0//EN"
    "http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd">

<hibernate-configuration>
<session-factory>
       <!-- 顯示實際操作數據庫時的SQL -->
        <property name="show_sql">true</property>
        <!-- SQL方言，這邊設定的是MySQL -->
        <property name="dialect">org.hibernate.dialect.MySQLDialect</property>
        <!-- JDBC驅動程序 -->
        <property name="connection.driver_class">com.mysql.jdbc.Driver</property>
        <!-- JDBC URL -->
        <property name="connection.url">jdbc:mysql:///test</property>
        <!-- 數據庫使用者 -->
        <property name="connection.username">root</property>
        <!-- 數據庫密碼 -->
        <property name="connection.password">root</property>
        <property name="default_batch_fetch_size">10</property>
        <property name="hibernate.current_session_context_class">thread</property>
        <property name="show_sql">true</property>
        <property name="format_sql">true</property>
        <property name="hbm2ddl.auto">update</property>
        <!-- 以下設置對象與數據庫表格映像類別 -->
        <mapping class="com.javacrazyer.test.User"/>
        <mapping class="com.javacrazyer.test.Category"/>
</session-factory>
</hibernate-configuration></span>

Hibernate工具類

<span style="font-size: large;">package com.javacrazyer.common;

import org.hibernate.Session;
import org.hibernate.SessionFactory;
import org.hibernate.cfg.AnnotationConfiguration;

/**
 * Hibernate工具類
 *
 */
public class HibernateUtil {
    private static final SessionFactory factory;

    private HibernateUtil(){}

    static{
        //加載Hibernate全局配置文件,根據配置信息創建SessionFactory工廠實例
        factory = new AnnotationConfiguration().configure().buildSessionFactory();
    }

    public static SessionFactory getSessionFactory(){
        return factory;
    }

    /**
     * 本方法用來獲取當前線程上綁定的Session實例
     * 注意hibernate全局配置文件中，如果使用是JDBC事務，添加如下配置：<br/>
     * <property name="hibernate.current_session_context_class">thread</property>
     * @return
     */
    public static Session getSession(){
        return factory.getCurrentSession();
    }
}
</span>

 

測試類

<span style="font-size: large;">package com.javacrazyer.test;

import java.util.ArrayList;
import java.util.List;

import org.hibernate.Session;
import org.hibernate.SessionFactory;
import org.hibernate.Transaction;
import org.junit.BeforeClass;
import org.junit.Test;

import com.javacrazyer.common.HibernateUtil;


public class MyTest {
    private static SessionFactory sf;

    @BeforeClass
    public static void init() {
        sf = HibernateUtil.getSessionFactory();
    }

    @Test
    public void useradd() {
        User user = new User();
        user.setName("caterpillar");
        user.setAge(new Integer(30));

        // 開啓Session，相當於開啓JDBC的Connection
        Session session = sf.getCurrentSession();
        // Transaction表示一組會話操作
        Transaction tx = session.beginTransaction();
        // 將對象映像至數據庫表格中儲存
        session.save(user);
        tx.commit();

        System.out.println("新增資料OK!請先用MySQL觀看結果！");
    }

    @Test
    public void categoryadd(){
        Category category=new Category();
        category.setName("類別1");

        Category category1=new Category();
        category1.setName("類別1-01");
        category1.setParent(category);

        Category category2=new Category();
        category2.setName("類別1-02");
        category2.setParent(category);

        List<Category> childs=new ArrayList<Category>();
        childs.add(category1);
        childs.add(category2);
        category.setChild(childs);
        Session session = sf.getCurrentSession();
        // Transaction表示一組會話操作
        Transaction tx = session.beginTransaction();
        session.persist(category);
        tx.commit();
    }



}
</span>

 

對於User的持久化操作相當順利，這個升級過程是成功的。

但是對於Category的升級就沒那麼容易了，如果不細心發現的話，總是報

Associations marked as mappedBy must not define database mappings like @JoinTable or @JoinColumn

或者是Unrooted Test之類的錯誤

錯誤發生在下面這些代碼中

@OneToMany(mappedBy="parent",fetch=FetchType.EAGER,cascade=CascadeType.ALL)

@JoinColumn(name="parent_id")

private List<Category> child = new ArrayList<Category>();

後來發現在3.5.3版本中@JoinColumn與mappingBy是互斥的，之前在hibernate.3.3.2中都是正確無誤的,也就是hibernate.3.3.2允許這兩個互相存在。所以呢，如果升級到hibernate3.5.3想測試成功的話，mappBy="parent",就應該去掉，正確的配置應該是這樣

@OneToMany(fetch=FetchType.EAGER,cascade=CascadeType.ALL)

@JoinColumn(name="parent_id")

private List<Category> child = new ArrayList<Category>();

索性將mappingBy再溫習下

a) 只有OneToOne,OneToMany,ManyToMany上纔有mappedBy屬性，ManyToOne不存在該屬性；

b) mappedBy標籤一定是定義在the owned side(被擁有方的)，他指向the owning side(擁有方)；

c) mappedBy的含義，應該理解爲，擁有方能夠自動維護 跟被擁有方的關係；

   當然，如果從被擁有方，通過手工強行來維護擁有方的關係也是可以做到的。

d) mappedBy跟JoinColumn/JoinTable總是處於互斥的一方，可以理解爲正是由於擁有方的關聯被擁有方的字段存在，擁有方纔擁有了被 擁有方。mappedBy這方定義的JoinColumn/JoinTable總是失效的，不會建立對應的字段或者表