欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  数据库

AppFuse 2.1的安装运行步骤

程序员文章站 2022-04-29 20:53:24
...

AppFuse 2.1刚刚于2011年4月4日发布。2.1比2.1.0.M2最大的好处是支持jetty:run快速部署,便于你在开发时进行测试(详见下文)。另外,也修正了许多bugs. 对于想要用好SSH (Struts2, Spring, Hibernate)的朋友来说,AppFuse是不可多得的宝贵范例。 我最近正在

AppFuse 2.1刚刚于2011年4月4日发布。2.1比2.1.0.M2最大的好处是支持jetty:run快速部署,便于你在开发时进行测试(详见下文)。另外,也修正了许多bugs.
对于想要用好SSH (Struts2, Spring, Hibernate)的朋友来说,AppFuse是不可多得的宝贵范例。
我最近正在研究SSH,并且想用学到的SSH技术,开发一个论坛项目。
我发现,学好SSH和用好SSH真是两件完全不同的事情。“学好”是针对基本概念,而“用好”是针对最佳实践。
我在SSH的基本概念学了一阵后,到要动手写代码了,却发现无从下手。因为SSH是3个既相对独立,又相互关联的框架。要想把SSH这3个框架整合到1个项目中,并且要用一些最佳实践整合好,并不是一件容易的事情。
AppFuse正好做了整合SSH的事情,从2007年7月11日推出AppFuse 2.0 RC1,到现在的2.1.0.M2,不仅整合好了SSH,还整合了Maven, Spring Annotations, JSF, Spring MVC, Stripe, Tapestry 5, Wicket, JDK5, Annotations, JSP 2.0, Servlet 2.4, JPA.
这两天把最新版的AppFuse 2.1范例下载下来,编译打包运行,这期间遇到了不少问题,不过还好,基本上都被我给解决了。同时给AppFuse的作者Matt开出了两个JIRA Issues.
http://issues.appfuse.org/browse/APF-1249 : i18n - displaytag_zh*.properties and errors_zh*.properties converted but input files included in WAR instead of output files
http://issues.appfuse.org/browse/APF-1250 : i18n - displaytag_zh*.properties and errors_zh*.properties not converted by native2ascii in pom.xml
这篇博文主要是把AppFuse 2.1的安装运行步骤总结一下,以后会继续把AppFuse的使用经验和大家分享。
1. 运行环境
安装好以下环境(我用的是Windows 7 Home Basic):
Java SE 1.6.0_23
MySQL Server 5.1
Maven 2.2.1 (有些情况下AppFuse的操作在用Maven 3.0.3时会报错)
Tomcat 7.0.2
Eclipse 3.6.1 SR2
m2eclipse
2. AppFuse Quickstart
打开AppFuse Quickstart页面备查:http://appfuse.org/display/APF/AppFuse+QuickStart
3. 生成basic范例
在一个空文件夹下,从命令行提示窗口,运行Quickstart中下面的范例生成命令
mvn archetype:generate -B -DarchetypeGroupId=org.appfuse.archetypes -DarchetypeArtifactId=appfuse-basic-struts-archetype -DarchetypeVersion=2.1.0 -DgroupId=com.mycompany -DartifactId=myproject -DarchetypeRepository=http://oss.sonatype.org/content/repositories/appfuse
上述命令运行成功后,会在当前文件夹下,生成一个myproject目录。进入目录,会看到范例源代码。
4. 获取全部源代码
在有pom.xml的目录下,运行下面的命令,获取全部AppFuse的源代码:
mvn appfuse:full-source
5. MySQL的root的password
在pom.xml文件结尾处,找到MySQL的root的password的元素,写上你的root的口令。pom.xml默认root的口令是空。
6. 编译运行
在myproject目录下,在命令行提示窗口,运行下面的命令让AppFuse运行在Jetty服务器上。
mvn jetty:run
AppFuse 2.1最大的改进之一,就是使用了mvn jetty:run来快速部署测试你的应用程序。maven-jetty-plugin能根据pom.xml的描述,在不打WAR包的情况下,自动找到相关的文件来部署运行Web 应用程序进行开发测试,能为你省去了大量打WAR包,然后再部署到Tomcat上测试的时间。另外maven-jetty-plugin也能扫描你的源代码,一旦发现有源文件更新,它会自动重新部署Web应用。
等提示jetty启动完毕后,在浏览器中输入http://localhost:8080/来访问AppFuse. Login界面的用户名和口令都是admin,登录进入AppFuse范例系统。
你也可以运行下面命令在生成WAR包,部署到Tomcat上:
mvn clean package
7. 开发
AppFuse 2.1不建议使用mvn eclipse:eclipse来生成eclipse项目文件,因为eclipse plugin的bug太多了。Matt建议直接在eclipse里使用m2eclipse,来打开AppFuse进行开发。
我在Eclipse里用m2eclipse进行Maven的操作很顺利。同时发现,若在MyEclipse (我用的是MyEclipse for Spring 8.6.0),取消Maven4MyEclipse功能,直接用m2eclipse也同样很顺利。

