使用 AppFuse 快速构建 J2EE 应用

本文的示例实现对员工信息的增删查改等基本功能。用 Tapestry 实现表示层，用 Hibernate 开发持久层，用 Spring 提供事务控制等跨模块服务，并用 Acegi 进行安全管理。本示例只用到一个域模型：Employee，下面是它的 UML 图。

图 1. Employee UML 图
 

搭建开发环境

本文的代码开发平台采用的是 Windows 操作系统，因此，以下环境设置也是针对 Windows 操作系统的。

从 AppFuse 下载页面 下载 appfuse-tapestry-1.9.3-src.zip，并解压缩在任意目录下。这个 zip 已经定制了使用 Tapestry 作为表现层的实现框架，因而使用起来较为直接。
从 http://java.sun.com 下载最新的 JDK，并安装或解压缩到任意目录下。本文采用 JDK 1.5.0。设置环境变量 JAVA_HOME 指向 JDK 所在的目录，并在 PATH 中添加 %JAVA_HOME%/bin。
从 http://jakarta.apache.org/tomcat 下载最新版的 Tomcat，并安装或解压缩到任意目录下。本文采用 Tomcat 5.5.17。设置环境变量 CATALINA_HOME 指向 Tomcat 的安装目录。
从 http://ant.apache.org下载最新版的 Ant，并解压缩到任意目录下。AppFuse 要求的最低版本是 1.6.2，本文采用的是 1.6.5。设置 ANT_HOME 指向 Ant 所在的目录，并在 PATH 中添加 %ANT_HOME%/bin。另外，要拷贝一个 junit.jar 到 %ANT_HOME%/lib 下，如果 lib 下没有 junit.jar，AppFuse 的脚本在运行时会给出警告信息。junit.jar 可以从 http://www.junit.org 获得，也可以从 %AppFuse%/lib/junit3.8.1 目录下获得。
从 http://www.mysql.com 下载最新版的 MySQL，并安装或解压缩到任意目录下。本文采用的是 5.0。
从 http://www.eclipse.org 下载 Eclipse 3.1 或 3.2，安装到任意目录下。
    AppFuse 的 Ant 脚本可以在命令行中运行，也可以在 Eclipse 里运行。有关如何在 Eclipse 里执行 Ant 脚本，请参考《用Eclipse开发AppFuse应用》。到此，我们已经为 AppFuse 开发应用准备好了环境，下面让我们开始使用 AppFuse 创建项目。

新建项目

   AppFuse 的便捷与强大之处在于它已经为我们提供了多种开源框架的集成，并且通过使用 Ant 将所有的构建过程自动化。另外，AppFuse 利用 XDoclet 能够为我们生成绝大多数重要的代码，例如 dao 类、service 类以及测试用例，等等，并且能够将大量的配置文件也一并生成好，从而极大地节省了开发人员的时间。

    用 AppFuse 进行开发通常有三种模式：“自上而下”，“自下而上”以及“混合模式”。采用“自上而下”（由 Java 对象向数据库对象创建的过程）的方式固然比较符合“面向对象”的设计思维，但是为此要编写大量的 XDoclet 的 tag 也确是一件痛苦的事情。相比较而言，采用“自下而上”（由数据库对象生成 Java 对象的过程）就显得简单许多 -- 只需要提供数据库表结构。然而，对于较为复杂的系统，尤其是类之间具有大量的关联的情形，仍然需要采用“自上而下”的创建模式。因此，在实际的项目开发中，将两种模式进行混合使用比较常见，这也就是“混合”模式。本文采用“自下而上”的模式。

    本文的 AppFuse 安装在 "c:\opt" 下面。打开命令行控制台，进入 "c:\opt\appfuse"，运行 “ant new”，为简单起见，所有参数选用默认值，见图 2。

图 2. ant new -- 新建项目

  脚本运行成功后，新项目创建在 c:\opt\myapp 下（与 AppFuse 目录同级），myapp 是 AppFuse 默认的项目名称。将该项目导入到 Eclipse 中，并根据 《用Eclipse开发AppFuse应用》 进行必要的设置。以下是两个你可能需要进行的配置：

AppFuse 默认连接 MySQL 的用户名是 root，密码为空。如果你的 root 密码不是空，需要修改 C:\opt\myapp\build.properties 中的 database.admin.password 项，记得将注释去掉。
AppFuse 默认不是用 utf-8 创建数据库，如果你需要支持多语言，需要修改 C:\opt\myapp\metadata\sql\mysql-create.sql 中的创建数据库的语句，修改如下：

清单 1. 创建数据库语句
create database if not exists @DB-NAME@ CHARACTER SET utf8 COLLATE utf8_general_ci;
                 
 

注：AppFuse 会在构建期将 @DB-NAME@ 替换成你指定的数据库名（本文中为“mydb”）。
    在 c:\opt\myapp 下运行“ant setup test-all”。“setup” 完成了很多“设置”工作：创建数据库、构建 dao 和 serive 类、加载样本数据、创建 war 文件并部署到 tomcat，等等。“test-all” 运行所有的测试用例：对 dao，service 以及页面的测试。如果这个脚本运行成功，说明开发环境一切就绪。这时，启动 Tomcat，通过访问 http://localhost:8080/myapp 就能够看到 AppFuse 的登录界面了。AppFuse 预定义了两个用户：mraible 和 tomcat，密码都是 tomcat。mraible 属于管理员角色（能够管理用户信息），tomcat 属于普通用户角色。用 mraible 登录可以看到 图 3的界面。

图 3. AppFuse 的初始界面
 

     或许此时，你已惊奇地发现，自己不过只运行了一次 Ant 脚本，但是系统已经拥有“用户管理”、“邮件”、“文件上传” 等功能 -- 这就是 AppFuse “开箱即用”的优势。接下来让我们开始开发前述的应用示例。

创建数据库表

在 mydb 数据库中执行如下语句创建 employee 表：

清单 2. 创建 employee 语句
CREATE TABLE `employee` (
`id` bigint(20) NOT NULL auto_increment,
`code` varchar(10) NOT NULL,
`dept` varchar(50) NOT NULL,
`name` varchar(20) NOT NULL,
`status` varchar(10) NOT NULL,
`telephone` varchar(20) default NULL,
`title` varchar(50) NOT NULL,
PRIMARY KEY  (`id`)
                  ) ENGINE=InnoDB DEFAULT CHARSET=utf8;  
 

本文引用自ＰＣ５１.ＮＥＴ