[AppFuse]快速上手

AppFuse项目的主要目的是帮助你加速web应用程序的开发。下面说明如何利用它创建一个新工程的基本步骤。

1. 安装 J2SE 1.4.2+ 并设置环境变量JAVA_HOME指向J2SE所在的目录。
2. 下载源程序报或者从CVS(cvs -d :pserver:guest@cvs.dev.java.net:/cvs co appfuse)中检出appfuse模块。
   注意: 你可以使用 the all-in-one installer 一次性下载安装AppFuse 1.8, Ant 1.6.2, Tomcat 5.0.28 和 MySQL 4.1.11 (for Windows)。查看相关的 README.txt 文件可以了解更多信息。
3. 安装 Install Ant 1.6.2+ 并设置 ANT_HOME 环境变量。 安装 Tomcat 4.1.x+ (推荐使用Tomcat 5.0.28) 并设置 CATALINA_HOME 环境变量指向对应的Tomcat安装目录。 参阅我的文章 设置开发环境 可以了解在哪里下载到这些程序并且可以了解我通常如何安装配置这些程序。
4. 安装 MySQL 3.23.x+ (推荐使用 4.1.7).
   注意: 如果你使用 MySQL 4.1.7, 确定正确设置了 UTF-8 字符集和 InnoDB 表类型。

   MySQL 4.1.7+ requires you to add set the default character set to UTF-8 to get unicode support with AppFuse. To do this, add the following to your mysql option file (c:/Windows/my.ini or /etc/my.cnf ):

   [mysqld]
   default-character-set=utf8
   

   。

   MySQL's default tables (MyISAM) do not support transactions by default. Add or replace the following line in your mysql option file.
   

   [mysqld]
   default-storage-engine=innodb
   

   BTW, MySQL Administrator is a nice tool for administering/monitoring MySQL.
5. 设置本机的 SMTP server 或者修改 mail.properties 文件(在 web/WEB-INF/classes 目录下) 和 build.properties 文件(在根目录下 -- 给 log4j 消息使用) 以使用一个已有的smtp server - 默认值是 localhost。
6. 把文件 lib/junit3.8.1/junit.jar 拷贝到 $ANT_HOME/lib目录下。
   注意: 你可能会发现在 $ANT_HOME/lib目录已经有一个 ant-junit.jar 文件了. 这个 jar 包不是 JUnit 类库, 而是 Ant 的 junit task 实现，在执行Ant junit task时会使用你新增的这个junit.jar 文件。
7. 如果你计划使用 iBATIS (代替 Hibernate) 或者 struts 以外的 web framework, 现在安装它们 (安装指令下面可以查到)。安装完成以后, 在appfuse目录下运行 ant new 。会提示你输入application name, database name 和 package name。完成这些操作以后会在appfuse同级目录家里一个包含新程序所需要的全部文件的以你输入的application name命名的目录。
   警告: 请不要在输入的application name, database name 和 package name使用 "test", 包含 "appfuse" 的名称 或者 以数字作为起始字符的名称，否则将会导致任务无法正常执行，此外使用两个破折号 (-) 会造成结果混乱。
8. 切换到这个新的工程目录并且运行 ant setup (或者运行 ant setup-db setup-tomcat deploy) 创建数据库，配置tomcat并发布你的新应用程序。创建数据库的任务只有在你的root用户密码为空的情况下才能工作。需要的话你可以修改 build.properties 文件. 安装设置帮助 ?
9. 若你细想要进行测试以确定所有程序工作良好，运行 ant test-all - 在运行这个任务的时候确定 Tomcat 没有启动。 接下来, 运行 ant test-reports - 运行结束后会显示消息告诉你如何查看产生的报告。

在你确认你正确的完成了上述步骤以后 - 浏览一下 指南 了解如何使用appfuse开发程序。

安装的可选项

• 如果你希望使用 iBATIS 作为持久化framework, 查看extras/ibatis目录下的 README.txt 文件或者运行 ant install-ibatis。
• 如果你希望使用 Spring 作为web framework, 查看 extras/spring 目录下的 README.txt 文件或者运行 ant install-springmvc。
• 如果你希望使用 WebWork 作为web framework, 查看extras/webwork 目录下的 README.txt 文件或者运行 ant install-webwork。
• 如果你希望使用 JSF 作为web framework, 查看 extras/jsf 目录下的 README.txt 文件或者运行 ant install-jsf。
• 如果你希望使用 Tapestry 作为web framework, 查看 extras/tapestry 目录下的 README.txt 文件或者运行 ant install-tapestry。

• 如果你想写脚本自动基于Appfuse创建并测试自己的工程。在CVS上面有两个我已经写好的用来测试的脚本供参考: spring+ibatis 和 webwork. 注意在实际开发过程中最好不要使用 "appfuse" 作为工程名 因为可能会造成不必要的查找/替换。
• 如果你不希望安装 iBATIS, Spring MVC, WebWork, JSF 和 Tapestry - 你应该在使用版本控制工具把它们检入前删除extras下的相关目录。

注意: 安装程序会修改 Eclipse classpath，但是不会是理想的方法。 你需要人工修改它。