如果想安装和配置appfuse用于开发,请看快书启动手册,地址是 :
http://raibledesigns.com/wiki/Wiki.jsp?page=AppFuseQuickStart
如果想学习如何用appfuse开发您的j2ee项目,请看 :
http://raibledesigns.com/wiki/Wiki.jsp?page=Articles
(如果您下载了appfuse的源代码,docs/index.html这个文件),如果您想得到所有最新的文档到docs目录,
可以运行 ant wiki 命令.
如果想创建这个应用程序,您需要拥有 ant 1.6.2以上的版本,(现在最新版本是 apache-ant-1.6.5 ),另外还要把junit.jar拷贝到$ANT_HOME/lib 目录。
我们希望您安装了Tomcat 5.0.x+以上的版本,我们还希望您在本地安装一个SMTP 服务器(如果您不想安装,那么就需要更改web/WEB-INF/classes/mail.properties这个文件,让她指定到一个存在的SMTP服务器上。
SMTP(Simple Mail Transfer Protocol)即简单邮件传输协议,它是一组用于由源地址到目的地址传送邮件的规则,由它来控制信件的中转方式。SMTP协议属于TCP/IP协议族,它帮助每台计算机在发送或中转信件时找到下一个目的地。通过SMTP协议所指定的服务器,我们就可以把E-mail寄到收信人的服务器上了,整个过程只要几分钟。SMTP服务器则是遵循SMTP协议的发送邮件服务器,用来发送或中转你发出的电子邮件。
想运行这个应用程序,你需要执行下面的步骤 :
1 : 默认的数据库应该是 帐号为 root 没有密码的 mysql 数据库,如果您的系统不是这样的,请修改properties.xml或者build.properties文件来覆盖里面的默认值。
2 : 执行 ant setup-db 命令,这样就创建了一个名字的appfuse的数据库,并为这个数据库创建了一个 用户名为test,密码
都为为test,拥有所有权限的帐号,当你用 D:/mysql/bin>mysql -u test -p ,进入的时候,只能看到 appfuse和test两个
数据库。
-> ;
+--------------------+
| Database |
+--------------------+
| information_schema |
| appfuse |
+--------------------+
2 rows in set ( 0.05 sec)
mysql >
3 : 用
ant test-dao -Dtestcase=UserDAO
ant test-service -Dtestcase=UserManager
命令测试一下 数据库访问代码是否正常工作。
4 : 执行 ant setup-tomcat deploy 会部署 appfuse.xml文件到$CATALINA_HOME/conf/Catalina/
localhost,并且在$CATALINA_HOME/webapps 出现一个appfuse文件夹。
5 : 启动tomcat,用 ant test-canoo -Dtestcase=Login 命令 测试网站的登陆,如果您tomcat experience 信息,请检查 您的build/test/cargo.log文件。
这步骤没有执行成功。
Features/Changes in 1.9.3
============================
- Fixed UserSecurityAdvice so userCache is cleared properly when changing
username.
- Fixed versioning issues when updating a username with a pre-existing username
or e-mail.
- Updated build.xml so DbUnit works with Microsoft SQL Express/Server.
- Removed geronimo-web.xml so AppFuse works out-of-the-box with Geronimo 1.1.
- Fixed WebWork and Struts server-side validation issues with file upload.
- Changed security.xml to explicitly protect admin-only pages.
- Added filter-mapping for securityFilter so Acegi protects DWR calls.
- Menu CSS improvements.
- Various i18n improvements.
- Dependent packages upgraded:
* MyFaces Tomahawk 1.1.3
* Struts Menu 2.4.1
* XFire 1.1.2
依靠的包升级 :
* Commons Logging 1.1
* EhCache 1.2.1
* Struts Menu 2.4
* Struts 1.2.9
* Spring 1.2.8
* XFire 1.1
* Acegi Security 1.0.1
* DisplayTag 1.1
* DWR 1.1.1 (2.0已经出来了,可惜这里没使用)
* Hibernate 3.1.3
* MySQL JDBC Driver 3.1.12
* OSCache 2.3
* URL Rewrite Filter 3.0-beta
* WebTest Build 1263
* WebWork 2.2.2
- Dependent packages added:
* EMMA 2.0.5312
--------------------------------------------------------------------------------------
本目录下的 库 在appfuse中被用来完成各种任务,下面的列表 各个项目,以及他们的作用, 想了解更多关于这些项目的信息,可以通过googel搜索或浏览lib.properties里面的链接地址。
1 :ant-contrib-1.0b2 :
在build.xml中用到的任务,用来执行if/else逻辑,在执行 build.xml 时被用到
2 : cargo
ant的任务 , 在运行 canoo web 测试的时候 启动和停止 容器 的 API, 在运行 "test-jsp" and "test-all" targets 时被用到
3 : checkstyle
ant的任务 用来 创建关于 关于 代码 语法 的报告,在执行 "checkstyle" target 时被用到
4 : clickstream
servlet的过滤器和监听器 用来 跟踪 点击 路径,在运行 web 应用程序的时候 被用到。
5 : dbunit
ant的任务,为了测试载入数据库到一个已知的状态 的 API,在运行 "test-*" targets 时 被用到。
6 : displaytag
jsp的标签库 用来 排序和分页 lists , 在运行 web 应用程序的时候 被用到。
7 : dumbster
在进行 单元测试的时候,用来 仿照 smtp服务器 运行,在运行发邮件的测试中被用到。
8 : hibernate
默认的持久化框架,在进行 测试和 web应用的时候 被用到。
9 : jakarta-log4j
java应用程序的日志框架,不是必须,但当引入的时候可以控制 日志
10 : struts
默认的web框架在进行 测试和 web应用的时候 被用到。
11 : jakarta-taglibs
JSTL和request标签库,在进行 web应用的时候 被用到。
12 : java2html
ant 任务用来生成 源代码的 html 版本,在进行 生成文档和发表人物的时候被用到。
13 : javamail
标准的java mail 库,用来 发送 电子邮件信息,在运行 web 应用程序的时候被用到。
14 : jmock
单元测试时候动态 mock 库,在创建和测试 services 层的 时候 被用到。
15 : junit
测试框架用来进行单元和综合测试,在创建和运行 测试的时候 被用到。
16 : log4j
日志框架,在进行测试和web应用的 时候 被用到。
17 : mysql-jdbc-driver
mysql的jdbc驱动用来和 mysql数据库 通话,在运行 关于 mysql的应用的 时候 被用到。
18 : pmd
ant任务用来 生成 代码 效率 报告,在运行 "pmd" 任务 的 时候 被用到。
19 : postgresql-jdbc-driver
postgresql 数据库 jdbc驱动 用来 和一个postgresql数据库通话,在运行 关于 postgres的应用的 时候 被用到。
20 : rename-packages
ant任务用来 更改包名和 目录名,在 运行 'new'任务时候被用到
21 : servlet-api
标准的,所有web框架都依靠的 servlet api ,在创建和测试的时候被用到,但运行的时候不会被用到。
22 : sitemesh
页面装饰框架,在 运行 web应用程序的时候被用到。
23 : spring
把各个层粘合起来的轻量级 j2ee框架,在查ungjian,测试,运行时候被用到。
24 : struts-menu
UI 的 系统导航,在运行web应用程序的时候被用到。
25 : strutstest
struts action的测试框架,在创建和测试 struts actions的时候被用到
26 : urlrewrite
提供了类似 apache's mod_rewrite 功能 的 servlet过滤器。在运行web应用程序的时候被用到 (是配置的,不是使用的)
27 : velocity
structuring e-mails 的 模版框架,用来创建 测试,还有发e-mail
28 : webtest
驱动UI的测试框架 ,在执行 "test-jsp" 和 "test-canoo" 任务时候 被用到
29 : xdoclet
用来生成 部署 描述 的代码生成框架,在生成 hibernate的 mapping文件,web.xml,struts-config.xml文件时候 被用到。