使用Hibernate的一個(gè)完整例子
配置
1、 下載安裝Tomcat，并且下載Hibernate的運(yùn)行環(huán)境（主要包含一些JAR包）。
2、 把要使用的數(shù)據(jù)庫的JDBC驅(qū)動(dòng)程序拷貝到%TOMCAT_HOME%\common\lib目錄下。筆者使用的是MYSQL，對(duì)應(yīng)的驅(qū)動(dòng)程序的JAR包為mm.mysql-2.0.4-bin.jar。
3、 在Tomcat的Webapps目錄下新建一個(gè)Web應(yīng)用，名字為hibernate。
4、 把Hibernate提供的hibernate2.jar和一些第三方的運(yùn)行庫拷貝到hibernate\WEB\INF\lib目錄下。（這些第三方的運(yùn)行庫包含在下載的Hibernate lib目錄下）
5、 在%TOMCAT_HOME%\conf\server.xml中Web應(yīng)用和數(shù)據(jù)源。在server.xml中加入以下的配置描述。
例程1 配置web應(yīng)用
<Context path="/hibernate" docBase="hibernate" debug="0" reloadable="true" crossContext="true">
<Resource name="jdbc/hibernate" auth="Container" type="javax.sql.DataSource"/>
<ResourceParams name="jdbc/hibernate">
<parameter>
<name>factory</name>
<value>org.apache.commons.dbcp.BasicDataSourceFactory</value>
</parameter>
<parameter>
<name>driverClassName</name>
<value>org.gjt.mm.mysql.Driver</value>
</parameter>
<parameter>
<name>url</name>
<value>jdbc:mysql:///test</value>
</parameter>
<parameter>
<name>username</name>
<value>root</value>
</parameter>
<parameter>
<name>password</name>
<value></value>
</parameter>
<parameter>
<name>maxActive</name>
<value>20</value>
</parameter>
<parameter>
<name>maxIdle</name>
<value>10</value>
</parameter>
<parameter>
<name>maxWait</name>
<value>-1</value>
</parameter>
</ResourceParams>
</Context>
在這里，配置了一個(gè)名為hibernate的Web應(yīng)用，并且配置了一個(gè)數(shù)據(jù)源，數(shù)據(jù)源的JNDI名稱為jdbc/hibernate。您需要根據(jù)情況修改數(shù)據(jù)源的鏈接屬性。
6、 下一步就是書寫Hibernate的配置描述符。可以使用XML的配置描述，也可以使用基于屬性的配置描述。在這里使用基于XML的配置描述。在hibernate\WEB-INF\classes目錄下新建一個(gè)hibernate.cfg.xml文件。然后加入例程2所示的內(nèi)容。
<!DOCTYPE hibernate-configuration
PUBLIC "-//Hibernate/Hibernate Configuration DTD//EN"
"http://hibernate.sourceforge.net/hibernate-configuration-2.0.dtd">
<hibernate-configuration>
<session-factory>
<property name="connection.datasource">java:comp/env/jdbc/hibernate</property>
<property name="show_sql">false</property>
<property name="dialect">net.sf.hibernate.dialect.MySQLDialect</property>
<!-- Mapping files -->
</session-factory>
</hibernate-configuration>
注意connection.datasource屬性必須和server.xml中配置的數(shù)據(jù)源的屬性一樣。如果不是使用MYSQL，那么需要更改dialect屬性。
到現(xiàn)在，配置基本完成，下面我們來開發(fā)一個(gè)最簡單的應(yīng)用。
開發(fā)持久對(duì)象、編寫映射描述
我們使用hibernate來封裝一個(gè)簡單的數(shù)據(jù)表。這個(gè)表的名字為Courses，它有兩個(gè)字段，一個(gè)是ID，它是Courses表的主鍵；另一個(gè)是name，表示Courses的名字。在數(shù)據(jù)庫中使用以下的腳本來創(chuàng)建這個(gè)表：
create table Courses(CourseId varchar(32) not null, name varchar(32), constraint pk_Courses primary key (CourseId) );
接下來的任務(wù)就是為Courses表書寫持久對(duì)象，如例程3所示。
例程3 Courses的持久對(duì)象（Courses.java）
package com.hellking.study.hibernate;
import java.util.Set;
/**
*在hibernate中代表了Course表的類。
*/
public class Course
{
/**每個(gè)屬性和表的一個(gè)字段對(duì)應(yīng)**/
private String id;
private String name;
/**students表示course中的學(xué)生，在后面才會(huì)用到，暫時(shí)不管**/
private Set students;
/**屬性的訪問方法**/
public void setId(String string) {
id = string;
}
public String getId() {
return id;
}
public void setName(String name)
{
this.name=name;
}
public String getName()
{
return this.name;
}
public void setStudents(Set stud)
{
this.students=stud;
}
public Set getStudents()
{
return this.students;
}
}
可以看出，在Course類中也包含了兩個(gè)屬性，id和name，它的屬性和表Courses的字段是一一對(duì)應(yīng)的，并且類型一致。
書寫好了持久對(duì)象，接下來的任務(wù)就是書寫對(duì)象、關(guān)系映射描述。在hibernate\WEB-INF\classes目錄下新建一個(gè)Course.hbm.xml描述文件，內(nèi)容如例程4所示。
例程4 Course.hbm.xml
<?xml version="1.0"?>
<!DOCTYPE hibernate-mapping PUBLIC
"-//Hibernate/Hibernate Mapping DTD 2.0//EN"
"http://hibernate.sourceforge.net/hibernate-mapping-2.0.dtd">
<hibernate-mapping>
<class
name="com.hellking.study.hibernate.Course"
table="Courses"
dynamic-update="false"
>
<id
name="id"
column="CourseId"
type="string"
unsaved-value="any"
>
<generator class="assigned"/>
</id>
<property
name="name"
type="string"
update="true"
insert="true"
column="Name"
/>
</class>
</hibernate-mapping>
在Course.hbm.xml映射文件中，指定了要映射的類和映射的表，并且指定了表的各個(gè)字段和Java對(duì)象中各個(gè)字段的映射關(guān)系，比如Course對(duì)象中的id屬性對(duì)應(yīng)了Courses表的courseId字段。
接下來的任務(wù)就是在hibernate.cfg.xml中指定這個(gè)映射關(guān)系。如下所示：
<session-factory>
…
<!-- Mapping files -->
<mapping resource="Course.hbm.xml"/>
</session-factory>
編寫業(yè)務(wù)邏輯
到此，我們已經(jīng)封裝了一個(gè)名為Courses的表，并且配置完成。接下來的任務(wù)就是在Web應(yīng)用開發(fā)中使用它們，為了演示在Hibernate中對(duì)數(shù)據(jù)庫的不同類型的操作，我們開發(fā)的Web應(yīng)用有以下的功能：
增加一個(gè)Course；
刪除一個(gè)Course；
按照Course的名字進(jìn)行模糊搜索；
查看系統(tǒng)中所有的Course。
雖然我們可以直接在JSP中使用hibernate，但是往往我們不這樣，而是把這些業(yè)務(wù)邏輯封裝在JavaBean中，然后在JSP中通過調(diào)用JavaBean以訪問Hibernate封裝的對(duì)象。
由于訪問通過使用hibernate有一些共性的操作，在這里我們把這些共性的操作封裝在一個(gè)專門的類中，這樣其它的類可以繼承它，如例程5所示。
例程5 HibernateBase.java
package com.hellking.study.hibernate;
import net.sf.hibernate.*;
import net.sf.hibernate.cfg.*;
import java.util.*;
import java.io.IOException;
import java.io.PrintWriter;
public abstract class HibernateBase
{
protected SessionFactory sessionFactory;//會(huì)話工廠，用于創(chuàng)建會(huì)話
protected Session session;//hibernate會(huì)話
protected Transaction transaction; //hiberante事務(wù)
public HibernateBase()throws HibernateException
{
this.initHibernate();
}
// 幫助方法
protected void initHibernate()
throws HibernateException {
// 裝載配置，構(gòu)造SessionFactory對(duì)象
sessionFactory = new Configuration().configure().buildSessionFactory();
}
/**
*開始一個(gè)hibernate事務(wù)
*/
protected void beginTransaction()
throws HibernateException {
session = sessionFactory.openSession();
transaction = session.beginTransaction();
}
/**
*結(jié)束一個(gè)hibernate事務(wù)。
*/
protected void endTransaction(boolean commit)
throws HibernateException {
if (commit) {
transaction.commit();
} else {
//如果是只讀的操作，不需要commit這個(gè)事務(wù)。
transaction.rollback();
}
session.close();
}
}
下面編寫業(yè)務(wù)邏輯類，新建一個(gè)名為CourseBean的JavaBean，并且CourseBean繼承HibernateBase類，代碼如例程6所示。
例程6 CourseBean.java
package com.hellking.study.hibernate;
import net.sf.hibernate.*;
import net.sf.hibernate.cfg.*;
import java.util.*;
/**
*和course相關(guān)的業(yè)務(wù)邏輯
*/
public class CourseBean extends HibernateBase
{
public CourseBean()throws HibernateException
{
super();
}
/**
*增加一個(gè)Course
*/
public void addCourse(Course st)throws HibernateException
{
beginTransaction();
session.save(st);
endTransaction(true);
}
/**
*查詢系統(tǒng)中所有的Course，返回的是包含有Course持久對(duì)象的Iterator。
*/
public Iterator getAllCourses()throws HibernateException
{
String queryString = "select courses from Course as courses";
beginTransaction();
Query query = session.createQuery(queryString);
Iterator it= query.iterate();
return it;
}
/**
*刪除給定ID的course
*/
public void deleteCourse(String id)throws HibernateException
{
beginTransaction();
Course course=(Course)session.load(Course.class,id);
session.delete(course);
endTransaction(true);
}
/**
*按course的名字進(jìn)行模糊查找，返回的是包含有Course持久對(duì)象的Iterator。
*/
public Iterator getSomeCourse(String name)throws HibernateException
{
String queryString = "select c from Course as c where c.name like :name" ;
beginTransaction();
Query query = session.createQuery(queryString);
query.setString("name", "%"+name+"%");
Iterator it= query.iterate();
return it;
}
}
在CourseBean封裝了4個(gè)業(yè)務(wù)方法，你可以根據(jù)情況增加其它的業(yè)務(wù)方法。在CourseBean中，通過Hibernate來操作潛在的數(shù)據(jù)庫資源。
要保存Course數(shù)據(jù)到數(shù)據(jù)庫，可以通過：
session.save(Course);
方法來保存，它相當(dāng)于使用在JDBC中執(zhí)行以下語句：
Connection con=…
Statement stmt=con.createStatement();
stmt.executeUpdate("insert into courses values('"+course.getId(),+"','"+course.getName()+"')");
con.close();
可以看出，通過使用Hibernate，可以大大減少數(shù)據(jù)訪問的復(fù)雜度。
在JSP中調(diào)用業(yè)務(wù)邏輯
添加數(shù)據(jù)
CourseBean這個(gè)業(yè)務(wù)對(duì)象封裝了和Hibernate的交互關(guān)系，從而使JSP和Hibernate關(guān)系的解藕。我們來看測試主頁面的部分代碼，如例程7所示。
例程7 測試Hibernate開發(fā)的應(yīng)用（course.jsp）
<%@ page import="java.sql.*,java.util.*" errorPage="error.jsp"%>
<jsp:useBean id="course" class="com.hellking.study.hibernate.Course" scope="page">
<jsp:setProperty name="course" property="*"/>
</jsp:useBean>
<jsp:useBean id="courseBusiness" class="com.hellking.study.hibernate.CourseBean" scope="page"/>
<html><body><center>
<%
try
{
if(course.getId().equals(null)||course.getId().equals(""));
else courseBusiness.addCourse(course);
%>
成功添加了Course：<br>
name：<%=course.getName()%>
Id:<%=course.getId()%>
<%
}
catch(Exception e)
{
}
%>
<hr>
<br>::增加一個(gè)course::<br>
<form action="course.jsp" method="get" name="add">
id:<input type=text name="id"><br>
name:<input type=text name="name"><br>
<input type=submit value="submit"><br>
</form>
<hr>
::按名字模糊查找::<br>
<form action="queryCourse.jsp" method="get" name="queryByName">
name:<input type=text name="name"><br>
<input type=submit value="query"><br>
</form>
<hr>
::刪除一個(gè)Course::<br>
<form action="deleteCourse.jsp" method="get" name="queryByName">
id:<input type=text name="id"><br>
<input type=submit value="delete"><br>
</form>
<hr>
<a href=viewAll.jsp>::查看所有Course::<a>
</body>
</html>
首先通過一個(gè)值對(duì)象Course（這個(gè)類正好是Hibernate使用的持久對(duì)象，這里作為值對(duì)象來傳遞數(shù)據(jù)）接收獲得的參數(shù)，然后CourseBean的addCourse(Course)方法把數(shù)據(jù)保存到數(shù)據(jù)庫。可以看出，通過使用Hibernate，把數(shù)據(jù)從表單中添加到數(shù)據(jù)庫非常簡單。
查詢
下面來看模糊查找的JSP代碼，如例程8所示。
例程8 按名字模糊查找Course
<%@ page import="java.sql.*,java.util.*,com.hellking.study.hibernate.Course" errorPage="error.jsp"%>
<jsp:useBean id="courseBusiness" class="com.hellking.study.hibernate.CourseBean" scope="page"/>
…
<% try
{
Iterator it=courseBusiness.getSomeCourse((String)request.getParameter("name"));
while(it.hasNext())
{
Course temp=(Course)it.next();
out.println("<tr><td>"+temp.getId()+"</td>");
out.println("<td>"+temp.getName()+"</td></tr>");
}
}
catch(Exception e)
{
out.println(e.getMessage());
}
%>
….
它實(shí)際上調(diào)用的是CourseBean的Iterator getSomeCourse(String name)方法。我們來回顧一下這個(gè)方法中的代碼：
/**
*按course的名字進(jìn)行模糊查找
*/
public Iterator getSomeCourse(String name)throws HibernateException
{
String queryString = "select c from Course as c where c.name like :name" ;
beginTransaction();
Query query = session.createQuery(queryString);
query.setString("name", "%"+name+"%");
Iterator it= query.iterate();
return it;
}
在查詢前，首先調(diào)用beginTransaction方法啟動(dòng)新的Hibernate事務(wù)，然后創(chuàng)建一個(gè)Query對(duì)象，在創(chuàng)建這個(gè)對(duì)象時(shí)，同時(shí)指定查詢的語句。
注意，在查詢語句：
select c from Course as c where c.name like :name"
中，它雖然和普通的SQL語句相似，但是不同，在數(shù)據(jù)庫中，使用的表的名字是Courses，而在這個(gè)查詢語句中使用的是Course，它和持久對(duì)象的名字一致，也就是說，這個(gè)查詢的概念是查詢持久對(duì)象，而不是數(shù)據(jù)庫的記錄。
創(chuàng)建了查詢對(duì)象Query后，需要設(shè)置查詢的參數(shù)，它和在JDBC中PreparedStatement對(duì)象中設(shè)置參數(shù)的方法相似。通過"Iterator it= query.iterate()"語句來執(zhí)行查詢，并且返回一個(gè)Iterator對(duì)象。在這里使用了Hibernate提供的查詢機(jī)制，一般的JDBC查詢返回的是ResultSet對(duì)象，而這里返回的是包含了CourseBean對(duì)象的Iterator。
要查詢系統(tǒng)中所有的Course，也同樣非常簡單，可以通過例程9所示的代碼實(shí)現(xiàn)。
例程9 查詢數(shù)據(jù)庫中所有的Course
…
<jsp:useBean id="courseBusiness" class="com.hellking.study.hibernate.CourseBean" scope="page"/>
…
<% try
{
Iterator it=courseBusiness.getAllCourses();
while(it.hasNext())
{
Course temp=(Course)it.next();
out.println("<tr><td>"+temp.getId()+"</td>");
out.println("<td>"+temp.getName()+"</td></tr>");
}
}
catch(Exception e)
{
out.println(e.getMessage());
}
%>
…
實(shí)際上調(diào)用的是CourseBean的getAllCourses方法，它和getSomeCourse方法機(jī)制一樣，就不再介紹了。
刪除數(shù)據(jù)
在JSP中，使用以下的代碼來執(zhí)行刪除操作。
例程10 刪除數(shù)據(jù)庫中Courses表的記錄
<jsp:useBean id="courseBusiness" class="com.hellking.study.hibernate.CourseBean" scope="page"/>
…
刪除id為：<%=request.getParameter("id")%>的course：:::<br>
<% try
{
courseBusiness.deleteCourse(request.getParameter("id"));
out.println("刪除成功");
}
catch(Exception e)
{
out.println("不存在這個(gè)記錄");
}
%>
我們來看CourseBean中執(zhí)行刪除操作的具體代碼：
/**
*刪除給定ID的course
*/
public void deleteCourse(String id)throws HibernateException
{
beginTransaction();
Course course=(Course)session.load(Course.class,id);
session.delete(course);
endTransaction(true);
}
在這個(gè)方法中，首先開始一個(gè)事務(wù)，然后通過session.load(Course.class,id)方法來裝載指定ID的持久對(duì)象，接下來通過"session.delete(course)"來刪除已經(jīng)裝載的course，并且結(jié)束Hibernate事務(wù)。
總結(jié)
下面總結(jié)一下使用Hibernate的開發(fā)過程：
1、 配置Hibernate（一次即可）；
2、 確定數(shù)據(jù)表；
3、 創(chuàng)建持久對(duì)象；
4、 編寫對(duì)象和數(shù)據(jù)表的映射描述；
5、 編寫和業(yè)務(wù)邏輯。
實(shí)際上，上面的過程和使用EJB沒有什么區(qū)別：在使用EJB時(shí)，首先當(dāng)然也是配置環(huán)境，初始化數(shù)據(jù)表；然后創(chuàng)建實(shí)體Bean（對(duì)象于Hibernate的持久對(duì)象）；接下來編寫部署描述符（ejb-jar.xml，廠商專有的部署描述），在這些部署描述符里，指定了EJB和數(shù)據(jù)表的映射關(guān)系，如果多個(gè)實(shí)體Bean存在關(guān)聯(lián)關(guān)系，需要描述它們之間的關(guān)系，這些描述對(duì)應(yīng)于Hibernate中持久對(duì)象的描述，如Course.hbm.xml；往往我們并不在應(yīng)用程序中直接操作實(shí)體Bean，而是通過業(yè)務(wù)對(duì)象（如會(huì)話Bean）來操作，這里的會(huì)話Bean可以簡單的和Hibernate中執(zhí)行業(yè)務(wù)邏輯的JavaBean對(duì)應(yīng)。這里只是簡單的類比，不是絕對(duì)的，比如我們同樣可以在會(huì)話Bean中訪問Hibernate持久對(duì)象，也就是說使用Hibernate，同樣可以把業(yè)務(wù)邏輯放在會(huì)話Bean中。
通過本文的學(xué)習(xí)，相信讀者對(duì)Hibernate已經(jīng)有了初步的認(rèn)識(shí)，并且能夠使用Hibernate開發(fā)簡單的應(yīng)用。在下一篇中，我們將學(xué)習(xí)怎么使用Hibernate來為復(fù)雜的數(shù)據(jù)表進(jìn)行映射，并且維護(hù)它們之間的關(guān)系。
參考資料
http://www.apache.org 下載Tomcat。
Hibernate的官方網(wǎng)站，http://hibernate.bluemars.net/ ，包含了Hibernate最新資料。
Hibernate中文論壇，hibernate.fankai.com包含了Hibernate較多的參考資料。
包含了Hibernate技術(shù)討論網(wǎng)站，www.jdon.com，
于Hibernate、JDO、CMP等技術(shù)的熱烈討論1：
http://www.jdon.com/jive/thread.jsp?forum=16&thread=6062&start=0&msRange=15
于Hibernate、JDO、CMP等技術(shù)的熱烈討論2：
http://www.theserverside.com/discussion/thread.jsp?thread_id=19732
Hibernate2 Reference Documentation，可以從Hibernate官方網(wǎng)站獲得，非常好的參考資料。
Hibernate In Action，一本非常專業(yè)的Hibernate參考書，由Hibernate項(xiàng)目主要開發(fā)人員Gavin King 等著，Manning出版社出版。您可以從 http://www.theserverside.com 獲得本書的部分章節(jié)。