IBM®
跳转到主要内容
    中国 [选择]    使用条款
 
 
Select a scope:Search for:    
    首页    产品    服务与解决方案     支持与下载    个性化服务    
跳转到主要内容

developerWorks 中国  >  Open source | Java technology  >

在 Apache Geronimo 上创建 Hibernate 应用实例

developerWorks
文档选项

未显示需要 JavaScript 的文档选项

样例代码


赵 雄伟 (zhaoxw@cn.ibm.com), 软件工程师, IBM

2008 年 1 月 28 日

Apache Geronimo 作为一个开源 J2EE 应用服务器,对很多技术和框架提供了支持。本文将以实例探讨如何在Apache Geronimo 上创建 Hibernate 应用,以及如何将 Hibernate 与 Apache Derby 集成。读者定位于具有 Web 应用开发经验的开发人员,对 Hibernate, Apache Geronimo 和 Apache Derby 有所了解。

引言

Apache Geronimo 以其灵活性和敏捷性成为目前最受欢迎的开源应用服务器之一。Geronimo 集成了许多技术和概念,Apache Tomcat、Apache Derby、Jetty和Apache Axis 等;并对很多框架都提供支持,如 Spring、Tuscany、Hibernate 等。您可以通过 developerworks 的 Apache Geronimo 项目资源中心来更多的了解 Apache Geronimo。

Hibernate 是一个对象关系映射和持久性框架,它允许您用 XML 配置文件把普通 Java 对象映射到关系数据库表。对象和数据的映射使开发人员不需要关心数据库,通过操作数据对象来实现对数据库的操作。您可以在Hibernate的官方网站上查看文档,并下载最新版本 Hibernate。

但是如何将 Java 对象通过 Hibernate 映射到 Geronimo 的内置数据库 Derby 上呢?又如何将这样一个应用系统在 Geronimo 服务器上运行起来呢?下面将通过一个实例做具体介绍。

下面的实例主要实现对客户信息的增删改查。将数据存储在 Apache Derby 数据库上,然后配置 Hibernate 来实现 Java 对象和数据库表的映射,最后实现业务逻辑并将应用部署到 Apache Geronimo 服务器上。您可以下载实例代码,代码可以直接在 Geronimo 上运行,对照代码看这篇文章更直观。





回页首


在 Derby 上创建数据库和表

我们首先来创建数据表。Apache Derby 是一个与平台无关的开源数据库,它默认内置在 Apache Geronimo 之中。尽管 Derby 轻量、简单,但其特性丰富,可以支持关系数据库中的所有企业级的特性,包括崩溃恢复、事务回滚和提交、行/表级锁、视图、主键/外键约束、触发器、子查询表达式等。您可以通过 developerworks 的Apache Derby 资源中心来更多的了解 Apache Derby。

管理 Derby 数据库

由于 Derby 只是另外一个 Java 类库,因此它没有自己的管理客户端。我们可以使用任意一个喜欢的DB客户端如 SQL Explorer 等来管理 Derby。对于内置在 Geronimo 中的Derby,我们还可以通过Geronimo的控制台来对 Derby 进行管理。

用 Geronimo 控制台管理Derby数据库,运行 <Geronimo home>/bin/startup.bat 启动Geronimo,然后在地址栏输入http://localhost:8080/console/portal/welcome 进入Geronimo控制台,默认用户名/密码为 system/manager。在控制台上可以选择数据库运行任意 SQL,如图1所示。


图1. 在 Geronimo 控制台运行 SQL

创建数据库 SAMPLE

可以在Geronimo控制台上直接创建一个数据库SAMPLE。

创建数据表 CUSTOMER

运行清单1中的DDL来创建 CUSTOMER 数据表,将 ID 设置为自动增长来作为 CUSTOMER表的主键。


清单1. Create table 语句
                
CREATE TABLE CUSTOMER
(
    ID              INTEGER NOT NULL PRIMARY KEY GENERATED ALWAYS AS IDENTITY 
                       (START WITH 1, INCREMENT BY 1),
    CUSTNAME               VARCHAR(35) NOT NULL,
    AGE                     INTEGER,
    EMAIL                   VARCHAR(35) ,
    ADDRESS                 VARCHAR(35) ,
    CITY                    VARCHAR(35) ,
    COUNTRY                 VARCHAR(3)
)





回页首


配置 Hibernate 的配置文件

配置数据库 Derby 的连接

Derby 提供两种部署和连接的方式:

  • 嵌入式模式(embedded mode):Derby 只处理来自与应用程序使用的 JVM 相同的 JVM 的请求。在采用嵌入式模式来使用 Derby 时,应用程序会在启动和关闭时分别自动启动或停止关系引擎。使用derby.jar 包中JDBC 驱动程序org.apache.derby.jdbc.EmbeddedDriver。
  • 网络服务器模式(network server mode):Derby 会处理来自不同 JVM 的应用程序请求。这时可以使用其他语言如 Perl、PHP、Python 或 C 等来连接,同时也支持网络连接。使用derbyclient.jar 包中JDBC 驱动程序 org.apache.derby.jdbc.ClientDriver。

