APPFUSE2使用说明及常见问题解决方法

日志原文：http://javafan.blog.sohu.com/94936274.html
APPFUSE2使用说明及常见问题解决方法

APPFUSE2使用说明及常见问题解决方法
配置好MAVEN_HOME,JAVA_HOME 这个就不废话了:P

------------------------------------------------------------------------------------------
步骤:(以下步均为在命令行的输入)
------------------------------------------------------------------------------------------
第一步 通过APPFUSE创建基于Struts 2 Basic的项目：
mvn archetype:create -DarchetypeGroupId=org.appfuse.archetypes -DarchetypeArtifactId=appfuse-basic-struts -DremoteRepositories=http://static.appfuse.org/releases -DarchetypeVersion=2.0.1 -DgroupId=com.yourproject -DartifactId=yourproject
执行完毕后CD到yourproject目录中

第二步：加入ECLIPSE工程文件，方便导入到ECLIPSE
mvn eclipse:eclipse

第三步：修改yourproject/pom.xml 配置文件
1.修改生成代码方式，找到
<genericCore>${amp.genericCore}</genericCore>
<fullSource>${amp.fullSource}</fullSource>
修改成：
<genericCore>false</genericCore>
<fullSource>true</fullSource>
注意，这里必须吧pom.xml中的genericCore属性设为false 否则只会生成Action
2.数据库配置信息(mysql在最底下)

第四步：生成MODEL类
先执行，这样会把默认需要的相关类先生成
mvn appfuse:full-source
然后执行
mvn appfuse:gen-model

第五步：修改/src/main/resources/hibernate.cfg.xml添加需要生成dao,service,action,jsp的模块

第六步：生成Dao,Service,Action
mvn appfuse:gen -Dentity=你的MODEL类
这里可能会有一个提示找不到/src/main/resources/database.properties, 可以不用理会
如果设置了很复杂的关联，这个生成过程会很痛苦，老是报targeting an unmapped的错，
我的解决方法是找到关联的类比如USER，先把关系映射方法和属性删掉，
然后在再把/src/main/resources/hibernate.cfg.xml其他的类声明删掉
生成成功后再把这些加上去.
第七步: 把生成的配置文件写入到src目录下的配置文件中
mvn appfuse:install
最后执行mvn jetty:run-war 即可打包并运行项目

打完收工

总结：DAO和service的配置文件会生成到：/src/main/webapp/applicationContext.xml中
struts的配置文件会生成到：/src/main/resources/struts.xml中
------------------------------------------------------------------------------------------
常用的命令介绍：
------------------------------------------------------------------------------------------
mvn appfuse:gen-model 根据数据库的表生成java类
mvn appfuse:gen 根据 POJOs.生成并安装 Tests, DAOs, Managers, Controllers and Views
mvn appfuse:full-source 把运行所需要的org.appfuse中的依赖类转换成你的包名称
mvn eclipse:eclipse 生成eclipse的项目的配置文件，用户可以直接把项目导入到eclipse中
mvn jetty:run-war 打包并且发布你的应用程序到Jetty, 查看在 http://localhost:8080
mvn appfuse:install 把生成的源代码及配置文件写入到src中
mvn integration-test 启动TOMCAT(或别的服务器)进行测试
mvn appfuse:remove 删除appfuse:gen.生成的代码
mvn appfuse:clean 清除target下的所有内容
------------------------------------------------------------------------------------------
需要注意的问题：
------------------------------------------------------------------------------------------
1.必须吧pom.xml中的genericCore属性设为false 否则只会生成Action

3.运行后出现gzip 该问题是压缩HTML的包导致，暂时屏蔽掉相关filter

4.使用ehcache1.3以前的版本生成的代码界面字符会变成问号，这是因为maven无法下载正确的ehcache包造成，解决方法是修改/pom.xml ，在里面加上：
<dependency>
<groupId>net.sf.ehcache</groupId>
<artifactId>ehcache</artifactId>
<version>${ehcache.version}</version>
</dependency>
<ehcache.version>1.4.1</ehcache.version>
后再生成代码

5.当某张数据表被修改需要更新相应的model时，只需执行mvn appfuse:gen -Dentity=yourmodel
当添加新的数据表时间，除了执行mvn appfuse:gen -Dentity=yourmodel外，还需要执行
mvn appfuse:install 来把DAO,STRUTS配置写入到SRC下的相应文件中.

6.如果希望生成的model类不在默认的model包根下，只需要在resources/hibernate.cfg.xml中修改想要生成的包路径就行，比如：
默认情况下UserInfo会生成到com.my.app.model下，把配置改成
<mapping class="com.my.app.model.user.UserInfo"/>
UserInfo会生成到com.my.app.model.user下。

