Hibernate 框架對象/關係(ORM)映射文件

POJO 類和數據庫的映射文件*.hbm.xml
通過 POJO 類的數據庫映射文件,Hibernate可以理解持久化類和數據表之間的對應關係,也可以理解持久化類屬性與數據庫表列之間的對應關係
News.java

package com.hibernate.helloworld;

import java.sql.Blob;
import java.util.Date;

public class News {

    private Integer id;
    private String title;
    private String author;
    private Date createDate;
    private String content;
    private Blob img;

    private String desc;

    public Integer getId() {
        return id;
    }
    public void setId(Integer id) {
        this.id = id;
    }
    public String getTitle() {
        return title;
    }
    public void setTitle(String title) {
        this.title = title;
    }
    public String getAuthor() {
        return author;
    }
    public void setAuthor(String author) {
        this.author = author;
    }
    public Date getCreateDate() {
        return createDate;
    }
    public void setCreateDate(Date createDate) {
        this.createDate = createDate;
    }

    public News() {
    }

    public News(String title, String author, Date createDate) {
        super();
        this.title = title;
        this.author = author;
        this.createDate = createDate;
    }

    public String getDesc() {
        return desc;
    }
    @Override
    public String toString() {
        return "News [id=" + id + ", title=" + title + ", author=" + author
                + ", createDate=" + createDate + ", desc=" + desc + "]";
    }
    public void setDesc(String desc) {
        this.desc = desc;
    }
    public String getContent() {
        return content;
    }
    public void setContent(String content) {
        this.content = content;
    }
    public Blob getImg() {
        return img;
    }
    public void setImg(Blob img) {
        this.img = img;
    }
}

News.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">
<hibernate-mapping package="com.hibernate.helloworld">
<!-- dynamic-update: 若設置爲 true, 表示當更新一個對象時, 會動態生成 update 語句, update 語句中僅包含所有取值需要更新的字段. 默認值爲 false -->
    <class name="News" table="NEWS" dynamic-update="true">
        <id name="id" type="java.lang.Integer">
            <column name="ID" />
            <generator class="increment" />
        </id>
        <property name="title" type="string" update="false" unique="true" index="news_index" length="20">
            <column name="TITLE" />
        </property>
        <property name="author" type="java.lang.String" index="news_index">
            <column name="AUTHOR" />
        </property>
        <property name="createDate" type="time" not-null="true">
            <column name="CREATE_DATE" />
        </property>
        <!-- 映射派生屬性 -->
        <property name="desc" formula="(SELECT concat(title, ': ', author) FROM news n WHERE n.id = id)">
        </property>
        <!-- 映射大文本 -->
        <property name="content" type="string">
            <column name="CONTENT" />
        </property>
        <!-- 精確映射使用sql-type -->
        <property name="img">
            <column name="IMG" sql-type="mediumblob"/>
        </property>
    </class>
</hibernate-mapping>

hibernate-mapping

每個Hibernate-mapping中可以同時定義多個類. 但更推薦爲每個類都創建一個單獨的映射文件

  • 類層次:class
    • 主鍵:id
    • 基本類型:property
    • 實體引用類: many-to-one | one-to-one
    • 集合:set | list | map | array
    • one-to-many
    • many-to-many
    • 子類:subclass | joined-subclass
    • 其它:component | any 等
  • 查詢語句:query(用來放置查詢語句,便於對數據庫查詢的統一管理和優化)

hibernate-mapping 是 hibernate 映射文件的根元素

schema: 指定所映射的數據庫schema的名稱。若指定該屬性, 則表明會自動添加該 schema 前綴
catalog:指定所映射的數據庫catalog的名稱。
default-cascade(默認爲 none): 設置hibernate默認的級聯風格. 若配置 Java 屬性, 集合映射時沒有指定 cascade 屬性, 則 Hibernate 將採用此處指定的級聯風格.
default-access (默認爲 property): 指定 Hibernate 的默認的屬性訪問策略。默認值爲 property, 即使用 getter, setter 方法來訪問屬性. 若指定 access, 則 Hibernate 會忽略 getter/setter 方法, 而通過反射訪問成員變量.
default-lazy(默認爲 true): 設置 Hibernat morning的延遲加載策略. 該屬性的默認值爲 true, 即啓用延遲加載策略. 若配置 Java 屬性映射, 集合映射時沒有指定 lazy 屬性, 則 Hibernate 將採用此處指定的延遲加載策略
auto-import (默認爲 true): 指定是否可以在查詢語言中使用非全限定的類名(僅限於本映射文件中的類)。
package (可選): 指定一個包前綴,如果在映射文檔中沒有指定全限定的類名, 就使用這個作爲包名。

class 元素用於指定類和表的映射

