AppFuse 2.0 快速起步【AppFuse文档-4】(来源：http://jff.iteye.com/blog/232469)

本文简述如何快速上手，开始使用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:generate -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:generate -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:generate -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:generate -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:generate -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:generate -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:generate -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:generate -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:generate -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 将帮助你快速启动，开始开发自己的应用项目