在本实例中使用嵌入式模式来连接 Derby。如清单2所示,主要配置链接Derby的信息。其中(1)要将connection的URL设置为jdbc:derby:<Geronimo home>/var/derby/<数据库名称>;create=true,create=true 属性说明如果该数据库不存在时,就创建该数据库。


清单2. hibernate.cfg.xml
                
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE hibernate-configuration
    PUBLIC "-//Hibernate/Hibernate Configuration DTD//EN"
    "http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd">

<hibernate-configuration>
<session-factory>
<property name="hibernate.connection.url">
     jdbc:derby:D:/geronimo-1.1/var/derby/SAMPLE;create=true</property> 
         |(1)
<property name="hibernate.connection.driver_class">
        org.apache.derby.jdbc.EmbeddedDriver</property>
<property name="hibernate.connection.username">APP</property>
<property name="hibernate.connection.password"></property>
<property name="dialect">org.hibernate.dialect.DerbyDialect</property>
<property name="myeclipse.connection.profile">MyEclipse Derby</property>
<property name="connection.password">myeclipse</property>
<property name="connection.driver_class">org.apache.derby.jdbc.EmbeddedDriver</property>
<property name="current_session_context_class">thread</property>
</session-factory>
</hibernate-configuration>





回页首


创建持久化对象

按照 CUSTOMER 数据表的字段,来创建持久化对象 Customer.java。如清单1中的字段与清单3中的属性名和类型一一对应。


清单3. 持久化对象 Customer.java
                
public class Customer implements Serializable {
private static final long serialVersionUID = 1L;
private int id;
private String custName;
private int age;
private String email;
private String address;
private String city;
private String country;

public int getId() {
return id;
}
public void setId(int id) {
this.id = id;
}
    …get…
    …set…
}





回页首


编写对象和数据表的映射描述

然后要将对象和数据表的映射关系用描述文件的方式提供给Hibernate。如清单4所示。其中如(1)<generator> 子元素是一个 Java 类的名字,用来为该持久化类的实例生成唯一的标识,我们已经在创建数据表的时候将ID设置为自动增长字段,因此我们可以将 class 设置为identity,这样当创建记录时数据库就会自动为这个地段赋值。

其他属性依照name=对象属性,column=数据表列名的映射编写这一映射描述文件。


清单4. 对象和数据表的映射描述 Customer.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.ibm.sample.bean">
    <class name="Customer" table="CUSTOMER" lazy="true">
        <comment>customer table</comment>       
       <id name="id" column="ID" type="int">
            <generator class="identity" />           |(1)
        </id>         
        <property name="custName" column="CUSTNAME" type="string" 
        update="true" insert="true"/>
        <property name="age" column="AGE" type="int" 
        update="true" insert="true"/>
        <property name="email" column="EMAIL" type="string" 
        update="true" insert="true"/>
        <property name="address" column="ADDRESS" type="string" 
        update="true" insert="true"/>
        <property name="city" column="CITY" type="string" 
        update="true" insert="true"/>
        <property name="country" column="COUNTRY" type="string" 
        update="true" insert="true"/>
    </class>    
</hibernate-mapping>

最后要将映射描述文件在 hibernate.cfg.xml 中进行配置,如清单5所示。


清单5. 配置映射描述到 hibernate.cfg.xml
                
<hibernate-configuration>
<session-factory>
          …………
<mapping resource="com/ibm/sample/bean/Customer.hbm.xml"/>
</session-factory>
</hibernate-configuration>





回页首


实现业务逻辑

本实例主要实现对客户信息的增删改查,所以业务逻辑方法也主要是这四种,这一般也是对数据最多的操作。

在通过 Hibernate 这一持久层访问数据时,首先要拿到相应配置文件(hibernate.cfg.xml)的SessionFactory,然后打开这个SessionFactory的Session,我们进行的所有数据操作都会在这个Session中完成,在操作完成后关闭此Session。

创建客户信息

将客户的各个信息设置到 Customer 对象中去,然后调用 Session 的 save 方法,将对象保存到数据库中去。


清单6. 创建客户信息
                
public void createCustomer(String custNanme, String email, int age,
String address, String city, String country) {
    Session sess = HibernateUtil.currentSession();
    Transaction trans = sess.beginTransaction();
    Customer customer = new Customer();
    customer.setCustName(custNanme);
    customer.setEmail(email);
    customer.setAge(age);
    customer.setAddress(address);
    customer.setCity(city);
    customer.setCountry(country);
    sess.save(customer);
    trans.commit();
    HibernateUtil.closeSession();
}

删除客户信息

要删除一条记录首先要先拿到这条记录的实例,我们用主键ID来取得customer对象,然后调用Session的delete 方法,将数据库中的记录删除。


清单7. 删除客户信息
                
