8、Hibernate框架(ORM詳解、主文件配置、映射文件配置)

開發回顧：
SSH框架：
Struts框架， 基於mvc模式的應用層框架技術！
Hibernate, 基於持久層的框架(數據訪問層使用)！
Spring, 創建對象處理對象的依賴關係以及框架整合！

Dao代碼，如何編寫？
    - 操作XML數據
    - 使用Jdbc技術
        原始的jdbc操作， Connection/Statement/ResultSet
         自定義一個持久層框架, 封裝了dao的通用方法
         DbUtils組件， 輕量級的dao的組件；
         Hibernate技術  【hibernate最終執行的也是jdbc代碼！】

一、Hibernate框架
ORM概念
O, Object 對象
R， Realtion 關係 (關係型數據庫: MySQL, Oracle…)
M，Mapping 映射

ORM, 對象關係映射！

ORM, 解決什麼問題？
存儲： 能否把對象的數據直接保存到數據庫？
獲取： 能否直接從數據庫拿到一個對象？
想做到上面2點，必須要有映射！

總結：
Hibernate與ORM的關係？
Hibernate是ORM的實現！

組件學習：
1. 源碼，引入jar文件
2. 配置
3. Api
Hibernate HelloWorld案例
搭建一個Hibernate環境，開發步驟：
1. 下載源碼
版本：hibernate-distribution-3.6.0.Final
2. 引入jar文件
hibernate3.jar核心 + required 必須引入的(6個) + jpa 目錄 + 數據庫驅動包
3. 寫對象以及對象的映射
Employee.java 對象
Employee.hbm.xml 對象的映射 (映射文件)
4. src/hibernate.cfg.xml 主配置文件
- 數據庫連接配置
- 加載所用的映射(*.hbm.xml)
5. App.java 測試

Employee.java 對象

//一、 對象
public class Employee {

    private int empId;
    private String empName;
    private Date workDate;

}

Employee.hbm.xml 對象的映射

<?xml version="1.0"?>
<!DOCTYPE hibernate-mapping PUBLIC 
    "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
    "http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd">

<hibernate-mapping package="cn.itcast.a_hello">

    <class name="Employee" table="employee">

        <!-- 主鍵 ，映射-->
        <id name="empId" column="id">
            <generator class="native"/>
        </id>

        <!-- 非主鍵，映射 -->
        <property name="empName" column="empName"></property>
        <property name="workDate" column="workDate"></property>

    </class>

</hibernate-mapping>

hibernate.cfg.xml 主配置文件

<!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">com.mysql.jdbc.Driver</property>
        <property name="hibernate.connection.url">jdbc:mysql:///hib_demo</property>
        <property name="hibernate.connection.username">root</property>
        <property name="hibernate.connection.password">root</property>
        <property name="hibernate.dialect">org.hibernate.dialect.MySQL5Dialect</property>

        <property name="hibernate.show_sql">true</property>

        <!-- 加載所有映射 -->
        <mapping resource="cn/itcast/a_hello/Employee.hbm.xml"/>
    </session-factory>
</hibernate-configuration>

App.java 測試類

public class App {

    @Test
    public void testHello() throws Exception {
        // 對象
        Employee emp = new Employee();
        emp.setEmpName("班長");
        emp.setWorkDate(new Date());

        // 獲取加載配置文件的管理類對象
        Configuration config = new Configuration();
        config.configure();  // 默認加載src/hibenrate.cfg.xml文件
        // 創建session的工廠對象
        SessionFactory sf = config.buildSessionFactory();
        // 創建session (代表一個會話，與數據庫連接的會話)
        Session session = sf.openSession();
        // 開啓事務
        Transaction tx = session.beginTransaction();
        //保存-數據庫
        session.save(emp);
        // 提交事務
        tx.commit();
        // 關閉
        session.close();
        sf.close();
    }
}

Hibernate Api
|– Configuration 配置管理類對象
config.configure(); 加載主配置文件的方法(hibernate.cfg.xml)
默認加載src/hibernate.cfg.xml
config.configure(“cn/config/hibernate.cfg.xml”); 加載指定路徑下指定名稱的主配置文件
config.buildSessionFactory(); 創建session的工廠對象