name:指定該持久化類映射的持久化類的類名
table:指定該持久化類映射的表名, Hibernate 默認以持久化類的類名作爲表名
dynamic-insert: 若設置爲 true, 表示當保存一個對象時, 會動態生成 insert 語句, insert 語句中僅包含所有取值不爲 null 的字段. 默認值爲 false
dynamic-update: 若設置爲 true, 表示當更新一個對象時, 會動態生成 update 語句, update 語句中僅包含所有取值需要更新的字段. 默認值爲 false
select-before-update:設置 Hibernate 在更新某個持久化對象之前是否需要先執行一次查詢. 默認值爲 false
batch-size:指定根據 OID 來抓取實例時每批抓取的實例數.
lazy: 指定是否使用延遲加載.
mutable: 若設置爲 true, 等價於所有的 元素的 update 屬性爲 false, 表示整個實例不能被更新. 默認爲 true.
discriminator-value: 指定區分不同子類的值. 當使用 元素來定義持久化類的繼承關係時需要使用該屬性

映射對象標識符

Hibernate 使用對象標識符(OID) 來建立內存中的對象和數據庫表中記錄的對應關係. 對象的 OID 和數據表的主鍵對應. Hibernate 通過標識符生成器來爲主鍵賦值
Hibernate 推薦在數據表中使用代理主鍵, 即不具備業務含義的字段. 代理主鍵通常爲整數類型, 因爲整數類型比字符串類型要節省更多的數據庫空間.
在對象-關係映射文件中, 元素用來設置對象標識符. 子元素用來設定標識符生成器.
Hibernate 提供了標識符生成器接口: IdentifierGenerator, 並提供了各種內置實現

id:設定持久化類的 OID 和表的主鍵的映射

name: 標識持久化類 OID 的屬性名
column: 設置標識屬性所映射的數據表的列名(主鍵字段的名字).
unsaved-value:若設定了該屬性, Hibernate 會通過比較持久化類的 OID 值和該屬性值來區分當前持久化類的對象是否爲臨時對象
type:指定 Hibernate 映射類型. Hibernate 映射類型是 Java 類型與 SQL 類型的橋樑. 如果沒有爲某個屬性顯式設定映射類型, Hibernate 會運用反射機制先識別出持久化類的特定屬性的 Java 類型, 然後自動使用與之對應的默認的 Hibernate 映射類型
Java 的基本數據類型和包裝類型對應相同的 Hibernate 映射類型. 基本數據類型無法表達 null, 所以對於持久化類的 OID 推薦使用包裝類型

generator:設定持久化類設定標識符生成器

class: 指定使用的標識符生成器全限定類名或其縮寫名

Hibernate提供的內置標識符生成器:

這裏寫圖片描述

  1. increment 標識符生成器由 Hibernate 以遞增的方式爲代理主鍵賦值
    Hibernate 會先讀取 NEWS 表中的主鍵的最大值, 而接下來向 NEWS 表中插入記錄時, 就在 max(id) 的基礎上遞增, 增量爲 1.
    適用範圍:

    • 由於 increment 生存標識符機制不依賴於底層數據庫系統, 因此它適合所有的數據庫系統
    • 適用於只有單個 Hibernate 應用進程訪問同一個數據庫的場合, 在集羣環境下不推薦使用它
    • OID 必須爲 long, int 或 short 類型, 如果把 OID 定義爲 byte 類型, 在運行時會拋出異常
  2. identity 標識符生成器由底層數據庫來負責生成標識符, 它要求底層數據庫把主鍵定義爲自動增長字段類型
    適用範圍:
    • 由於 identity 生成標識符的機制依賴於底層數據庫系統, 因此, 要求底層數據庫系統必須支持自動增長字段類型. 支持自動增長字段類型的數據庫包括: DB2, Mysql, MSSQLServer, Sybase 等
    • OID 必須爲 long, int 或 short 類型, 如果把 OID 定義爲 byte 類型, 在運行時會拋出異常
  3. sequence 標識符生成器利用底層數據庫提供的序列來生成標識符.
    適用範圍:
    • 由於 sequence 生成標識符的機制依賴於底層數據庫系統的序列, 因此, 要求底層數據庫系統必須支持序列. 支持序列的數據庫包括: DB2, Oracle 等
    • OID 必須爲 long, int 或 short 類型, 如果把 OID 定義爲 byte 類型, 在運行時會拋出異常
  4. hilo 標識符生成器由 Hibernate 按照一種 high/low 算法*生成標識符, 它從數據庫的特定表的字段中獲取 high 值.
    Hibernate 在持久化一個 News 對象時, 由 Hibernate 負責生成主鍵值. hilo 標識符生成器在生成標識符時, 需要讀取並修改 HI_TABLE 表中的 NEXT_VALUE 值.
    適用範圍:
    • 由於 hilo 生存標識符機制不依賴於底層數據庫系統, 因此它適合所有的數據庫系統
  5. native 標識符生成器依據底層數據庫對自動生成標識符的支持能力, 來選擇使用 identity, sequence 或 hilo 標識符生成器.
    適用範圍:
    • 由於 native 能根據底層數據庫系統的類型, 自動選擇合適的標識符生成器, 因此很適合於跨數據庫平臺開發
    • OID 必須爲 long, int 或 short 類型, 如果把 OID 定義爲 byte 類型, 在運行時會拋出異常

