AppFuse QuickStart - Chinese - AppFuse 2 -?Co...

来源:百度文库 编辑:神马文学网 时间:2024/04/24 06:24:52

AppFuse QuickStart - Chinese

Comment:
Enter labels to add to this page:   Looking for a label? Just start typing.

要开始使用 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中的 属性(在尾部)。

运行您的应用

如今运行 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 底部的 属性部分。 参见 数据库配置说明去使用一个 MySQL外的数据库。

开发您的应用

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

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

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