a Appfuse PPT

 

1.下载 并安装 JDK 5+

§配置JAVA_HOME 环境变量指向JDK安装目录，而不是指向 JRE

§并在 PATH 中添加 %JAVA_HOME%\bin

2.下载 并安装 MySQL 5.x

§安装是请选择数据库默认为 utf-8 编码

3.安装一个本地的 SMTP 服务器 不是必须,如果不发送Email可以不配置

 

4.下载 并 安装 Maven 2.2.1+

§配置环境变量 MAVEN_HOME 指向 maven 的安装目录

§并将 %MAVEN_HOME%\bin 加入到 Path

5.下载 并 安装 Tomcat 6+

§配置环境变量 CATALINA_HOME 指向 tomcat 安装目录

 

v进入 AppFuse 官网生成,建立项目命令

§http://www.appfuse.org/display/APF/AppFuse+QuickStart+-+Chinese

 

vAppFuse 三种起始项目

§AppFuse Light

•轻量级，最简单的。

§AppFuse Basic

•基本的，包括了最基本的用户管理和权限控制。

§AppFuse Module

•模块化的，包含"core" 和 "web" 模块，它适合建立可重用后台的项目。

 

v填写包名和项目名，选择相应的版本类型

 

v运行生成的命令

mvn archetype:generate -B -DarchetypeGroupId=org.appfuse.archetypes -DarchetypeArtifactId=appfuse-basic-jsf-archetype -DarchetypeVersion=2.1.0-M1 -DgroupId=com.summit -DartifactId=demo

1.执行的过程 maven 会从服务器上下载jar包到本地目录（C:\Documents and Settings\Administrator\.m2\repository） ，这是Maven 的默认 jar 包目录。

2.在运行的过程由于网络原因，可能需要等待；如果看到 BUILD SUCCESSFUL ,则表示您的项目建立成功，可以进入下一步了。

v运行前注意事项：

§如果采用的起始项目不是轻量级的请确认你的MySql 数据库，可以通过root和空密码访问；轻量级的项目采用的是嵌入式数据库HSQLDB。

 

修改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> 属性（在尾部）。 

 

v使用命令运行项目

§进入项目的根目录执行 (使用命令 cd 项目名)

1.mvn appfuse:full-source

–更改 AppFuse 到全源代码模式

2.mvn

–下载项目的依赖jar包到本地 ,并进行集成测试(如果第一次需要很长时间)

3.mvn jetty:run-war

–打包并运行项目

–如果是模块化的项目，进入需要从您的项目的Web目录执行

4.http://localhost:8080

–通过浏览器访问,默认的用户名和密码

»admin /admin  或者  user / user

v1.生成项目集成开发环境的项目文件

§修改pom.xml文件中

 

修改 maven-eclipse-plugin 的 version 为 2.5.1

 

 

§执行mvn eclipse:eclipse生成 项目文件(.project,.classpath,.settting)

§如果使用的 Module 模目，需要使用 mvn install eclipse:eclipse

 

 

 

 

 

 

v2.配置Local Repositories (两种选择一个)

§在系统环境变量中，增加

     M2_REPO=~\.m2\repository

§Eclipse中设置ClassPath
     在选择菜单中Windows->Preferences->Java->Build Path-           >Classpath Variables中设置M2_REPO

 

 

 

 

 

v3.更改AppFuse 的代码生成方式

§打开项目根目录的 pom.xml 文件,找到下面的代码

•genericCore ：如果为true 则表示生成代码时只生成核心文件，不会生成DAO和Manager.

•fullSource：如果为true 则表示生成所有代码

§修改 genericCore 为 false

v4.在数据库中创建业务表

/*==============================================================*/

/* Table: emp                                                   */

/*==============================================================*/

create table emp

(

   eid                   int not null auto_increment,

   ename                 varchar(50),

   eage                  int,

   estate                int,

   primary key (eid)

);

v5.通过数据表生成 Model 类

§mvn  appfuse:gen-model

v6.通过 Model 生成 Dao,Manager,Action,TestClass，page 等

§mvn appfuse:gen

v7.运行服务器查看生成的CRUD实例

§mvn jetty:run

 

v

将页面文字翻译成中文

§修改 src\main\resources\ 下的资源文件

•ApplicationResources.properties 已经生成了对应的英文

•ApplicationResources_zh_CN.properties  添加中文

 

v页面布局和样式

§在 web\styles 提供了 自带的三种主题，用管理员的角色登录后，可以在url后面加 “?theme=andreas01”修改默认主题；

§也可以根据需求添加自己的主题样式

 

v系统安全

§AppFuse 使用的是Spring security 进行安全管理，可以在 “src\main\webapp\WEB-INF\security.xml”文件中修改安全配置信息

 

v事务管理

§AppFuse 采用的是 Spring 声明式安全事务管理,可以根据需要在 “src\main\resources\applicationContext-service.xml”文件中修改

 

v

系统运行日志

§AppFuse 集成了 Log4j 进行日志管理，可以在“src\main\resources\log4j.xml”文件中修改日志级别和输出格式

§AppFuse 已经在很多基类（如BasePage.java、BaseDaoHibernate.java 以及 BaseManager.java 等）中，加入了下面的输出日志的成员变量:

 

 

 

 

 

vmvn jetty:run

§运行程序不用打包

vmvn jetty:run-war

§打包并且发布你的应用程序到Jetty

vmvn eclipse:eclipse

§生成eclipse的项目的配置文件，可以直接把项目导入到eclipse中

vmvn site

§生成项目的统一站点，和测试报告、API 文档、项目成员信息等

 

 

 

vmvn appfuse:full-source

§把运行所需要的org.appfuse中的依赖类转换成你的包名称

vmvn appfuse:gen-model

§根据数据库表生成java model类

vmvn appfuse:gen

§根据 POJOs.生成并安装 Tests, DAOs, Managers, Controllers and Views

vmvn appfuse:install

§把生成的源代码及配置文件写入到src中

 

 

vmvn appfuse:remove

§删除appfuse:gen生成的代码

vmvn appfuse:clean

§清除target下的所有内容

vmvn appfuse:copy-templates

§复制 appfuse 的CRUD生成模板到项目工程，方便自定义模板(使用的是Freemarker)

 

 

 

 

 v

OutOfMemoryError

§在使用mvn 命令时，有可能会出现这个错误，主要原因是maven 在执行的时候，内存不够用;设置maven的环境变量，调整内存大小:
MAVEN_OPTS=-Xmx512m -XX:MaxPermSize=256m