public void deleteCustomer(int id) {
    Session sess = HibernateUtil.currentSession();
    Transaction trans = sess.beginTransaction();
    Customer customer = (Customer) sess.load(Customer.class, new Integer(id));
    sess.delete(customer);
    trans.commit();
    HibernateUtil.closeSession();
}

修改客户信息

修改一条记录首先是拿到记录的实例,然后更改实例的属性值,再将修改后的信息保存到数据库中。我们调用 Session 的 update 方法来修改信息。


清单8. 修改客户信息
                
public void updateCustomer(int id, String custName, 
          String email, int age, String address, String city, String country) {
    Session sess = HibernateUtil.currentSession();
    Transaction trans = sess.beginTransaction();
    Customer customer = (Customer) sess.load(Customer.class, new Integer(id));
    customer.setCustName(custName);
    customer.setEmail(email);
    customer.setAge(age);
    customer.setAddress(address);
    customer.setCity(city);
    customer.setCountry(country);
    sess.update(customer);
    trans.commit();
    HibernateUtil.closeSession();
}

查询客户信息

在查询客户信息的方法中,主要应用 HibernateSQL 来实现按不同的查询条件查询。如清单9所示,创建了三个查询方法,返回所有客户信息、按客户ID查询和按客户名字查询。其实上面的创建和删除的操作也可以通过 HibernateSQL 来实现,不过上面的方法更简单。


清单9. 查询客户信息
                
public List getAllCustomers() {
    String queryString = "select a from Customer as a";
    Session sess = HibernateUtil.currentSession();
    Transaction trans = sess.beginTransaction();
    Query query = sess.createQuery(queryString);
    List list = query.list();
    trans.commit();
    HibernateUtil.closeSession();
    return list;
}

public Customer getCustomerByID(int id) {
    String queryString = "select c from Customer as c where c.id = :cid";
    Session sess = HibernateUtil.currentSession();
    Transaction trans = sess.beginTransaction();
    Query query = sess.createQuery(queryString);
    query.setParameter("cid", new Integer(id));
    Customer customer = (Customer) sess.load(Customer.class, new Integer(id));
    trans.commit();
    HibernateUtil.closeSession();
    return customer;
}

public List getCustomerByName(String name) {
    String queryString = "select c from Customer as c where c.custName like :name";
    Session sess = HibernateUtil.currentSession();
    Transaction trans = sess.beginTransaction();
    Query query = sess.createQuery(queryString);
    query.setParameter("name", "%"+name+"%");
    List list = query.list();
    trans.commit();
    HibernateUtil.closeSession();
    return list;
}

创建 Web 页面调用业务方法

最后我们可以 Web 页面来调用上面所创建的业务方法,从而实现在页面对数据进行处理。为了更好更简单的显示数据,在JSP中应用的 DisplayTag 来组织数据显示,您可以在DisplayTag Homepage 得到更多关于 DisplayTag 的详细信息。关于这一部分将不做详细介绍。





回页首


部署到 Geronimo

这样我们的实例已经创建完成了,最后要将它部署在 Geronimo 服务器上。首先将应用导出成war 文件。然后启动 Geronimo,进入控制台,对 war 文件部署实例。如图2所示。


图2. 将应用部署到 Geronimo

部署成功以后,通过 http://localhost:8080/HibernateGeronimo/ 访问这个实例,如图3所示。


图3. 运行实例





回页首


结束语

通过本文,我们向您介绍了如何管理 Apache Derby 数据库;如何集成 Hibernate 和 Apache Derby;如何创建 Hibernate 应用,以及如何将 Web 应用部署到 Geronimo 服务器。

在编写本文实例的过程中,充分体会到 Derby 是一个既简单又复杂的数据库,Derby 的安装和使用都很简单,但是它的功能却很丰富、复杂。特别是它内置在 Geronimo 中,通过页面控制台就能管理 Derby 数据库,这真是一件令人兴奋的事情。

Geronimo 是一个特性非常丰富的轻量级 J2EE 服务器,从控制台我们就能看到它对很多技术和框架提供支持。但是在本文实例中,没有应用到太多特性,希望在以后能与大家分享。






回页首


下载

描述名字大小下载方法
本文实例HibernateGeronimo.war6555KBHTTP
关于下载方法的信息


参考资料



关于作者

赵雄伟是一位IBM软件工程师,工作在IBM中国软件开发实验室企业应用开发部门,在 Java开发和Web开发方面有丰富的经验,现在正从事企业电子商务应用的开发和支持工作,您可以通过zhaoxw@cn.ibm.com与她联系。




对本文的评价

太差! (1)
需提高 (2)
一般;尚可 (3)
好文章 (4)
真棒!(5)

建议?




回页首


IBM 公司保留在 developerWorks 网站上发表的内容的著作权。未经IBM公司或原始作者的书面明确许可,请勿转载。如果您希望转载,请通过 提交转载请求表单 联系我们的编辑团队。
    关于 IBM 隐私条约 联系 IBM 使用条款