【原创翻译】AppFuse 2.0 快速起步【AppFuse文档-4】

AppFuse 2.0 快速起步

 

【原创翻译】AppFuse 2.0 快速起步【AppFuse文档-4】

 

本文简述如何快速上手，开始使用AppFuse 2

 

翻译: 陈海青（josonchen）

(http://www.chq.name)

(http://www.hhrz.org)

2007.10.22

英文版网址:http://appfuse.org/display/APF/AppFuse+QuickStart

Added by Matt Raible, last edited by Matt Raible on Sep 18, 2007 10:18

请依照以下步骤开始使用 AppFuse 开发 Java EE 应用程序：

目录

1.        建立 一个新项目 .

2.        运行.

3.        高兴高兴 .

 

建立项目

1.        下载 安装 JDK 5+.

2.        下载 安装 MySQL 5.x.

3.        设置一个本地的 SMTP 服务器 或者修改 mail.properties 文件 ( 位于 src/main/resources ) 来使用其它的主机名 - 默认使用 "localhost".

4.        下载 安装Maven 2.0.6.

如果你更喜欢使用 Eclipse 来建立项目，而不是命令行 , 可以参考 Candy for AppFuse.

5 ． AppFuse 拥有很多构造不同风格项目的能力 . 为使用户使用起来更优化、更简单 , 我们建立了多种原型（又称作：起始项目） . 现在又两种类型的 AppFuse 原型 : 基本的（ basic ）和模块化的（ modular ） . 基本原型用于建立基于 web 应用的项目；模块化原型包含“核心”（ core ） " 和 "web" 模块，用于后台可复用的项目。下表中的命令是用于产生其实项目的，改变 groupId 就定制包名（ package name ）；改变 artifactId 来定制项目名（ project's name ） .

 

在建立原型过程中，是会看到一些警告信息输出。如果在输出信息的末尾看到了“ BUILD SUCCESSFUL ”字样，那就意味着你的项目建立成功了。

Archetype	Command
JSF Basic	mvn archetype:create -DarchetypeGroupId=org.appfuse.archetypes -DarchetypeArtifactId=appfuse-basic-jsf -DremoteRepositories=http://static.appfuse.org/releases-DarchetypeVersion=2.0 -DgroupId=com.mycompany.app -DartifactId=myproject
Spring MVC Basic	mvn archetype:create -DarchetypeGroupId=org.appfuse.archetypes -DarchetypeArtifactId=appfuse-basic-spring -DremoteRepositories=http://static.appfuse.org/releases-DarchetypeVersion=2.0 -DgroupId=com.mycompany.app -DartifactId=myproject
Struts 2 Basic	mvn archetype:create -DarchetypeGroupId=org.appfuse.archetypes -DarchetypeArtifactId=appfuse-basic-struts -DremoteRepositories=http://static.appfuse.org/releases-DarchetypeVersion=2.0 -DgroupId=com.mycompany.app -DartifactId=myproject
Tapestry Basic	mvn archetype:create -DarchetypeGroupId=org.appfuse.archetypes -DarchetypeArtifactId=appfuse-basic-tapestry -DremoteRepositories=http://static.appfuse.org/releases-DarchetypeVersion=2.0 -DgroupId=com.mycompany.app -DartifactId=myproject
JSF Modular	mvn archetype:create -DarchetypeGroupId=org.appfuse.archetypes -DarchetypeArtifactId=appfuse-modular-jsf -DremoteRepositories=http://static.appfuse.org/releases-DarchetypeVersion=2.0 -DgroupId=com.mycompany.app -DartifactId=myproject
Spring MVC Modular	mvn archetype:create -DarchetypeGroupId=org.appfuse.archetypes -DarchetypeArtifactId=appfuse-modular-spring -DremoteRepositories=http://static.appfuse.org/releases-DarchetypeVersion=2.0 -DgroupId=com.mycompany.app -DartifactId=myproject
Struts 2 Modular	mvn archetype:create -DarchetypeGroupId=org.appfuse.archetypes -DarchetypeArtifactId=appfuse-modular-struts -DremoteRepositories=http://static.appfuse.org/releases-DarchetypeVersion=2.0 -DgroupId=com.mycompany.app -DartifactId=myproject
Tapestry Modular	mvn archetype:create -DarchetypeGroupId=org.appfuse.archetypes -DarchetypeArtifactId=appfuse-modular-tapestry -DremoteRepositories=http://static.appfuse.org/releases-DarchetypeVersion=2.0 -DgroupId=com.mycompany.app -DartifactId=myproject
Core (backend only)	mvn archetype:create -DarchetypeGroupId=org.appfuse.archetypes -DarchetypeArtifactId=appfuse-core -DremoteRepositories=http://static.appfuse.org/releases-DarchetypeVersion=2.0 -DgroupId=com.mycompany.app -DartifactId=myproject

7.      如果你安装了 MySQL 5.x 而且它的 root 用户没有设置口令，那你的 AppFuse 应用就能立即运行起来 . 如果你想使用内嵌式的数据库（ embedded database ） , 我们最近正好增加了一个 Database Profiles 文件用于使用 H2, HSQLDB 等数据库 .

 

关于 MySQL 安全性 使用不设置口令的 MySQL 会导致系统不安全。一旦建立了数据库，可以使用以下命令来设置 root 用户的口令 : mysql --user=root --pass='' mysql -e "update user set password=password('newpw') where user='root'; flush privileges;" AppFuse 默认使用 root 用户和空口令，可以编辑项目的 pom.xml 文件 ( 位于文件末尾 ) 的 和 属性，来设置相应的值

运行应用程序

现在，运行 AppFuse 是非常容易得 . 一旦建立了原型项目， Maven 就会分别使用 hibernate3and dbunit 插件来为你建立并设置数据库 . 需要你做的只是使用 Maven 来运行 Jetty 容器并开始浏览应用了 .

1.        除非你有更好的主意，应该首先把你的项目检入到源码控制服务器中。 Google Code 提供免费的 Subversion 服务 , 当然类似的还有很多 .

2.        进入命令行， cd 到你的新项目目录，运行 mvn 把 JARs, Tomcat 和综合测试程序下载到项目里。现在是喝杯咖啡或啤酒和好时机，因为下载和运行测试大约需要 5-10 分钟 .

3.        要浏览应用需在项目目录里运行命令 mvn jetty:run-war ( 对于模块化项目 -modular project, 应在项目的 web 目录下运行 mvn jetty:run-war 命令 ). Maven 将会启动 Jetty ，于是就可以在浏览器输入地址 http://localhost:8080 来浏览应用了。

默认的管理用户的用户名和口令是 dmin/admin ， 常规用户是 user/user 。

4.  运行命令 mvn war:inplace 可以覆盖（ override ） AppFuse 的文件 . 将会只把依赖的 WARs 文件抽取到 src/main/webapp 目录 , 在这里，你可以根据需要改变文件 . 当你把释放到你的源文件树时，可以运行 mvn jetty:run 命令 . 这样一来可以即时修改文件，而 Jetty 可以根据需要重新装载 . 这种方式的唯一的问题是你的项目里的 AppFuse 将会是不完整 ("exploded AppFuse"), 会导致更新升级困难 . 我们推荐在运行命令 mvn war:inplace 以前，首先将项目检入源码控制系统。这样一来决定哪些文件被保留或删除文件会更容易些 .

如果出现内存溢出（ OutOfMemory ）错误，请使用 jetty:run 命令，参照 this mailing list thread.

在项目目录里运行命令 mvn appfuse:full-source 可以将 AppFuse 的运行模式由内嵌 （ "embedded mode" ）改变为全源码模式（ full-source mode ）。

开发环境 请参照 development environment 来了解如何设置你的计算机环境，来开发基于 AppFuse 的应用开发

 

改变数据库的设置 要改变 MySQL 数据库的设置，可以简单地修改位于 pom.xml 末尾的 属性 . 参照 Database Profiles 来使用非 MySQL 的其他数据库 .

应用的部署

可以使用 Eclipse, IDEA 或 NetBeans 来部署应用 . 使用 Eclipse, 运行 mvn install eclipse:eclipse 来生成项目文件 . 使用 IDEA, 就要使用 mvn idea:idea 命令。进一步的介绍请参考 IDE Reference Guide.

本教程 Tutorials 将帮助你快速启动，开始开发自己的应用项目 .