UML软件工程组织

优秀的对象角色建模解决方案-Torque
作者:◇ 曲俊生 本文选自:开放系统世界—赛迪网 2003年04月11日

目前对于J2EE应用中的Persistence Layer的解决方案很多,其中,最近从Apache Turbine中剥离处理的Torque是一个优秀的ORM(Object Relational Mapping,对象角色建模) 解决方案。

主流的Persistence Layer解决方案

随着基于J2EE应用的日益增加,出现了很多Persistence Layer的解决方案。目前主要的解决方案有以下几种:

◆ 自己编写基于JDBC API的解决方案;

◆ 采用ObjectRational Mapping(ORM)工具或者是采用面向对象的数据库(ODBMS);

◆ J2EE/Entity Bean CMP (container-managed persistence);

◆ JDO。

JDBC

在很多情况下,尤其是没有采用良好的Persistence Layer解决方案的项目中,开发人员需要自己手动编写SQL语句,同时还要考虑事务处理等问题。从而使得SQL语句散落在代码中,可维护性很差。同时,由于每个项目都要重新编写Persistence 相关的代码,所以代码可重用性差。另外要求开发人员对于SQL语法必须非常熟悉,否则调试也比较困难。

使用JDBC的解决方案,数据必须存储在关系型数据库中。

ORM或者ODBMS

为了将开发人员从SQL语句中解脱出来,产生了很多ORM的工具。这些工具都比较简单,并且提供了API支持。

由于ORM工具比较多,它们采用的技术标准都不尽相同,而且没有统一的接口,因此,它们在为开发人员提供方便的同时,也增加了一定的束缚。ORM技术是比较成熟的,而且已经有很多产品了。

而ODBMS是近几年发展起来的,并不十分成熟,而且也没有得到广泛的应用。目前,众多ODBMS厂商正在关注JDO标准并加以实施。它可能在不久的将可以得到一定的推广。

使用ORM或者ODBMS的解决方案,数据也必须存储在关系或者面向对象数据库中。

EJB CMP

在J2EE的规范中,为EJB定义了两种Persistence的解决方案:一种是BMP,另一种是CMP。其中CMP不需要将SQL语句加入到代码中。

目前,在采用J2EE的应用中,EJB CMP方式得到了广泛应用。更加引人注意的是,随着EJB规范的发展,CMP也包含了一些高级关系的内容。但是,CMP的使用比较复杂,对很多开发人员来说比较难以掌握。而且,不是在所有的情况下都适合在系统中采用EJB。

EJB提供了除了关系型数据库以外,更多的存储支持。

JDO

目前,有两种类型的JDO实现,一种是Sun的JDO,另一种是Castor JDO,这两者并不兼容。

Sun JDO是Sun Java Community Process给出的规范和参照实现。尽管JDO还有些不成熟,但它很有发展前景,而且填补了数据库编程领域的一大空白。对Java开发人员而言,JDO为对象持久性提供了第一个标准化的、完全面向对象的方法。与此领域中的其它技术相比,JDO的优点是使用起来十分简单,而且对原始的Java源代码打乱程度最小。同时,Sun JDO对数据存储类型是透明的。

而Castor JDO是一个开源项目,从1999年开始开发。在开源的JDO项目中,它提供的功能是最强大的。尽管Castor JDO开发的比较早,但是,随着Sun JDO的日益成熟,它的优势越来越小。同时,Castor JDO只提供对RDMS的支持。

从上面的分析我们可以看到,由于目前绝大多数应用系统的数据都是存储在RDMS中,而且JDO目前还不十分完善,因此,在项目中还是应该采用成熟的ORM工具。

Torque

Torque是一种ORM的工具,它最早是Apache Jakarta Turbine项目的一部分,现在已经从Turbine中剥离出来,可以独立使用。目前,它的版本是3.0。

Torque的主要特性

Torque主要包含两部分:一部分是Generator,它可以产生应用需要的所有数据库资源,包括sql和java文件;另外,Torque还提供了一个运行环境来运行产生的类。下面主要讨论Torque 的Generator。

1. 三个核心文件

要利用Torque的Generator,必须配置好以下三个文件(Torque的安装路径为$Torque_home):

◆ $Torque_home/build.properties 存储数据库系统的属性,主要有项目名称、数据库类型、数据库链接URL、Driver、用户名、密码及主机名等。Torque利用该文件的属性,建立与数据库系统的连接。

