一、基礎(chǔ)入門
從一個(gè)最基本的對(duì)象關(guān)系映像自動(dòng)化程序，了解Hibernate組成的基本元素，并進(jìn)一步了解Hibernate的基礎(chǔ)語義、配置等概念。
1．O/R映像入門第一個(gè)Hibernate程序很簡單，將一個(gè)對(duì)象映像至一個(gè)數(shù)據(jù)表
1．1配置Hibernate
Hibernate是ORM的解決方案，其底層對(duì)數(shù)據(jù)庫的操作依賴于JDBC，所以您必須先取得JDBC驅(qū)動(dòng)程序，在這邊所使用的是MySQL，所以您必須至MySQL®Connector/J取得MySQL的JDBC驅(qū)動(dòng)程序。
接下來至Hibernate官方網(wǎng)站取得hibernate 3.0。
解開zip檔案后，當(dāng)中的hibernate3.jar是必要的，而在lib目錄中還包括了許多jar檔案，您可以在Hibernate 3.0官方的參考手冊(cè)上找到這些jar的相關(guān)說明，其中必要的是antlr、dom4j、CGLIB、asm、Commons Collections、Commons Logging、 EHCache，Hibernate底層還需要Java Transaction API，所以您還需要jta.jar，到這邊為止，總共需要以下的jar檔案：
Hibernate可以運(yùn)行于單機(jī)之上，也可以運(yùn)行于Web應(yīng)用程序之中，如果是運(yùn)行于單機(jī)，則將所有用到的jar檔案（包括JDBC驅(qū)動(dòng)程序）設(shè)定至CLASSPATH中，如果是運(yùn)行于Web應(yīng)用程序中，則將jar檔案置放于WEB-INF/lib中。
如果您還需要額外的Library，再依需求加入，例如JUnit、Proxool等等，接下來可以將etc目錄下的log4j.properties復(fù)制至Hibernate項(xiàng)目的Classpath下，并修改一下當(dāng)中的log4j.logger.org.hibernate為error，也就是只在錯(cuò)誤發(fā)生時(shí)顯示必要的訊息。
接著設(shè)置基本的Hibernate配置文件，可以使用XML或Properties檔案，這邊先使用XML，檔名預(yù)設(shè)為hibernate.cfg.xml：
hibernate.cfg.xml
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE hibernate-configuration PUBLIC
"-//Hibernate/Hibernate Configuration DTD 3.0//EN"
"
<hibernate-configuration>
<session-factory>
<!-- 顯示實(shí)際操作數(shù)據(jù)庫時(shí)的SQL -->
<property name="show_sql">true</property>
<!-- SQL 方言，這邊設(shè)定的是MySQL -->
<property name="dialect">org.hibernate.dialect.MySQLDialect</property>
<!-- JDBC 驅(qū)動(dòng)程序 -->
<property name="connection.driver_class">com.mysql.jdbc.Driver</property>
<!-- JDBC URL -->
<property name="connection.url">jdbc:mysql://localhost/demo</property>
<!-- 數(shù)據(jù)庫使用者 -->
<property name="connection.username">caterpillar</property>
<!-- 數(shù)據(jù)庫密碼 -->
<property name="connection.password">123456</property>
<!-- 以下設(shè)置對(duì)象與數(shù)據(jù)庫表格映像文件 -->
</session-factory>
</hibernate-configuration>
|
配置文件中已經(jīng)加上批注為每一個(gè)項(xiàng)目作了說明，其中對(duì)象與數(shù)據(jù)庫表格映像文件還有待加入。
1．2第一個(gè)Hibernate
這邊以一個(gè)簡單的單機(jī)程序來示范Hibernate的配置與功能，首先作數(shù)據(jù)庫的準(zhǔn)備工作，在MySQL中新增一個(gè)demo數(shù)據(jù)庫，并建立user表格：
CreateUser2MySQL.sql
CREATE TABLE user (
id INT(11) NOT NULL auto_increment PRIMARY KEY,
name VARCHAR(100) NOT NULL default '',
age INT
);
|
對(duì)于這個(gè)表格，您有一個(gè)User類別與之對(duì)應(yīng)，表格中的每一個(gè)字段將對(duì)應(yīng)至User實(shí)例上的Field成員。
User.java
package onlyfun.caterpillar;
public class User {
private Integer id;
private String name;
private Integer age;
// 必須要有一個(gè)預(yù)設(shè)的建構(gòu)方法
// 以使得Hibernate 可以使用Constructor.newInstance()建立對(duì)象
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;
}
}
|
其中id是個(gè)特殊的屬性，Hibernate會(huì)使用它來作為主鍵識(shí)別，您可以定義主鍵產(chǎn)生的方式，這是在XML映像文件中完成，為了告訴Hibernate您所定義的User實(shí)例如何映像至數(shù)據(jù)庫表格，您撰寫一個(gè)XML映射文件檔名是User.hbm.xml，如下所示：
User.hbm.xml
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
"
<hibernate-mapping>
<class name="onlyfun.caterpillar.User" table="user">
<id name="id" column="id" type="java.lang.Integer">
<generator class="native" />
</id>
<property name="name" column="name" type="java.lang.String" />
<property name="age" column="age" type="java.lang.Integer" />
</class>
</hibernate-mapping>
|
<class>卷標(biāo)的name屬性為所映像的對(duì)象，而table為所映像的表格；<id>中column屬性指定了表格字段，而type屬性指定了User實(shí)例的中的id之型態(tài)，這邊type中所設(shè)定的是直接指定Java中的對(duì)象型態(tài)，Hibernate也定義有自己的映像型態(tài)，作為Java對(duì)象與SQL型態(tài)的標(biāo)準(zhǔn)對(duì)應(yīng)型態(tài)（因?yàn)檎Z言所提供的類型并不一定與數(shù)據(jù)庫的類型對(duì)應(yīng)），這之后會(huì)再說明。
#p#
<id>中主鍵的產(chǎn)生方式在這邊設(shè)定為"native"，表示主鍵的生成方式由Hibernate根據(jù)數(shù)據(jù)庫Dialect的定義來決定，之后還會(huì)介紹其它主鍵的生成方式。
同樣的，<property>標(biāo)簽中的column與type都各自指明了表格中字段與對(duì)象中屬性的對(duì)應(yīng)。
接著必須在Hibernate配置文件hibernate.cfg.xml中指明映像文件的位置，如下加入映像文件位置：
hibernate.cfg.xml
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE hibernate-configuration PUBLIC
"-//Hibernate/Hibernate Configuration DTD 3.0//EN"
"
<hibernate-configuration>
<session-factor>
....
<!-- 對(duì)象與數(shù)據(jù)庫表格映像文件 -->
<mapping resource="onlyfun/caterpillar/User.hbm.xml"/>
</session-factory>
</hibernate-configuration>
|
接下來撰寫一個(gè)測(cè)試的程序，這個(gè)程序直接以Java 程序設(shè)計(jì)人員熟悉的語法方式來操作對(duì)象，而實(shí)際上也直接完成對(duì)數(shù)據(jù)庫的操作，程序?qū)?huì)將一筆數(shù)據(jù)存入表格之中：
FirstHibernate.java
package onlyfun.caterpillar;
import org.hibernate.Session;
import org.hibernate.SessionFactory;
import org.hibernate.Transaction;
import org.hibernate.cfg.Configuration;
public class FirstHibernate {
public static void main(String[] args) {
// Configuration 負(fù)責(zé)管理 Hibernate 配置訊息
Configuration config = new Configuration().configure();
// 根據(jù) config 建立 SessionFactory
// SessionFactory 將用于建立 Session
SessionFactory sessionFactory = config.buildSessionFactory();
//將持久化的物件
User user = new User();
user.setName("caterpillar");
user.setAge(new Integer(30));
//開啟Session，相當(dāng)于開啟JDBC 的Connection
Session session = sessionFactory.openSession();
//Transaction 表示一組對(duì)DB 的交易
Transaction tx = session.beginTransaction();
//將對(duì)象映像至數(shù)據(jù)庫表格中儲(chǔ)存
session.save(user);
tx.commit();
session.close();
sessionFactory.close();
System.out.println("新增資料OK!請(qǐng)先用MySQL 觀看結(jié)果！");
}
}
|
如您所看到的，程序中只需要直接操作User 對(duì)象，并進(jìn)行Session 與Transaction 的相關(guān)操作，Hibernate 就會(huì)自動(dòng)完成對(duì)數(shù)據(jù)庫的操作，您看不到任何一行JDBC 或SQL 的陳述，撰寫好以上的各個(gè)檔案之后，各檔案的放置位置如下：
接著可以開始運(yùn)行程序，結(jié)果如下：
FirstHibernate執(zhí)行結(jié)果
Hibernate: insert into user (name, age) values (?, ?)
|
新增資料OK!請(qǐng)先用MySQL 觀看結(jié)果！
執(zhí)行結(jié)果中顯示了Hibernate 所實(shí)際使用的SQL，由于這個(gè)程序還沒有查詢功能，所以要
進(jìn)入MySQL 中看看新增的數(shù)據(jù)，如下：
MySQL 中查詢結(jié)果
mysql> select * from user;
+----+-------------+------+
| id | name | age |
+----+-------------+------+
| 1 | caterpillar | 30 |
+----+-------------+------+
1 row in set (0.03 sec)
|
Comments
第四段代碼的標(biāo)題應(yīng)該是hibernate.cfg.xml
1．3 第二個(gè) Hibernate
在 第一個(gè) Hibernate 中介紹如何使用Hibernate 在不使用SQL 的情況下，以Java 中操作對(duì)象的習(xí)慣來插入數(shù)據(jù)至數(shù)據(jù)庫中，當(dāng)然儲(chǔ)存數(shù)據(jù)之后，更重要的是如何將資料讀出，Hibernate 中也可以讓您不寫一句SQL，而以Java 中操作對(duì)象的習(xí)慣來查詢數(shù)據(jù)。
直接來看個(gè)范例：
SecondHibernate.java
package onlyfun.caterpillar;
import org.hibernate.Criteria;
import org.hibernate.Session;
import org.hibernate.SessionFactory;
import org.hibernate.cfg.Configuration;
import org.hibernate.criterion.Expression;
import java.util.Iterator;
import java.util.List;
public class SecondHibernate {
public static void main(String[] args) {
Configuration config = new Configuration().configure();
SessionFactory sessionFactory = config.buildSessionFactory();
Session session = sessionFactory.openSession();
Criteria criteria = session.createCriteria(User.class);
// 查詢user 所有字段
List users = criteria.list();
Iterator iterator = users.iterator();
System.out.println("id \t name/age");
while (iterator.hasNext()) {
User user = (User) iterator.next();
System.out.println(user.getId() + " \t " + user.getName() + "/" +
user.getAge());
}
// 查詢user 中符合條件的字段
criteria.add(Expression.eq("name", "caterpillar"));
users = criteria.list();
iterator = users.iterator();
System.out.println("id \t name/age");
while (iterator.hasNext()) {
User user = (User) iterator.next();
System.out.println(user.getId() + " \t " + user.getName() + "/" +
user.getAge());
}
session.close();
sessionFactory.close();
}
}
|
#p#
Criteria 對(duì)SQL 進(jìn)行封裝，對(duì)于不甚了解SQL 的開發(fā)人員來說，使用Criteria 也可以輕易的進(jìn)行各種數(shù)據(jù)的檢索，您也可以使用 Expression 設(shè)定查詢條件，并將之加入Criteria中對(duì)查詢結(jié)果作限制，Expression.eq()表示設(shè)定符合條件的查詢，例如Expression.eq("name", "caterpillar")表示設(shè)定查詢條件為"name"字段中為"caterpillar"的數(shù)據(jù)。
先來看一下執(zhí)行結(jié)果：
SecondHibernate 執(zhí)行結(jié)果
Hibernate: select this_.id as id0_, this_.name as name0_0_,
this_.age as age0_0_ from user
this_id
id name/age
1 caterpillar/30
3 bush/5
2 momor/26
Hibernate: select this_.id as id0_, this_.name as name0_0_,
this_.age as age0_0_ from user
this_
where this_.name=?
id name/age
1 caterpillar/30
|
Criteria 是對(duì)象導(dǎo)向式的查詢方式，讓不了解SQL 的開發(fā)人員也可以輕易進(jìn)行各項(xiàng)查詢，但Criteria 的API 目前還不是很完善，而Hibernate 鼓勵(lì)的查詢方式，是透過HQL（Hibernate Query Language）來進(jìn)行，直接來看個(gè)實(shí)例：
SecondHibernateUsingHQ.java
package onlyfun.caterpillar;
import org.hibernate.Query;
import org.hibernate.Session;
import org.hibernate.SessionFactory;
import org.hibernate.cfg.Configuration;
import java.util.Iterator;
import java.util.List;
public class SecondHibernateUsingHQ {
public static void main(String[] args) {
Configuration config = new Configuration().configure();
SessionFactory sessionFactory = config.buildSessionFactory();
Session session = sessionFactory.openSession();
// 使用HQL 建立查詢
Query query = session.createQuery("from User");
List users = query.list();
Iterator iterator = users.iterator();
System.out.println("id \t name/age");
while (iterator.hasNext()) {
User user = (User) iterator.next();
System.out.println(user.getId() + " \t " + user.getName() + "/" +
user.getAge());
}
System.out.println();
// 使用HQL 建立查詢
query = session.createQuery("from User user where user.name like ?");
// 設(shè)定查詢參數(shù)
query.setParameter(0, "caterpillar");
users = query.list();
iterator = users.iterator();
System.out.println("id \t name/age");
while (iterator.hasNext()) {
User user = (User) iterator.next();
System.out.println(user.getId() + " \t " + user.getName() + "/" +
user.getAge());
}
session.close();
sessionFactory.close();
}
}
|
執(zhí)行結(jié)果：
SecondHibernateUsingHQ 執(zhí)行結(jié)果
Hibernate: select this_.id as id0_, this_.name as name0_0_,
this_.age as age0_0_ from user
this_id
id name/age
1 caterpillar/30
3 bush/5
2 momor/26
Hibernate: select this_.id as id0_, this_.name as name0_0_,
this_.age as age0_0_ from user
this_
where this_.name=?
id name/age
1 caterpillar/30
|
透過Query 接口，您可以先設(shè)定查詢參數(shù)，之后透過setXXX()等方法，將指定的參數(shù)值填入，而不用每次都撰寫完整的HQL，Query 的setParameter()方法第一個(gè)參數(shù)是指定?出現(xiàn)的位置，從 0 開始，第二個(gè)參數(shù)則是設(shè)定查詢條件。
#p#
二、簡單的Hibernate 程序
這邊以一個(gè)簡單的單機(jī)程序來示范Hibernate的配置與功能，在這個(gè)例子中的一些操作，實(shí)際上會(huì)使用一些自動(dòng)化工具來完成，而不一定親自手動(dòng)操作設(shè)定，這邊完全手動(dòng)的原因，在于讓您可以知道Hibernate實(shí)際上會(huì)作那些動(dòng)作，在進(jìn)行范例之前，請(qǐng)先確定前一個(gè)主題中的相關(guān)jar檔案都已經(jīng)設(shè)定在CLASSPATH中。
我們先作數(shù)據(jù)庫的準(zhǔn)備工作，在MySQL中新增一個(gè)HibernateTest數(shù)據(jù)庫，并建立USER表格：
CREATE TABLE USER (
user_id CHAR(32) NOT NULL PRIMARY KEY,
name VARCHAR(16) NOT NULL,
sex CHAR(1),
age INT
);
|
我們先撰寫一個(gè)純Java對(duì)象，它純綷表示一個(gè)數(shù)據(jù)集合，待會(huì)我們會(huì)將之映像至數(shù)據(jù)庫的表格上，程序如下：
User.java
package onlyfun.caterpillar;
public class User {
private String id;
private String name;
private char sex;
private int age;
public int getAge() {
return age;
}
public String getId() {
return id;
}
public String getName() {
return name;
}
public char getSex() {
return sex;
}
public void setAge(int i) {
age = i;
}
public void setId(String string) {
id = string;
}
public void setName(String string) {
name = string;
}
public void setSex(char c) {
sex = c;
}
}
|
其中id是個(gè)特殊的屬性，Hibernate會(huì)使用它來作為主鍵識(shí)別，我們可以定義主鍵產(chǎn)生的方式，這是在XML映像文件中完成，為了告訴Hibernate對(duì)象如何映像至數(shù)據(jù)庫表格，我們撰寫一個(gè)XML映射文件檔名是User.hbm.xml，如下所示：
User.hbm.xml
<?xml version="1.0"?>
<!DOCTYPE hibernate-mapping
PUBLIC "-//Hibernate/Hibernate Mapping DTD//EN"
"
<hibernate-mapping>
<class name="onlyfun.caterpillar.User" table="USER">
<id name="id" type="string" unsaved-value="null">
<column name="user_id" sql-type="char(32)" />
<generator class="uuid.hex"/>
</id>
<property name="name" type="string" not-null="true">
<column name="name" length="16" not-null="true"/>
</property>
<property name="sex" type="char"/>
<property name="age" type="int"/>
</class>
</hibernate-mapping>
|
這個(gè)XML文件定義了對(duì)象屬性映像至數(shù)據(jù)庫表格的關(guān)系，您可以很簡單的了解對(duì)映的方法，像是User對(duì)象對(duì)應(yīng)至USER表格，其中我們使用 uuid.hex來定義主鍵的產(chǎn)生算法，UUID算法使用IP地址、JVM的啟動(dòng)時(shí)間、系統(tǒng)時(shí)間和一個(gè)計(jì)數(shù)值來產(chǎn)生主鍵。除了使用uuid.hex之外，我們還可以使用其它的方式來產(chǎn)生主鍵，像是increment等，這可以在Hibernate參考手冊(cè)中找到相關(guān)資料。
<property>卷標(biāo)用于定義Java對(duì)象的屬性，而當(dāng)中的<column/>卷標(biāo)用于定義與數(shù)據(jù)庫的對(duì)應(yīng)，如果您是手工建立Java對(duì)象與數(shù)據(jù)庫表格，則在最簡單的情況下，可以只定義<property name="sex"/>這樣的方式，而由Hibernate自動(dòng)判斷Java對(duì)象屬性與數(shù)據(jù)庫表格名稱對(duì)應(yīng)關(guān)系，在< property/>與<column/>標(biāo)簽上的額外設(shè)定（像是not null、sql-type等），則可以用于自動(dòng)產(chǎn)生Java對(duì)象與數(shù)據(jù)庫表格的工具上。
接下來我們定義Hibernate配置文件，主要是進(jìn)行SessionFactory配置，Hibernate可以使用XML或?qū)傩晕募磉M(jìn)行配置，我 們這邊先介紹如何使用XML配置，這也是Hibernate所建議的配置方式，我們的文件名是hibernate.cfg.xml，如下：
hibernate.cfg.xml
<?xml version='1.0' encoding='big5'?>
<!DOCTYPE hibernate-configuration
PUBLIC "-//Hibernate/Hibernate Configuration DTD//EN"
"
<hibernate-configuration>
<session-factory>
<!-- 顯示實(shí)際操作數(shù)據(jù)庫時(shí)的SQL -->
<property name="show_sql">true</property>
<!-- SQL方言，這邊設(shè)定的是MySQL -->
<property name="dialect">net.sf.hibernate.dialect.MySQLDialect</property>
<!-- JDBC驅(qū)動(dòng)程序 -->
<property name="connection.driver_class">com.mysql.jdbc.Driver</property>
<!-- JDBC URL -->
<property name="connection.url">jdbc:mysql://localhost/HibernateTest</property>
<!-- 數(shù)據(jù)庫使用者 -->
<property name="connection.username">caterpillar</property>
<!-- 數(shù)據(jù)庫密碼 -->
<property name="connection.password">123456</property>
<!-- 對(duì)象與數(shù)據(jù)庫表格映像文件 -->
<mapping resource="User.hbm.xml"/>
</session-factory>
</hibernate-configuration>
|
接下來我們撰寫一個(gè)測(cè)試的程序，這個(gè)程序?qū)⒅苯右訨ava程序設(shè)計(jì)人員熟悉的語法方式來操作對(duì)象，而實(shí)際上也直接完成對(duì)數(shù)據(jù)庫的操作，程序?qū)?huì)將一筆數(shù)據(jù)存入表格之中：
HibernateTest.java
import onlyfun.caterpillar.*;
import net.sf.hibernate.*;
import net.sf.hibernate.cfg.*;
public class HibernateTest {
public static void main(String[] args) throws HibernateException {
SessionFactory sessionFactory =
new Configuration().configure().buildSessionFactory();
User user = new User();
user.setName("caterpillar");
user.setSex('M');
user.setAge(28);
Session session = sessionFactory.openSession();
Transaction tx= session.beginTransaction();
session.save(user);
tx.commit();
session.close();
sessionFactory.close();
System.out.println("新增資料OK!請(qǐng)先用MySQL觀看結(jié)果！");
}
}
|
#p#
Configuration代表了Java對(duì)象至數(shù)據(jù)庫的映像設(shè)定，這個(gè)設(shè)定是從我們上面的XML而來，接下來我們從Configuration取得SessionFactory對(duì)象，并由它來開啟一個(gè)Session，它代表對(duì)象與表格的一次會(huì)話操作，而 Transaction則表示一組會(huì)話操作，我們只需要直接操作User對(duì)象，并進(jìn)行Session與Transaction的相關(guān)操作， Hibernate就會(huì)自動(dòng)完成對(duì)數(shù)據(jù)庫的操作。這邊對(duì)程序先只作簡單的介紹，之后再詳加說明。
將所有的.java檔案編譯，并將兩個(gè)XML檔案放置在與HibernateTest相同的目錄中，也就是檔案位置如下：
/
|--HibernateTest.class
|--User.hbm.xml
|--hibernate.cfg.xml
/onlyfun
/caterpillar
|--User.class
|
OK!現(xiàn)在您可以執(zhí)行HibernateTest，程序?qū)?huì)出現(xiàn)以下的訊息：
log4j:WARN No appenders could be found for logger (net.sf.hibernate.cfg.Environment).
log4j:WARN Please initialize the log4j system properly.
Hibernate: insert into USER (name, sex, age, user_id) values (?, ?, ?, ?)
|
新增資料OK!請(qǐng)先用MySQL觀看結(jié)果！
這邊只先進(jìn)行數(shù)據(jù)的存入，要觀看數(shù)據(jù)存入的結(jié)果的話，請(qǐng)進(jìn)入MySQL觀看，以下是數(shù)據(jù)庫存入的結(jié)果：
mysql> SELECT * FROM USER;
+----------------------------------+-------------+------+------+
| user_id | name | sex | age |
+----------------------------------+-------------+------+------+
| 297e3dbdfea6023d00fea60241000001 | caterpillar | M | 28 |
+----------------------------------+-------------+------+------+
1 rows in set (0.00 sec)
|