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提供的內置標識符生成器:
increment 標識符生成器由 Hibernate 以遞增的方式爲代理主鍵賦值
Hibernate 會先讀取 NEWS 表中的主鍵的最大值, 而接下來向 NEWS 表中插入記錄時, 就在 max(id) 的基礎上遞增, 增量爲 1.
適用範圍:- 由於 increment 生存標識符機制不依賴於底層數據庫系統, 因此它適合所有的數據庫系統
- 適用於只有單個 Hibernate 應用進程訪問同一個數據庫的場合, 在集羣環境下不推薦使用它
- OID 必須爲 long, int 或 short 類型, 如果把 OID 定義爲 byte 類型, 在運行時會拋出異常
- identity 標識符生成器由底層數據庫來負責生成標識符, 它要求底層數據庫把主鍵定義爲自動增長字段類型
適用範圍:
- 由於 identity 生成標識符的機制依賴於底層數據庫系統, 因此, 要求底層數據庫系統必須支持自動增長字段類型. 支持自動增長字段類型的數據庫包括: DB2, Mysql, MSSQLServer, Sybase 等
- OID 必須爲 long, int 或 short 類型, 如果把 OID 定義爲 byte 類型, 在運行時會拋出異常
- sequence 標識符生成器利用底層數據庫提供的序列來生成標識符.
適用範圍:
- 由於 sequence 生成標識符的機制依賴於底層數據庫系統的序列, 因此, 要求底層數據庫系統必須支持序列. 支持序列的數據庫包括: DB2, Oracle 等
- OID 必須爲 long, int 或 short 類型, 如果把 OID 定義爲 byte 類型, 在運行時會拋出異常
- hilo 標識符生成器由 Hibernate 按照一種 high/low 算法*生成標識符, 它從數據庫的特定表的字段中獲取 high 值.
Hibernate 在持久化一個 News 對象時, 由 Hibernate 負責生成主鍵值. hilo 標識符生成器在生成標識符時, 需要讀取並修改 HI_TABLE 表中的 NEXT_VALUE 值.
適用範圍:
- 由於 hilo 生存標識符機制不依賴於底層數據庫系統, 因此它適合所有的數據庫系統
- 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");
}
}