接下来,你就可以用Eclipse看AppFuse的代码,在Eclipse里用m2eclipse发mvn jetty:run命令打包运行,再对照着读AppFuse 的Tutorials (http://appfuse.org/display/APF/Tutorials)了。


==================================================================

利用Maven构建appfuse。

步骤如下:

1)Maven下载下载apache-maven-2.2.1-bin.zip 下载地址:http://apache.freelamp.com/maven/binaries/apache-maven-2.2.1-bin.zip



2)下载appfuse支持包。下载地址: -2.0.2.zip(开发中需要的各个版本的jar包)



3)Maven环境搭建

1.解压缩apache-maven-2.2.1-bin.zip到你想安装的位置,如E:javaapache-maven-2.2.1。

2.设置Maven系统环境变量:PATH中添加E:javaapache-maven-2.2.1bin。

3.确认Maven的安装,在命令行输入mvn - version提示Apache Maven 2.2.1即安装成功;



4)将下载下来的appfuse支持包解压。如:E:javam2repository



5)修改E:javaapache-maven-2.2.1confsettings.xml

如下:


E:/java/m2/repository



6)新建项目:cmd 进入E:workspace>

mvn archetype:generate -B -DarchetypeGroupId=org.appfuse.archetypes -DarchetypeArtifactId=appfuse- basic-struts -DarchetypeVersion=2.0.2 -DgroupId=com.appsafe -DartifactId=publicCenter

(注: 可以到http://appfuse.org/display/APF/AppFuse+QuickStart+-+Chinese 选择你所需要的套件,此处以Struts2为

例).出现BUILD SUCCESS为成功



7)获取appfuse源码:

先进入项目E:workspacepublicCenter> 再运行mvn appfuse:full-source



8)修改项目的pom.xml中的 为你数据库的用户名和密码



9)生成eclipse项目 :mvn eclipse:eclipse

加入支持库:Window -> Preferences -> Java -> Build Path -> Classpath Variables -> New,Name输入M2_REPO,Path输入E:javam2repository



10)试运行:mvn jetty:run



11)自动生成代码:此处需要下载模板。mvn appfuse:copy-templates此时会在src/test/resources/appfuse下面多出很多.ftl的文件。这就是模板文件。可以自定义修改。



12)创建表结构:

CREATE TABLE `Employee` (
`id` bigint(20) NOT NULL auto_increment
`code` varchar(10) NOT NULL
`dept` varchar(50) NOT NULL
`name` varchar(20) NOT NULL
`status` varchar(10) NOT NULL
`telephone` varchar(20) default NULL
`title` varchar(50) NOT NULL
PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;



13)通过表来生成pojo:mvn appfuse:gen-model

删除@GeneratedValue(strategy=IDENTITY)就不报错了



14)修改pom.xml用于指示是否生成daomanager........false为false生成daomanager.........反之不生成。当改变了项目路径即不为org.appfuse时true.

org.codehaus.mojo
appfuse-maven-plugin
${appfuse.version}


false
true




15)自动生成代码:mvn appfuse:gen -Dentity=Employee



16) mvn appfuse:install -Dentity=Employee 把生成的源代码及配置文件写入到targetclasses



17)启动项目发现乱码问题:修改displaytag_zh_CN.properties其编码规则为utf-8



18)用tomcat启动时其实只需要:如建了一个项目包e:/publicWebapp只需要拷贝一下文件进入

【1】E:workspacepublicCentersrcmainwebapp

【2】E:workspacepublicCentertargetclasses

【3】新建lib放入E:workspacepublicWebAppWEB-INF

【5】使用命令: mvn dependency:copy-dependencies下载支持包。拷贝E:workspacepublicCentertargetdependency下的包至lib。



19)直接把依赖包拷贝到LIB下面然后启动项目。这时会报一个displaytag错误。其实是tomcat里的jsp.jar和appfuse依赖包里的jsp2.0-api.jar有重叠。删去依赖包中的jsp2.0-api.jar在启动就不报错了。



20)

下面就是一些goal命令了,这里和Maven1有不少不同,常用的命令有:

创建Maven的普通java项目:mvn archetype:create -DgroupId=com.codeline.commons -DartifactId=pjoName


创建Maven的Web项目:mvn archetype:create -DgroupId=com.mycompany.app -DartifactId=my-webapp
-DarchetypeArtifactId=maven-archetype-webapp
编译源代码:mvn compile (或者:mvn compiler:compile)
编译测试代码:mvn test-compile

运行测试:mvn test

产生site:mvn site
打包:mvn package
在本地Repository中安装jar:mvn install
清除产生的项目:mvn clean
生成eclipse项目:mvn eclipse:eclipse
生成idea项目:mvn idea:idea
组合使用goal命令,如只打包不测试:mvn -Dtest package
编译测试的内容:mvn test-compile
只打jar包:mvn jar:jar
只测试而不编译,也不测试编译:mvn test -skipping compile -skipping test-compile (这里要特别注意 -

skipping 的灵活运用,当然也可以用于其他组合命令)
清除eclipse的一些系统设置:mvn eclipse:clean

