AppFuse 2.x 教程

原帖地址：http://appfuse.org/display/APF/AppFuse+QuickStart+-+Chinese

要开始使用 AppFuse 2.x 开发 Java EE 应用，请参照以下操作进行：

目录

1. 建立 一个新的项目。
2. 运行 它。
3. 玩得开心.

建立一个项目

1. 搭建您的 开发环境 - 或者按以下步骤进行（如果您是个经验丰富的人）。
   1. 下载 并安装 JDK 5+ （请确认您的 JAVA_HOME 环境变量指向该 JDK，而不是一个 JRE） 。
   2. 下载 并安装 MySQL 5.x 。
   3. 安装一个本地的 SMTP 服务器 或变更mail.properties (在 src/main/resources 目录下) 去使用一个不同的主机名 - 它默认是 "localhost"。
   4. 下载 并 安装 Maven 2.2.1+ （或甚至是 Maven 3如果您想冒险尝试的话）。
2. 在命令行中， cd 进入您的 "Source" 目录 （在 Windows上是 c:\Source ， 在 Unix 上 是 ~/dev ） 运行 您选择web框架和其他选项后后看到的 Maven 命令 。

选择您的套件 AppFuse 提供了一组不同的 组合。 为了优化和简化您的用户体验， 我们已经建立了一些不同的 archetypes （亦称起始项目）。现在有三种不同的 AppFuse Archetypes: 轻量级的（light）， 基本的（basic）和模块化的（modular）。 轻量级的 archetypes 是极简单的，基本的 archetypes 包含用户管理和安全控制，模块化的 archetypes 包含"core" 和 "web" 模块 ，它适合建立可重用后台的项目。您将改变 groupId 去匹配您想要的包名， artifactId 匹配您的项目名。

您的浏览器不支持框架

当建立项目时，您应该会看到警告信息。 如果看到最后是 BUILD SUCCESSFUL ， 就表示您的项目建立成功了

您可以立即运行 AppFuse ，如果您已经安装了 MySQL 5.x 数据库，并且它可以通过root 和空密码访问。如果您希望使用一个嵌入式的数据库，我们最近添加了H2, HSQLDB 等等的 数据库配置文件。

安全控制 使用 root 和空密码运行 MySQL 不太安全。一旦您的数据库建好了，您可以使用以下命令改变 root 密码： mysql --user=root --pass='' mysql -e "update user set password=password('newpw') \ where user='root'; flush privileges;" AppFuse 默认使用用户名 "root" 和空密码。 要改变这些值，修改您的项目的 pom.xml中的 <jdbc.username> 和 <jdbc.password> 属性（在尾部）。

运行您的应用

如今运行 AppFuse很简单。 一旦建立了 archetype 项目， Maven 将依次建立和使用hibernate3和dbunit插件填充您的数据库。你所要做的全部事情就是使用 Maven 运行 Jetty 容器和查看您的应用。

1. 决定您是否要改变 AppFuse 从 "embedded mode" 到全源代码模式，通过运行 mvn appfuse:full-source 在您的项目根目录。当您运行 appfuse:full-source 在登记您可以遇到问题。
2. 检出您的新项目到源码控制中，除非您有的好的理由不这么做。 Google Code 有免费的 Subversion 空间，如同许多其他做的。
3. 从命令行, cd 进入到您的新项目的目录并执行 mvn 下载 JARs 文件， Tomcat和在您的项目中运行集成测试。现在是时候喝杯咖啡或来杯啤酒 - 下载所有东西和运行集成测试需要花上 5-10 分钟。
4. 要查看您的应用，在您的项目的目录中执行 mvn jetty:run-war (如果是个 模块化的 项目，您将需要从您的项目的 web 目录执行 mvn jetty:run-war )。 Maven 将启动 Jetty ，您将能从浏览器的 http://localhost:8080 看到您的应用。

   默认的管理员的用户名/密码是 admin/admin。对于一个普通的用户，使用 user/user。

5. 要从 AppFuse 覆盖文件， 执行 mvn war:inplace。这将释放依赖的 WAR 文件到 src/main/webapp 中去，在这儿您可以改变文件为您自己的内容。但您的源码树中有展开的war 时，您可以运行 mvn jetty:run。 这将允许您在运行时改变文件， Jetty 会在需要的时候重载它们。这样做的唯一的问题是您的项目将以 一个 "解开的 AppFuse" 告终， 这意味着不易于升级。我们推荐您在运行 mvn war:inplace 前检出您的项目到源码控制中。那样的话，您就较容易决定哪些东西需要被检入（覆写）和那些可以删除掉。
   如果您在执行 mvn jetty:run 时遇到错误，请删除 lib (rm -r src/main/webapp/WEB-INF/lib/) 和 struts.xml (rm src/main/webapp/WEB-INF/classes/struts.xml)。

如果您在执行 mvn jetty:run 收到了 OutOfMemory 错误，请参见 这条邮件列表话题.

开发环境 参见 开发环境 了解更多关于如何配置您的电脑以开发基于 Appfuse的应用的操作说明。

变更数据库设置 要变更您的 MySQL 数据库设置，简单地变更您的 pom.xml 底部的 <jdbc.*> 属性部分。 参见 数据库配置说明去使用一个 MySQL外的数据库。

开发您的应用

您可以使用 Eclipse， IDEA 或 NetBeans 开发您的应用。对于 Eclipse，执行 mvn install eclipse:eclipse 生成项目文件。对于 IDEA，参见 mvn idea:idea. 更多说明可以在IDE 参考指南中找到。

指导手册将帮助您开始开发您的应用。

离线开发 如果您想在没有互联网连接的情况下开发您的 AppFuse 应用，您可以 下载它的依赖包 并解压缩它们到您的 ~/.m2/repository 目录。这个wiki上的文档也可以 下载为pdf文件