property 元素用於指定類的屬性和表的字段的映射

name:指定該持久化類的屬性的名字
column:指定與類的屬性映射的表的字段名. 如果沒有設置該屬性, Hibernate 將直接使用類的屬性名作爲字段名.
type:指定 Hibernate 映射類型. Hibernate 映射類型是 Java 類型與 SQL 類型的橋樑. 如果沒有爲某個屬性顯式設定映射類型, Hibernate 會運用反射機制先識別出持久化類的特定屬性的 Java 類型, 然後自動使用與之對應的默認的 Hibernate 映射類型.
not-null:若該屬性值爲 true, 表明不允許爲 null, 默認爲 false
access:指定 Hibernate 的默認的屬性訪問策略。默認值爲 property, 即使用 getter, setter 方法來訪問屬性. 若指定 field, 則 Hibernate 會忽略 getter/setter 方法, 而通過反射訪問成員變量
unique: 設置是否爲該屬性所映射的數據列添加唯一約束.
update:列的值是否可以修改,默認爲false
index: 指定一個字符串的索引名稱. 當系統需要 Hibernate 自動建表時, 用於爲該屬性所映射的數據列創建索引, 從而加快該數據列的查詢.
length: 指定該屬性所映射數據列的字段的長度
scale: 指定該屬性所映射數據列的小數位數, 對 double, float, decimal 等類型的數據列有效.
formula:設置一個 SQL 表達式, Hibernate 將根據它來計算出派生屬性的值.
派生屬性: 並不是持久化類的所有屬性都直接和表的字段匹配, 持久化類的有些屬性的值必須在運行時通過計算才能得出來, 這種屬性稱爲派生屬性
使用 formula 屬性時
formula=“(sql)” 的英文括號不能少
Sql 表達式中的列名和表名都應該和數據庫對應, 而不是和持久化對象的屬性對應
如果需要在 formula 屬性中使用參數, 這直接使用 where cur.id=id 形式, 其中 id 就是參數, 和當前持久化對象的 id 屬性對應的列的 id 值將作爲參數傳入.

Java 類型, Hibernate 映射類型及 SQL 類型之間的對應關係

這裏寫圖片描述
這裏寫圖片描述

Java 時間和日期類型的 Hibernate 映射

在 Java 中, 代表時間和日期的類型包括: java.util.Date 和 java.util.Calendar. 此外, 在 JDBC API 中還提供了 3 個擴展了 java.util.Date 類的子類: java.sql.Date, java.sql.Time 和 java.sql.Timestamp, 這三個類分別和標準 SQL 類型中的 DATE, TIME 和 TIMESTAMP 類型對應
在標準 SQL 中, DATE 類型表示日期, TIME 類型表示時間, TIMESTAMP 類型表示時間戳, 同時包含日期和時間信息.
這裏寫圖片描述
以下情況下必須顯式指定 Hibernate 映射類型
一個 Java 類型可能對應多個 Hibernate 映射類型. 例如: 如果持久化類的屬性爲 java.util.Date 類型, 對應的 Hibernate 映射類型可以是 date, time 或 timestamp. 此時必須根據對應的數據表的字段的 SQL 類型, 來確定 Hibernate 映射類型. 如果字段爲 DATE 類型, 那麼 Hibernate 映射類型爲 date; 如果字段爲 TIME 類型, 那麼 Hibernate 映射類型爲 time; 如果字段爲 TIMESTATMP 類型, 那麼 Hibernate 映射類型爲 timestamp.

Java 大對象類型的 Hiberante 映射

在 Java 中, java.lang.String 可用於表示長字符串(長度超過 255), 字節數組 byte[] 可用於存放圖片或文件的二進制數據. 此外, 在 JDBC API 中還提供了 java.sql.Clob 和 java.sql.Blob 類型, 它們分別和標準 SQL 中的 CLOB 和 BLOB 類型對應. CLOB 表示字符串大對象(Character Large Object), BLOB表示二進制對象(Binary Large Object)
這裏寫圖片描述
Mysql 不支持標準 SQL 的 CLOB 類型, 在 Mysql 中, 用 TEXT, MEDIUMTEXT 及 LONGTEXT 類型來表示長度操作 255 的長文本數據
在持久化類中, 二進制大對象可以聲明爲 byte[] 或 java.sql.Blob 類型; 字符串可以聲明爲 java.lang.String 或 java.sql.Clob
實際上在 Java 應用程序中處理長度超過 255 的字符串, 使用 java.lang.String 比 java.sql.Clob 更方便