7.使用Candy for Appfuse 插件时发现model都无法生成,
这是因为%MAVEN_HOME%\conf\settings.xml 中localRepository属性默认为~/.m2/repository
~即当前用户在系统中的用户目录，比如WINDOWS在c:\Documents and Settings\username
因为路径中包含空格，所以Candy找不到，解决方法就是在命令行操作

8.关于乱码的问题
对于APPFUSE生成的工程运行时乱码是很常见的现象，造成该现象的原因也有几种：
为了偷懒，这里引用一篇网上的文章：http://www.blogjava.net/43880800/archive/2006/11/18/81892.html

对于国际化文件*.properties文件的编辑，有两个ECLIPSE插件可以推荐：Properties Editor 和 ResourceBundleEditor
再次偷懒引用一篇网文：http://blog.csdn.net/lmjq/archive/2007/06/21/1660137.aspx

不过我的IDE有点问题，这两个都装上却不好使，不知道是怎么回事。用了个笨方法：写个批处理来做。内容如下：
echo begin encoding
start C:\Progra~1\Java\jdk1.6.0\bin\native2ascii -encoding UTF-8 d:\workspace\dayawa\src\ApplicationResources_zh.properties d:\workspace\dayawa\src\ApplicationResources_zh_CN.properties
echo done!

保存成 encodeProperties.bat 执行就行，当然，相关路径要设置成你的实际路径。

9. 执行“mvn jetty:run-war”时，会根据POJO先删除数据库里的表再重建，如果不想对数据进行操作可以修改pom.xml，将<configuration>下的drop熟悉修改为 false。不过执行“mvn jetty:run-war”仍然会执行建表操作，出现大量的错误日志，不过没有影响。

10. 执行“mvn jetty:run-war”时，会清空数据表的数据并插入默认的数据，默认的数据在%PROJECT_HOME%\src\main\ resources\default-data.xml配置，这个很讨厌。修改pom.xml中的<dbunit.operation.type>的配置为NONE可以屏蔽这部分操作。

11.在注册新用户时，如果用户名或邮件已经被注册，返回表单改后提交报DataIntegrityViolationException， 这是appfuse的一个BUG，解决方法：

修改UserSecurityAdvice.before()
在最后的else里加上:user.setVersion(null);

修改UserManagerImpl.saveUser():把最后的try改成：
try {
return dao.saveUser(user);
} catch (DataIntegrityViolationException e) {
throw new UserExistsException(e.getCause().getCause().toString());
} catch (EntityExistsException e) { // needed for JPA
throw new UserExistsException(e.getCause().getCause().getMessage());
}
然后在SignupAction.save()改成：
if(user==null){
this.addActionMessage(getText("signup.welcome"));
return INPUT;

}
user.setEnabled(true);
//user.setRegistTime(new Date());
// Set the default user role on this new user
user.addRole(roleManager.getRole(Constants.USER_ROLE));

try {
userManager.saveUser(user);
} catch (AccessDeniedException ade) {
// thrown by UserSecurityAdvice configured in aop:advisor userManagerSecurity
log.warn(ade.getMessage());
getResponse().sendError(HttpServletResponse.SC_FORBIDDEN);
ade.printStackTrace();
return null;
} catch (UserExistsException e) {
log.warn("message "+e.getMessage());
List<String> args = new ArrayList<String>();

if(e.getMessage().indexOf("'"+user.getUsername()+"'")!=-1){
args.add(user.getUsername());
addActionError(getText("errors.existing.username", args));
}else{
args.add(user.getEmail());
addActionError(getText("errors.existing.email", args));
}
// redisplay the unencrypted passwords
user.setPassword(user.getConfirmPassword());
//to fix the bug that is when username exists and changed newusername throw Incorrect result size: expected 1, actual 0 Exception

user.setVersion(null);
//e.printStackTrace();
return INPUT;
}
saveMessage(getText("user.registered"));
getSession().setAttribute(Constants.REGISTERED, Boolean.TRUE);
// log user in automatically
UsernamePasswordAuthenticationToken auth = new UsernamePasswordAuthenticationToken(
user.getUsername(), user.getConfirmPassword(), user.getAuthorities());
auth.setDetails(user);
SecurityContextHolder.getContext().setAuthentication(auth);
// Send an account information e-mail
mailMessage.setSubject(getText("signup.email.subject"));

try {
sendUserMessage(user, getText("signup.email.message"), RequestUtil.getAppURL(getRequest()));
} catch (MailException me) {
addActionError(me.getCause().getLocalizedMessage());
me.printStackTrace();
}
return SUCCESS;