根据pojo生成相关代码文件 :mvn appfuse:gen




下面具一个如何把dwr.jar包上传到本地数据仓库的例子,一看例子,大家就明了了。
- 下载dwr.jar包到本地,我把它放到了 C:/ (C盘根目录),

- 进入“命令行提示符”,进入到C:/,然后执行 mvn install:install-file -Dfile=dwr.jar -DgroupId=dwr.mocha -DartifactId=dwrDart -Dversion=1.0 -Dpackaging=jar 这样就把dwr传到了本地仓库中(我的本地仓库地址为:E:appm2repository),上传到仓库中的jar包名为dwrDart-1.0.jar目录结构为dwr/mocha/dwrDart/1.0/dwrDart-1.0.jar



====================================================================

以下为网上一朋友记录的心得



之前部门配了一个Struts2的JAVA开发框架使用情况不是很理想,想通过Appfuse了解一下别人的做法,过程无比的艰辛。如果早知道APPFUSE需要不断的下载文件,我肯定不会用。

1、项目介绍
appfuse是一个框架生成工具。如果全部设置妥当,可以通过几个简单的命令,达到生成整个JAVA开发框架的目的,想使用Struts,spring 或者其他的开源工具,而又缺少合理的开发框架的,可以一试。 APPFUSE是使用MAVEN来运行的。MAVEN和ANT类似。

2、项目的获得
查看了很多资料,走了不少弯路。不少文章说“获得APPFUSE的两种方式,MAVEN下载或者CVS”,不太准确。
最好还是下载Maven以后,再appfuse-dependencies-2.0.2.zip或者 appfuse-dependencies-2.0.1.zip解压到Maven的.m2repository目录下面去 。
环境:jdk1.5.0_11 MYSQL 5.0TOMCAT 6.0.14,apache-maven-2.0.10,appfuse-dependencies-2.0.1.zip 。
注意版本。MS因为“DLL HELL”经常受人抨击,但是JAVA的简直就是“Version hell under hell”

3、遇到的问题和解决
(1)环境变量设置。
写批处理文件的时候,“SET MAVEN_HOME=D:appfuseapache-maven-2.0.10 ;” ,后面多了一个分号,浪费了半个小时。


(2)MYSQL
在服务管理器中启动失败。查看操作系统日志内容 “ Default storage engine (InnoDB) is not available”。
网上搜索到一个解决方法:“更改 myini 里面Default storage engine=InnoDB修改为MYISAM ”,事实证明这么做不好,MYSQL是启动了,但是后面引发了其他的错误。
最后的解决:解决方法:
1、删除在MySQL安装目录下的Data目录中的ib_logfile0,ib_logfile1INFO oDBibdata1
2、重新启动MySQL的Service

(3)apache-tomcat-6.0.14.zip
跑的过程中,会自动下载apache-tomcat-6.0.14.zip ,为了节约时间,自己手动下载了一个,但是一直报错。后来发现是官方上的apache-tomcat-6.0.14.zip 出了问题,下载下来的只有4.8M,总共有6.2M。所以解压错误。

(4)SQL SERVER2005连接

把MYSQL更改为2005的时候,注意把TCP/IP打开,同时端口使用下面的IPALL 的TCP动态端口 。默认是2385

(5)SQL SERVER2005下,使用mvn appfuse:gen model命令生成POJO出错

Can't generate seam entities| org.hibernate.cfg.JDBCBinderException: Duplicate class name

因为默认了去生成DBO和SYS等用户下的所有表和视图。出现了重名的POJO,所以报错。
targettest-classeshibernate.reveng.xml 里面加入

(6)生成DAOSERVICE报错

Property 'http://apache.org/xml/features/nonvalidating/load-external-dtd' is not recognized.
org.xml.sax.SAXNotRecognizedException: Property 'http://apache.org/xml/features/nonvalidating/load-external-dtd' is not recognized.

解决:更换APPFUSE 2.0.2为2.0.1。项目作者MATT拿这个BUG没辙。。。。

(7)生成奇怪的POJO

数据库里面有Table1结果生成了Table1.java和Table1Id.java两个对象。导致后面的一系列问题。

解决:数据库里面取消双主键



最后评论一下:APPFUSE,实现了常用开源框架的自动生成,不论是Struts,struts2,springMVC等,都能直接生成从持久到逻辑和测试,甚至页面的基本文件。



==============================================================

只生成一个表的代码



1.pom.xml中增加 revengfile
org.codehaus.mojo
appfuse-maven-plugin
${appfuse.version}


src/main/resources/hibernate.reveng.ftl

${amp.genericCore}
${amp.fullSource}



2. hibernate.reveng.ftl中增加

(注意,一定要match-schema)
3. src/main/resources/jdbc.properties中增加
hibernatetool.metadatadialect=org.hibernate.cfg.reveng.dialect.OracleMetaDataDialect
=================================================================
Ejb3PropertyGetAnnotation.ftl里面的内容generateJoinColumnsAnnotation(property)修改为
${pojo.generateJoinColumnsAnnotation(propertycfg)}