Hibernate專案配置

作為一個優秀的持久層框架Hibernate很容易入門。在使用Hibernate框架前，先來看看Hibernate是如何實現ORM框架的，即Hibernate的執行流程，如圖所示：

現在開始新建我們的第一個Hibernate專案

1.在Eclipse中建立Web專案，名稱為HibernateConfigure

2. 將下載下來的Hibernate框架E:\hibernate-release-5.2.9.Final\lib\required中的jar包複製貼上到WEB-INF\lib目錄下

3.把資料庫驅動包複製貼上到WEB-INF\lib

目錄下（比如我的是Oracle資料庫，版本為11g，驅動jar包為ojdbc，MySQL資料庫則用mysql-connector-java）

4.建立實體類。在src目錄下新建com.skt.entity包，並在其中建立實體類UserTest（對應資料庫表user_test，沒有的話自己新建一個表，欄位自己隨便設兩個）。Users類包含一些屬性（對應資料表user_test欄位），以及與之對應的getXXX()和setXXX()方法，還包括無參構造方法。

package com.skt.entity;

public class UserTest {

    private Integer id;
    private
 
 String userName;
    private String pwd;
    private String phone;
    private String email;

    public Integer getId() {
        return id;
    }
    public void setId(Integer id) {
        this.id = id;
    }
    public String getUserName() {
        return userName;
    }
    public void setUserName
 
(String userName) {
        this.userName = userName;
    }
    public String getPwd() {
        return pwd;
    }
    public void setPwd(String pwd) {
        this.pwd = pwd;
    }
    public String getPhone() {
        return phone;
    }
    public void setPhone(String phone) {
        this.phone = phone;
    }
    public String getEmail() {
        return email;
    }
    public void setEmail(String email) {
        this.email = email;
    }
    public UserTest() {

    }

}

5.編寫對映檔案 UserTest.hbm.xml

<?xml version="1.0"?>
<!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">
<!-- Generated 2017-10-14 12:46:14 by Hibernate Tools 3.5.0.Final -->
<hibernate-mapping>
    <class name="com.skt.entity.UserTest" table="USER_TEST">
        <id name="id" type="java.lang.Integer">
            <column name="ID" />
            <generator class="sequence">
                <param name="sequence_name">SEQ_USER_TEST</param>
            </generator>
        </id>
        <property name="userName" type="java.lang.String">
            <column name="NAME" />
        </property>
        <property name="pwd" type="java.lang.String">
            <column name="PASSWORD" />
        </property>
        <property name="phone" type="java.lang.String">
            <column name="PHONE" />
        </property>
        <property name="email" type="java.lang.String">
            <column name="EMAIL" />
        </property>
    </class>
</hibernate-mapping>

6.編寫Hibernate配置檔案hibernate.cfg.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE hibernate-configuration PUBLIC "-//Hibernate/Hibernate Configuration DTD 3.0//EN"
                                         "http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd">
<hibernate-configuration>
 <session-factory>
  <property name="hibernate.connection.driver_class">oracle.jdbc.driver.OracleDriver</property>
  <property name="hibernate.connection.password">123456</property>
  <property name="hibernate.connection.url">jdbc:oracle:thin:@localhost:1521:orcl</property>
  <property name="hibernate.connection.username">MKYDY</property>
  <property name="hibernate.dialect">org.hibernate.dialect.Oracle10gDialect</property>

  <property name="cache.provider_class">org.hibernate.cache.internal.NoCacheProvider</property>

  <!-- 執行過程中將sql語句打印出來,建議在開發階段將其設定為true -->
  <property name="show_sql">true</property>
  <!-- 根據配置檔案更新資料庫欄位
        create:重新建表
        create-drop:刪除表，再建表
        update:更新表
        none:不對錶操作
         -->
  <property name="hbm2ddl.auto">none</property>

  <mapping resource="com/skt/entity/UserTest.hbm.xml"/>
 </session-factory>
</hibernate-configuration>

7. 編寫Hbernate工具類HibernateUtil

package com.skt.util;

import org.hibernate.HibernateException;
import org.hibernate.Session;
import org.hibernate.SessionFactory;
import org.hibernate.cfg.Configuration;