Hibernate 使用 <\component> 元素來映射組成關係

Pay.java

package com.hibernate.entities;

public class Pay {

    private int monthPay;
    private int yearPay;
    private int vocationWithPay;

    private Worker worker;

    public int getMonthPay() {
        return monthPay;
    }
    public void setMonthPay(int monthPay) {
        this.monthPay = monthPay;
    }
    public int getYearPay() {
        return yearPay;
    }
    public void setYearPay(int yearPay) {
        this.yearPay = yearPay;
    }
    public int getVocationWithPay() {
        return vocationWithPay;
    }
    public void setVocationWithPay(int vocationWithPay) {
        this.vocationWithPay = vocationWithPay;
    }
    @Override
    public String toString() {
        return "Pay [monthPay=" + monthPay + ", yearPay=" + yearPay
                + ", vocationWithPay=" + vocationWithPay + "]";
    }
    public Worker getWorker() {
        return worker;
    }
    public void setWorker(Worker worker) {
        this.worker = worker;
    }   
}

Worker.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">
<hibernate-mapping package="com.hibernate.entities">
    <class name="Worker" table="WORKER">
        <id name="id" type="int">
            <column name="ID" />
            <generator class="native" />
        </id>
        <property name="name" type="java.lang.String">
            <column name="NAME" />
        </property>
        <!-- 映射組成關係 -->
        <component name="pay" class="Pay">
            <parent name="worker"/>
            <property name="monthPay" column="MONTH_PAY"></property>
            <property name="yearPay" column="YEAR_PAY"></property>
            <property name="vocationWithPay" column="VOCATION_WITH_PAY"></property>
        </component>
    </class>
</hibernate-mapping>

component 元素來映射組成關係

class:設定組成關係屬性的類型, 此處表明 pay 屬性爲 Pay 類型

parent 元素指定組件屬性所屬的整體類

name: 整體類在組件類中的屬性名

測試類PropertiesTest.java

package com.hibernate.entities;

import java.io.FileInputStream;
import java.io.FileNotFoundException;
import java.io.IOException;
import java.io.InputStream;
import java.sql.Blob;
import java.sql.SQLException;
import java.util.Date;

import org.hibernate.Hibernate;
import org.hibernate.Session;
import org.hibernate.SessionFactory;
import org.hibernate.Transaction;
import org.hibernate.cfg.Configuration;
import org.hibernate.service.ServiceRegistry;
import org.hibernate.service.ServiceRegistryBuilder;
import org.junit.After;
import org.junit.Before;
import org.junit.Test;

import com.hibernate.helloworld.News;

public class PropertiesTest {

    SessionFactory sessionFactory;
    Session session;
    Transaction transaction;

    @Before
    public void init() {
        Configuration configuration = new Configuration().configure();
        @SuppressWarnings("deprecation")
        ServiceRegistry serviceRegistry = new ServiceRegistryBuilder()
            .applySettings(configuration.getProperties()).buildServiceRegistry();
        sessionFactory = configuration.buildSessionFactory(serviceRegistry);
        session = sessionFactory.openSession();
        transaction = session.beginTransaction();
    }

    @After
    public void destory() {
        transaction.commit();
        session.close();
        sessionFactory.close();
    }

    @Test
    public void testCompoment() {
        Worker worker = new Worker();
        Pay pay = new Pay();

        pay.setMonthPay(1000);
        pay.setYearPay(100000);
        pay.setMonthPay(5);
        worker.setPay(pay);
        worker.setName("HAHA");
        session.save(worker);
    }

    @Test
    public void testTypeBlob() throws IOException, SQLException {
        /*News news = new News("CC", "cc", new Date());
        news.setContent("content");
        InputStream stream = new FileInputStream("E:/htmltest/colorpicker/images/colorpicker_submit.png");
        Blob image = Hibernate.getLobCreator(session).createBlob(stream, stream.available());
        news.setImg(image);
        session.save(news);*/

        News news = (News) session.get(News.class, 6);
        System.out.println(news.getImg().getBinaryStream().available());
    }

    @Test
    public void testTypeDate() {
        News news = new News("AA", "aa", new Date());
        session.save(news);
    }

    @Test
    public void testUnique() {
        //News news = new News("AA", "aa", null);
        //session.save(news);
        News news = (News) session.get(News.class, 1);
        System.out.println(news);
    }

    @Test
    public void testIdGenerator() {
        News news = new News("AA", "aa", new Date());
        session.save(news);
    }

    @Test
    public void testDynamicUpdate() {
        News news = (News) session.get(News.class, 1);
        news.setAuthor("barry");
    }
}
發佈了60 篇原創文章 · 獲贊 5 · 訪問量 7萬+
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章