|– SessionFactory session的工廠（或者說代表了這個hibernate.cfg.xml配置文件）
sf.openSession(); 創建一個sesison對象
sf.getCurrentSession(); 創建session或取出session對象

|–Session session對象維護了一個連接(Connection), 代表了與數據庫連接的會話。
Hibernate最重要的對象： 只用使用hibernate與數據庫操作，都用到這個對象
session.beginTransaction(); 開啓一個事務； hibernate要求所有的與數據庫的操作必須有事務的環境，否則報錯！

更新：
session.save(obj); 保存一個對象
session.update(emp); 更新一個對象
session.saveOrUpdate(emp); 保存或者更新的方法：
沒有設置主鍵，執行保存；
有設置主鍵，執行更新操作;
如果設置主鍵不存在報錯！

主鍵查詢：
session.get(Employee.class, 1); 主鍵查詢
session.load(Employee.class, 1); 主鍵查詢 (支持懶加載)

HQL查詢：
HQL查詢與SQL查詢區別：
SQL: (結構化查詢語句)查詢的是表以及字段; 不區分大小寫。
HQL: hibernate query language 即hibernate提供的面向對象的查詢語言
查詢的是對象以及對象的屬性。
區分大小寫。

Criteria查詢：
完全面向對象的查詢。
本地SQL查詢：
複雜的查詢，就要使用原生態的sql查詢，也可以，就是本地sql查詢的支持！
(缺點： 不能跨數據庫平臺！)

|– Transaction hibernate事務對象

共性問題1：
ClassNotFoundException…., 缺少jar文件！
問題2：
如果程序執行程序，hibernate也有生成sql語句，但數據沒有結果影響。
問題一般是事務忘記提交…….
遇到問題，一定看錯誤提示!

Hibernate crud

public class EmployeeDaoImpl implements IEmployeeDao{

    @Override
    public Employee findById(Serializable id) {
        Session session = null;
        Transaction tx = null;
        try {
            // 獲取Session
            session = HibernateUtils.getSession();
            // 開啓事務
            tx = session.beginTransaction();
            // 主鍵查詢
            return (Employee) session.get(Employee.class, id);
        } catch (Exception e) {
            throw new RuntimeException(e);
        } finally {
            tx.commit();
            session.close();
        }
    }

    @Override
    public List<Employee> getAll() {
        Session session = null;
        Transaction tx = null;
        try {
            session = HibernateUtils.getSession();
            tx = session.beginTransaction();
            // HQL查詢
            Query q = session.createQuery("from Employee");
            return q.list();
        } catch (Exception e) {
            throw new RuntimeException(e);
        } finally {
            tx.commit();
            session.close();
        }
    }

    @Override
    public List<Employee> getAll(String employeeName) {
        Session session = null;
        Transaction tx = null;
        try {
            session = HibernateUtils.getSession();
            tx = session.beginTransaction();
            Query q =session.createQuery("from Employee where empName=?");
            // 注意：參數索引從0開始
            q.setParameter(0, employeeName);
            // 執行查詢
            return q.list();
        } catch (Exception e) {
            throw new RuntimeException(e);
        } finally {
            tx.commit();
            session.close();
        }
    }

    @Override
    public List<Employee> getAll(int index, int count) {
        Session session = null;
        Transaction tx = null;
        try {
            session = HibernateUtils.getSession();
            tx = session.beginTransaction();
            Query q = session.createQuery("from Employee");
            // 設置分頁參數
            q.setFirstResult(index);  // 查詢的其實行 
            q.setMaxResults(count);   // 查詢返回的行數

            List<Employee> list = q.list();
            return list;
        } catch (Exception e) {
            throw new RuntimeException(e);
        } finally {
            tx.commit();
            session.close();
        }
    }

    @Override
    public void save(Employee emp) {
        Session session = null;
        Transaction tx = null;
        try {
            session = HibernateUtils.getSession();
            tx = session.beginTransaction();
            // 執行保存操作
            session.save(emp);
        } catch (Exception e) {
            throw new RuntimeException(e);
        } finally {
            tx.commit();
            session.close();
        }

    }