/**
 * Hibernate工具類
 * @author JackerMkydy
 *
 */
public class HibernateUtil {

    private static SessionFactory sessionFactory;  
    // 建立執行緒區域性變數threadLocal，用來儲存Hibernate的Session  
    private static final ThreadLocal<Session> threadLocal=new ThreadLocal<Session>();  
    // 使用靜態程式碼塊初始化Hibernate  
    static  
    {  
        try  
        {  
            // 讀取配置檔案  
            Configuration cfg = new Configuration().configure();  
            // 建立SessionFactory  
            sessionFactory = cfg.buildSessionFactory();  
        }catch(Throwable ex)  
        {  
            throw new ExceptionInInitializerError(ex);  
        }  
    }  
    // 獲得SessionFactory的例項  
    public static SessionFactory getsSessionFactory()  
    {  
        return sessionFactory;  
    }  
    // 獲得ThreadLocal物件管理的Session  
    public static Session getsSession() throws HibernateException  
    {  
        Session session=(Session) threadLocal.get();  
        if(session==null||!session.isOpen())  
        {  
            if(sessionFactory==null)  
            {  
                rebuildSessionFactory();  
            }  
            // 通過SessionFactory物件建立Session物件  
            session=(sessionFactory!=null)?sessionFactory.openSession():null;  
            // 將Session物件儲存到執行緒區域性變數threadLocal中  
            threadLocal.set(session);  
        }  
        return session;  
    }  
    // 關閉Session例項  
    public static void closeSession()  
    {  
        // 從執行緒區域性變數threadLocal中獲取之前存入的Session例項  
        Session session=(Session)threadLocal.get();  
        threadLocal.set(null);  
        if(session!=null)  
        {  
            session.close();  
        }  
    }  
    // 重建SessionFactory  
    public static void rebuildSessionFactory()  
    {  
        Configuration configuration=new Configuration();  
        configuration.configure("/hibernate.cfg.xml");  
        sessionFactory=configuration.buildSessionFactory();  
    }  
    // 關閉快取和連線池  
    public static void shutdown()  
    {  
        getsSessionFactory().close();  
    } 
}

或者

package com.hb.util;

import org.hibernate.HibernateException;
import org.hibernate.Session;
import org.hibernate.SessionFactory;
import org.hibernate.cfg.Configuration;

/**
 * HibernateUtil 封裝session相關內容
 * @author oracle
 */
public class HibernateUtil
{
    // sessionFactory
    private static SessionFactory sessionFactory;

    /**
     * 獲取SessionFactory
     * @return SessionFactory
     */
    public static SessionFactory getSessionFactory()
    {
        try
        {
            // sessionFactory為空時，就重新建立
            if (sessionFactory == null)
            {
                Configuration configuration = new Configuration();
                sessionFactory = configuration.configure().buildSessionFactory();
            }
        }
        catch (Throwable ex)
        {
            ex.printStackTrace();
        }
        return sessionFactory;
    }

    // 定義session
    @SuppressWarnings("rawtypes")
    public static final ThreadLocal session = new ThreadLocal();

    /**
     * 獲取當前session
     * @return session
     */
    @SuppressWarnings("unchecked")
    public static Session currentSession()
    {
        Session s = (Session) session.get();
        if (s == null)
        {
            s = getSessionFactory().openSession();
            session.set(s);
        }
        return s;
    }

    /**
     * 關閉session
     * @throws HibernateException 異常
     */
    @SuppressWarnings("unchecked")
    public static void closeSession() throws HibernateException
    {
        Session s = (Session) session.get();
        session.set(null);
        if (s != null)
        {
            s.close();
        }
    }

}

8.編寫測試類TestUser

package com.skt.test;

import org.hibernate.Session;
import org.hibernate.Transaction;

import com.skt.entity.UserTest;
import com.skt.util.HibernateUtil;

/**
 * 測試類,增,刪,改,查
 * @author oracleOAEC11
 *
 */
public class TestUser {