◆ $Torque_home/schema/project-schema.xml、id-table-schema.xml 其中,project-schema.xml 存储表结构信息;而id-table-schema.xml由Torque的IDBroker服务调用。

◆ $Torque_home/Torque.properties 存储应用执行时,由Torque生成的对象模型代码使用的属性值。在生成数据库系统资源的时候不需要这个文件。

2. 核心任务

利用Torque提供的Generator,可以完成下面的主要任务:

◆ sql 解析$Torque_home/schema/*.xml,生成对应的$Torque_home/src/sql/*.sql文件;

◆ doc 解析$Torque_home/schema/*.xml,生成对应的$Torque_home/src/sql/*.html文件,描述数据库结构;

◆ create-db 生成不同平台上产生数据库系统的脚本;

◆ insert-sql 执行$Torque_home/schema/*-schema.sql文件到指定数据库;

◆ sql2xml 解析$Torque_home/schema/schema.sql文件,产生Torque对应的数据库文件$Torque_home/schema/schema.xml;

◆ id-table-init-sql 根据$Torque_home/schema/id-table-schema.xml文件产生id表的初始化脚本文件;

上述任务需要ANT的支持,运行命令为$Torque_home/ant-f build-torque.xml $taskname。

3 .Peer

Peer是Torque使用的ORM工具。它比其它的工具(例如Castor、Osage等)的层次要低。开发人员需要手工编写一些代码,但是这从一定意义上增加了灵活性。

Peer利用Torque数据库Adaptor类来建立与数据库的连接。因为它支持主流的数据库系统,所以,开发人员一般情况下不需要为数据库系统编写Adaptor。

在建立了项目数据库系统的Schema文件后,运行“ant -f build-torque.xml”。Torque为Schema 中的每个表的对象模型生成四个类,例如开发人员在project-schema.xml 中定义了Author表,则Torque生成的四个类为Author、AuthorPeer、 BaseAuthor、BaseAuthorPeer等。其中Author和AuthorPeer分别是BaseAuthor和BaseAuthorPeer 的子类。这两个基类(BaseAuthor、BaseAuthorPeer)包含了Torque的生成逻辑,在开发中不应该修改。因为Torque会在再次生成对象模型时覆盖这些文件,所以系统中的业务逻辑应该放在Author和AuthorPeer类中。

在Torque中,AuthorPeer和BaseAuthorPeer称为对等类(Peer Classes),而Author和BaseAuthor称为数据对象(Data Objects)。对等类和数据对象之间的区别是:“对等类”封装数据表信息,并提供静态方法对表进行增加、删除、修改记录的操作;“数据对象”封装表中的记录信息,并对每个字段提供getters/mutators方法。

4. Criteria

Criteria是一对SQL查询标准的抽象对象,开发人员利用它来封装特定的SQL语句。Criteria实际上是SQL语句中域名和值之间的映射,默认的Comparator是等于(=)。同时,它还提供基本的Comparator,以及Join、Order by、Distinct等。更多的方法及属性,请查看org.apache.torque.util.

Criteria。

Criteria提供了一般意义上的SQL功能,如果仍然不能满足开发的需要,开发人员仍然可以手写SQL语句。

Torque在J2EE中的应用

在Apache Jakarta的项目中,有很多Web 应用构架,其中Struts、Cocoon及Turbine是比较著名的几个。

Torque作为数据库抽象的工具,虽然是从Turbine中剥离出来的,但是它可以与其它的构架很好地结合,成为Persistence层的优秀解决方案。

应用步骤

在J2EE应用,使用Torque的步骤如下:

1. 系统分析和设计,直至Business Object;

2. 按照Business Object模型,形成数据库脚本文件database.sql;

3. 编写$Torque_home/build.properties;

4.编写$Torque_home/schema/project-schema.xml及$Torque_home/schema/id-table-schema.xml,或者将database.sql拷贝到$Torque_home/schema/schema.sql, 在$Torque_home下运行ANT生成对应的schema.xml文件运行语句为:ant -f build-torque.xml sql2xml;

5. 编写$Torque_home/Torque.properties;

6. 调用Torque生成对象模型,创建数据库和相关表(利用ANT):

◆ ant -f build-torque.xml

◆ ant -f build-torque.xml create-db

◆ ant -f build-torque.xml id-table-init-sql

◆ ant -f build-torque.xml insert-sql

7. 修改*.java和*Peer.java,加入业务逻辑处理;

8. 开发J2EE应用。

注意问题

Torque在文档中提供了一个教程,可以帮助开发人员了解Torque的用法,也提供了一个完整的示例。但是,在使用Torque的J2EE开发中,还需要注意以下问题:

◆ Torque的初始化只能进行一次:Torque.init(“Torque.properties”)。如果是采用Central Controller,则在Servlet的init方法中进行初始化比较合适。

◆ 需要配置运行时的数据库连接,配置信息在Torque.properties中。下面是采用Torque的old pool、Jdbc2Pool、JNDI及ConnectionPoolDataSource等各种形式的配置文件:

## Using torque's old pool
#torque.dsfactory.MMCycle.factory=org.apache.
torque.dsfactory.TorqueDataSourceFactory
#torque.dsfactory.MMCycle.pool.defaultMax-Connections=10
#torque.dsfactory.MMCycle.pool.maxExpiry-Time=3600
#torque.dsfactory.MMCycle.pool.connection-WaitTimeout=10
#torque.dsfactory.MMCycle.connection.driver=
com.microsoft.jdbc.sqlserver.SQLServerDriver
#torque.dsfactory.MMCycle.connection.url=jdbc:microsoft:
  sqlserver://DB1:1433;DatabaseName=MMCycle;SelectMethod=cursor
#torque.dsfactory.MMCycle.connection.user = sa
#torque.dsfactory.MMCycle.connection.password = (7MOR6pa2)

## Using Jdbc2Pool
#torque.dsfactory.bookstore.factory=\
# org.apache.torque.dsfactory.Jdbc2PoolDataSourceFactory
#torque.dsfactory.bookstore.pool.defaultMaxActive
=10
#torque.dsfactory.bookstore.pool.testOnBorrow
=true
#torque.dsfactory.bookstore.pool.validationQuery
=SELECT 1
#torque.dsfactory.bookstore.connection.driver = org.gjt.mm.mysql.Driver
#torque.dsfactory.bookstore.connection.url =
  jdbc:mysql://localhost:3306/torque
#torque.dsfactory.bookstore.connection.user = user
#torque.dsfactory.bookstore.connection.password = password

## Using jndi
#torque.dsfactory.bookstore.factory=org.apache.
torque.dsfactory.JndiDataSourceFactory
#torque.dsfactory.bookstore. jndi.path=jdbc/bookstore
#torque.dsfactory.bookstore.jndi.java.naming.
factory.initial = org.apache.naming.java.java-URLContextFactory
#torque.dsfactory.bookstore.jndi.java.naming.
factory.url.pkgs = org.apache.naming

#torque.dsfactory.bookstore.datasource.classname=
org.apache.torque.pool.TorqueClassicDataSource
#torque.dsfactory.bookstore.datasource.
dataSourceName=jdbc/DBbookstore
#torque.dsfactory.bookstore.datasource.jndi-Environment.java.naming.factory.initial
  =org.apache.naming.java.javaURLContextFactory
#torque.dsfactory.bookstore.datasource.jndi-Environment.java.naming.factory.url.pkgs
   =org.apache.naming
#torque.dsfactory.bookstore.datasource.default-MaxConnections=10

## ConnectionPoolDataSource
#torque.dsfactory.bookstore.factory=
  org.apac-he.torque.dsfactory.JndiDataSourceFactory
#torque.dsfactory.bookstore.jndi.path=jdbc/DBbookstore
#torque.dsfactory.bookstore.jndi.java.naming.
factory.initial = org.apache.naming.java.
javaURLContextFactory
#torque.dsfactory.bookstore.jndi.java.naming.
factory.url.pkgs = org.apache.naming
#torque.dsfactory.bookstore.datasource.classname=
  org.apache.commons.dbcp.cpdsadapter.Driver-AdapterCPDS
#torque.dsfactory.bookstore.datasource.driver =
  org.gjt.mm.mysql.Driver
#torque.dsfactory.bookstore.datasource.url =
  jdbc:mysql://localhost:3306/torque
#torque.dsfactory.bookstore.datasource.user = user
#torque.dsfactory.bookstore.datasource.password =
  password

结论  

对于大多数采用RDMS作为数据存储手段的J2EE项目来说,Torque简单、易用, 是Persistence层的优秀解决方案之一。



版权所有:UML软件工程组织