    @Override
    public void update(Employee emp) {
        Session session = null;
        Transaction tx = null;
        try {
            session = HibernateUtils.getSession();
            tx = session.beginTransaction();
            session.update(emp);

        } catch (Exception e) {
            throw new RuntimeException(e);
        } finally {
            tx.commit();
            session.close();
        }

    }

    @Override
    public void delete(Serializable id) {
        Session session = null;
        Transaction tx = null;
        try {
            session = HibernateUtils.getSession();
            tx = session.beginTransaction();
            // 先根據id查詢對象，再判斷刪除
            Object obj = session.get(Employee.class, id);
            if (obj != null) {
                session.delete(obj);
            }
        } catch (Exception e) {
            throw new RuntimeException(e);
        } finally {
            tx.commit();
            session.close();
        }
    }
}

二、Hibernate.cfg.xml 主配置

Hibernate.cfg.xml
主配置文件中主要配置：數據庫連接信息、其他參數、映射信息！

常用配置查看源碼：
hibernate-distribution-3.6.0.Final\project\etc\hibernate.properties

數據庫連接參數配置
例如：

## MySQL

#hibernate.dialect org.hibernate.dialect.MySQLDialect
#hibernate.dialect org.hibernate.dialect.MySQLInnoDBDialect
#hibernate.dialect org.hibernate.dialect.MySQLMyISAMDialect
#hibernate.connection.driver_class com.mysql.jdbc.Driver
#hibernate.connection.url jdbc:mysql:///test
#hibernate.connection.username gavin
#hibernate.connection.password

自動建表
Hibernate.properties

-#hibernate.hbm2ddl.auto create-drop 每次在創建sessionFactory時候執行創建表；
當調用sesisonFactory的close方法的時候，刪除表！
-#hibernate.hbm2ddl.auto create 每次都重新建表； 如果表已經存在就先刪除再創建
-#hibernate.hbm2ddl.auto update 如果表不存在就創建； 表存在就不創建；
-#hibernate.hbm2ddl.auto validate (生成環境時候) 執行驗證： 當映射文件的內容與數據庫表結構不一樣的時候就報錯！

代碼自動建表：

public class App_ddl {

    // 自動建表
    @Test
    public void testCreate() throws Exception {
        // 創建配置管理類對象
        Configuration config = new Configuration();
        // 加載主配置文件
        config.configure();

        // 創建工具類對象
        SchemaExport export = new SchemaExport(config);
        // 建表
        // 第一個參數： 是否在控制檯打印建表語句
        // 第二個參數： 是否執行腳本
        export.create(true, true);
    }
}

三、映射配置

1. 普通字段類型
2. 主鍵映射
   單列主鍵映射
   多列作爲主鍵映射

主鍵生成策略，查看api： 5.1.2.2.1. Various additional generators

數據庫：
一個表能否有多個主鍵？ 不能。
爲什麼要設置主鍵？ 數據庫存儲的數據都是有效的，必須保持唯一。

(爲什麼把id作爲主鍵？)
    因爲表中通常找不到合適的列作爲唯一列即主鍵，所以爲了方法用id列，因爲id是數據庫系統維護可以保證唯一，所以就把這列作爲主鍵!

聯合/複合主鍵
如果找不到合適的列作爲主鍵，出來用id列以外，我們一般用聯合主鍵，即多列的值作爲一個主鍵，從而確保記錄的唯一性。

映射配置

<?xml version="1.0"?>
<!DOCTYPE hibernate-mapping PUBLIC 
    "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
    "http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd">

<!-- 映射文件: 映射一個實體類對象；  描述一個對象最終實現可以直接保存對象數據到數據庫中。  -->
<!-- 
    package: 要映射的對象所在的包(可選,如果不指定,此文件所有的類都要指定全路徑)
    auto-import 默認爲true， 在寫hql的時候自動導入包名
                如果指定爲false, 再寫hql的時候必須要寫上類的全名；
                  如：session.createQuery("from cn.itcast.c_hbm_config.Employee").list();
 -->