    /**
     * 新增使用者
     */
    public void addUser() {
        //建立實體類(瞬態物件)
        UserTest ut = new UserTest();
        ut.setEmail("[email protected]");
        ut.setPhone("1987445345");
        ut.setPwd("111111");
        ut.setUserName("Tom");
        //獲得Session物件
        Session session = HibernateUtil.getsSession();
        //獲得Transaction例項 
        Transaction tc = session.beginTransaction();
        try {
            // 使用Session的save方法將持久化物件儲存到資料庫  
            session.save(ut);
            // 提交事務  
            tc.commit();
        } catch (Exception e) {
            e.printStackTrace();
            // 出現異常，回滾事務  
            tc.rollback(); 
        }finally {
            // 關閉Session連線 
            HibernateUtil.closeSession();
        }

    }

    /**
     * 查詢使用者
     */
    public void getUser() {
        UserTest ut = null;
        Session session = HibernateUtil.getsSession();  
        Transaction tx = session.beginTransaction();
        try {
            // 使用session的get方法獲取指定id的使用者 
            ut = session.get(UserTest.class, 2);
            System.out.println(ut.getUserName()+":"+ut.getEmail());
            tx.commit();
        } catch (Exception e) {
            e.printStackTrace();
            tx.rollback();
        }finally {
            HibernateUtil.closeSession();
        }
    }

    /**
     * 刪除使用者
     */
    public void deleteUser() {
        Session session = HibernateUtil.getsSession();  
        Transaction tx = session.beginTransaction();
        try {
            // 使用session載入一個持久化物件 
            UserTest ut = session.get(UserTest.class, 3);
            session.delete(ut);
            System.out.println(ut.getUserName()+":"+ut.getEmail());
            tx.commit();
        } catch (Exception e) {
            e.printStackTrace();
            tx.rollback();
        }finally {
            HibernateUtil.closeSession();
        }
    }

    /**
     * 更新使用者資料
     */
    public void updateUser() {
        Session session = HibernateUtil.getsSession();  
        Transaction tx = session.beginTransaction();  
        try {  
            // 使用session的update方法更新持久化物件 
            UserTest ut = session.get(UserTest.class, 2);
            ut.setUserName("Alice");
            session.update(ut);  
            tx.commit();  
        } catch (Exception e) {  
            tx.rollback();  
            e.printStackTrace();
        } finally {  
            HibernateUtil.closeSession();  
        }  
    }

    public static void main(String[] args) {
        TestUser tu = new TestUser();
        tu.updateUser();
    }
}

到此，一個簡單的Hibernate專案就搭建完成了。

Hibernate提供了一些常用的主鍵生成器策略，如下：

• increment
• identity
• sequence
• hilo
• native
• assigned
  

  具體的主鍵生成器策略有何作用這裡就不多說了,如果要看請移步starskyhu

途中遇到的問題和犯得錯誤:

• 資料表沒有序列化導致異常
• UserTest.hbm.xml中id主鍵生成策略用了native報異常：序列不存在，網上查找了一下，說是oracle 資料庫插入資料不能自增，可以建立sequence生成自增序列（還是一臉慒逼）
• 用Hibernate自動生成的hibernate.cfg.xml配置檔案中<session-factory name="">需要把name=""去掉

• Disabling contextual LOB creation as createClob() method threw error：java.lang.reflect.InvocationTargetException，專案執行正常，又去網上百度了一波，
  有兩種說法：

  • 一種是說Oracle資料庫驅動版本的原因（過老？）
  • 還有一種說法是（搞得我還是一頭霧水）：It happens during the boot, when Hibernate tries to retrieve some meta information from the database我英語不太好，但大概的意思就是當Hibernate試圖從資料庫檢索一些元資料資訊的時候發生了此異常。他們給出瞭解決方法： 在hibernate.cfg.xml檔案中新增以下屬性<property name="hibernate.temp.use_jdbc_metadata_defaults">false</property>

• Hibernate的github地址：Hibernate

總結

通過對本次的專案配置，對Hibernate框架有了更清晰的瞭解，但還有許多知識等待擴充，但從各種異常當中也收穫許多。不要怕異常，只有在失敗中才能加深自己對這框架的理解和使用。接下來的一段時間裡 讓我們一起努力吧！