AppFuse項(xiàng)目的主要目的是幫助你加速web應(yīng)用程序的開發(fā)。下面說明如何利用它創(chuàng)建一個(gè)新工程的基本步驟。
- 安裝 J2SE 1.4.2+ 并設(shè)置環(huán)境變量JAVA_HOME指向J2SE所在的目錄。
-
下載
源程序報(bào)或者從CVS(cvs -d :pserver:guest@cvs.dev.java.net:/cvs co appfuse)中檢出appfuse模塊。
- 安裝 Install Ant 1.6.2+ 并設(shè)置 ANT_HOME 環(huán)境變量。 安裝 Tomcat 4.1.x+ (推薦使用Tomcat 5.0.28) 并設(shè)置 CATALINA_HOME 環(huán)境變量指向?qū)?yīng)的Tomcat安裝目錄。 參閱我的文章 設(shè)置開發(fā)環(huán)境 可以了解在哪里下載到這些程序并且可以了解我通常如何安裝配置這些程序。
- 安裝 MySQL 3.23.x+ (推薦使用 4.1.7).
注意: 如果你使用 MySQL 4.1.7, 確定正確設(shè)置了 UTF-8 字符集和 InnoDB 表類型。
這里說明如何設(shè)置。
-
設(shè)置本機(jī)的 SMTP server 或者修改 mail.properties 文件(在 web/WEB-INF/classes 目錄下) 和 build.properties 文件(在根目錄下 -- 給 log4j 消息使用) 以使用一個(gè)已有的smtp server - 默認(rèn)值是 localhost。
- 把文件 lib/junit3.8.1/junit.jar 拷貝到 $ANT_HOME/lib目錄下。
注意: 你可能會(huì)發(fā)現(xiàn)在 $ANT_HOME/lib目錄已經(jīng)有一個(gè) ant-junit.jar 文件了. 這個(gè) jar 包不是 JUnit 類庫, 而是 Ant 的 junit task 實(shí)現(xiàn)，在執(zhí)行Ant junit task時(shí)會(huì)使用你新增的這個(gè)junit.jar 文件。
- 如果你計(jì)劃使用 iBATIS (代替 Hibernate) 或者 struts 以外的 web framework, 現(xiàn)在安裝它們 (安裝指令下面可以查到)。安裝完成以后, 在appfuse目錄下運(yùn)行 ant new 。會(huì)提示你輸入application name, database name 和 package name。完成這些操作以后會(huì)在appfuse同級(jí)目錄家里一個(gè)包含新程序所需要的全部文件的以你輸入的application name命名的目錄。
警告: 請(qǐng)不要在輸入的application name, database name 和 package name使用 "test", 包含 "appfuse" 的名稱 或者 以數(shù)字作為起始字符的名稱，否則將會(huì)導(dǎo)致任務(wù)無法正常執(zhí)行，此外使用兩個(gè)破折號(hào) (-) 會(huì)造成結(jié)果混亂。
- 切換到這個(gè)新的工程目錄并且運(yùn)行 ant setup (或者運(yùn)行 ant setup-db setup-tomcat deploy) 創(chuàng)建數(shù)據(jù)庫，配置tomcat并發(fā)布你的新應(yīng)用程序。創(chuàng)建數(shù)據(jù)庫的任務(wù)只有在你的root用戶密碼為空的情況下才能工作。需要的話你可以修改 build.properties 文件. 安裝設(shè)置幫助 ?
- 若你細(xì)想要進(jìn)行測(cè)試以確定所有程序工作良好，運(yùn)行 ant test-all - 在運(yùn)行這個(gè)任務(wù)的時(shí)候確定 Tomcat 沒有啟動(dòng)。 接下來, 運(yùn)行 ant test-reports - 運(yùn)行結(jié)束后會(huì)顯示消息告訴你如何查看產(chǎn)生的報(bào)告。
在你確認(rèn)你正確的完成了上述步驟以后 - 瀏覽一下 指南 了解如何使用appfuse開發(fā)程序。
安裝的可選項(xiàng)
- 如果你希望使用 iBATIS 作為持久化framework, 查看extras/ibatis目錄下的 README.txt 文件或者運(yùn)行 ant install-ibatis。
- 如果你希望使用 Spring 作為web framework, 查看 extras/spring 目錄下的 README.txt 文件或者運(yùn)行 ant install-springmvc。
- 如果你希望使用 WebWork 作為web framework, 查看extras/webwork 目錄下的 README.txt 文件或者運(yùn)行 ant install-webwork。
- 如果你希望使用 JSF 作為web framework, 查看 extras/jsf 目錄下的 README.txt 文件或者運(yùn)行 ant install-jsf。
- 如果你希望使用 Tapestry 作為web framework, 查看 extras/tapestry 目錄下的 README.txt 文件或者運(yùn)行 ant install-tapestry。
- 如果你想寫腳本自動(dòng)基于Appfuse創(chuàng)建并測(cè)試自己的工程。在CVS上面有兩個(gè)我已經(jīng)寫好的用來測(cè)試的腳本供參考: spring+ibatis 和 webwork. 注意在實(shí)際開發(fā)過程中最好不要使用 "appfuse" 作為工程名 因?yàn)榭赡軙?huì)造成不必要的查找/替換。
- 如果你不希望安裝 iBATIS, Spring MVC, WebWork, JSF 和 Tapestry - 你應(yīng)該在使用版本控制工具把它們檢入前刪除extras下的相關(guān)目錄。
注意: 安裝程序會(huì)修改 Eclipse classpath，但是不會(huì)是理想的方法。 你需要人工修改它。