<hibernate-mapping package="cn.itcast.c_hbm_config" auto-import="true">

    <!-- 
        class 映射某一個對象的(一般情況，一個對象寫一個映射文件，即一個class節點)
            name 指定要映射的對象的類型
            table 指定對象對應的表；
                  如果沒有指定表名，默認與對象名稱一樣 
     -->
    <class name="Employee" table="employee">

        <!-- 主鍵 ，映射-->
        <id name="empId" column="id">
            <!-- 
                主鍵的生成策略
                    identity  自增長(mysql,db2)
                    sequence  自增長(序列)， oracle中自增長是以序列方法實現
                    native  自增長【會根據底層數據庫自增長的方式選擇identity或sequence】
                            如果是mysql數據庫, 採用的自增長方式是identity
                            如果是oracle數據庫， 使用sequence序列的方式實現自增長

                    increment  自增長(會有併發訪問的問題，一般在服務器集羣環境使用會存在問題。)

                    assigned  指定主鍵生成策略爲手動指定主鍵的值
                    uuid      指定uuid隨機生成的唯一的值
                    foreign   (外鍵的方式， one-to-one講)
             -->
            <generator class="uuid"/>
        </id>

        <!-- 
            普通字段映射
            property
                name  指定對象的屬性名稱
                column 指定對象屬性對應的表的字段名稱，如果不寫默認與對象屬性一致。
                length 指定字符的長度, 默認爲255
                type   指定映射表的字段的類型，如果不指定會匹配屬性的類型
                    java類型：     必須寫全名
                    hibernate類型：  直接寫類型，都是小寫
        -->
        <property name="empName" column="empName" type="java.lang.String" length="20"></property>
        <property name="workDate" type="java.util.Date"></property>
        <!-- 如果列名稱爲數據庫關鍵字，需要用反引號或改列名。 -->
        <property name="desc" column="`desc`" type="java.lang.String"></property>

    </class>


</hibernate-mapping>

複合主鍵映射

// 複合主鍵類
public class CompositeKeys implements Serializable{
    private String userName;
    private String address;
   // .. get/set
}
public class User {

    // 名字跟地址，不會重複
    private CompositeKeys keys;
    private int age;
}
User.hbm.xml
<?xml version="1.0"?>
<!DOCTYPE hibernate-mapping PUBLIC 
    "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
    "http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd">

<hibernate-mapping package="cn.itcast.d_compositeKey" auto-import="true">

    <class name="User">

        <!-- 複合主鍵映射 -->
        <composite-id name="keys">
            <key-property name="userName" type="string"></key-property>
            <key-property name="address" type="string"></key-property>
        </composite-id>

        <property name="age" type="int"></property>     

    </class>


</hibernate-mapping>

App.java

public class App2 {

    private static SessionFactory sf;
    static  {       
        // 創建sf對象
        sf = new Configuration()
            .configure()
            .addClass(User.class)  //（測試） 會自動加載映射文件：Employee.hbm.xml
            .buildSessionFactory();
    }

    //1. 保存對象
    @Test
    public void testSave() throws Exception {
        Session session = sf.openSession();
        Transaction tx = session.beginTransaction();

        // 對象
        CompositeKeys keys = new CompositeKeys();
        keys.setAddress("廣州棠東");
        keys.setUserName("Jack");
        User user = new User();
        user.setAge(20);
        user.setKeys(keys);

        // 保存
        session.save(user);


        tx.commit();
        session.close();
    }

    @Test
    public void testGet() throws Exception {
        Session session = sf.openSession();
        Transaction tx = session.beginTransaction();

        //構建主鍵再查詢
        CompositeKeys keys = new CompositeKeys();
        keys.setAddress("廣州棠東");
        keys.setUserName("Jack");

        // 主鍵查詢
        User user = (User) session.get(User.class, keys);
        // 測試輸出
        if (user != null){
            System.out.println(user.getKeys().getUserName());
            System.out.println(user.getKeys().getAddress());
            System.out.println(user.getAge());
        }


        tx.commit();
        session.close();
    }
}

練習：
1. 搭建hibernate開發環境
2. Api
Session類的相關方法
3. 主配置文件/映射配置/主鍵映射