AppFuse1.x快速构建J2ee应用

1.搭建开发环境

[list]
[*]从 AppFuse 下载页面 下载 appfuse-src.zip，并解压缩在任意目录下。

[*]从 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，安装到任意目录下。

[/list]

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

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

打开命令行控制台，进入安装目录，运行 code="cmd"]ant new[/code]
为简单起见，所有参数选用默认值， 脚本运行成功后，新项目创建在 c:\opt\myapp 下（与 AppFuse 目录同级），myapp 是 AppFuse 默认的项目名称。
AppFuse 默认连接 MySQL 的用户名是 root，密码为空。如果你的 root 密码不是空，需要修改 C:\opt\myapp\build.properties 中的 database.admin.password 项，记得将注释去掉。

3.运行项目
在 c:\opt\myapp 下运行

ant setup test-all

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

4.增加一个实例

4.1创建数据库表

在 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;

4.2用 AppGen 生成代码

AppFuse 自带了一个代码生成工具 -- AppGen，它位于 c:\opt\myapp\extras\appgen 目录下面。AppGen 可以生成绝大部分我们需要的代码，比如 dao 类，service 类，菜单、增删改的 web 页面、配置文件、样本数据，等等。AppGen 利用 XDoclet 生成代码，因此可以在 extras/appgen/src 看到很多 .xdt 文件，这些就是 XDoclet 的模版定义文件。如果你希望自己编写 dao 和 service 类，就运行“install”这个 target，否则就用 “install-detailed” ，它可以帮你搞定一切。下面就让我们来运行 “install-detailed” 生成代码。在 c:\opt\myapp\extras\appgen 下运行

ant install-detailed

。


清单 3. 运行 install-detailed

                ...
[input] Would you like to generate code from a table or POJO? (table,pojo)
table
[input] What is the name of your table (i.e. person)?
employee
[input] What is the name, if any, of the module for your table (i.e. organization)?
hr
...

前两个问题都很直观：选择从 table 生成代码，表名是 employee。第三个问题是让用户输入使用的模块名，如果你希望 AppFuse 帮你按模块生成代码的话，就需要输入一个模块名称。这里，我们输入“hr”。如果运行成功，在 Eclipse 中会看到如下的目录结构：
4.3不过，AppFuse 并不知道开发者需要加载哪些 hbm 文件，所以要手工将 Employee.hbm.xml 文件添加到配置文件中：打开 applicationContext-hibernate.xml，在 “sessionFactory” 的 bean 声明中，找到 “mappingResources” 属性的定义，增加 “<value>org/appfuse/hr/model/Employee.hbm.xml</value>”。
清单 4. applicationContext-hibnerate.xml 中添加 Employee.hbm.xml

 ...
<beans>
    <!-- Hibernate SessionFactory -->
    <bean id="sessionFactory" class="org.springframework.orm.hibernate3.LocalSessionFactoryBean">
|-------10--------20--------30--------40--------50--------60--------70--------80--------9|
|-------- XML error:  The previous line is longer than the max of 90 characters ---------|
        <property name="dataSource" ref="dataSource"/>
        <property name="mappingResources">
            <list>
                <value>org/appfuse/hr/model/Employee.hbm.xml</value>
                <value>org/appfuse/model/Role.hbm.xml</value>
                <value>org/appfuse/model/User.hbm.xml</value>
            </list>
        </property>
...

在 c:\opt\myapp 下运行

ant deploy

。打开 “[url]http://localhost:8080/myapp[/url]”，用 mraible/tomcat 登录，“Employee List” 已经被添加到菜单里了。