用m2clipse构建appfuse-basic-struts-archetype(v2.1.0-M1)

1、新建一Maven project工程。选择Archetype时选取appfuse-basic-struts-archetype(v2.1.0-M1)，在填写maven坐标时使包名与Group Id相同（如果不同在用appfuse自动生成Pojo,dao,service代码时包名会不一样，即自动生成代码时appfuse默认会用Group Id作为主包名）。在成功生成初始工程后系统会报错,，此错误可能是appfuse的bug,默认会多一层包（即在会在用户指定包名后多了一个".webapp",但生成类的代码中的包名为正确）,解决办法，将src/main/java和src/test/java下包多出的包名部分从物理硬盘中删除对应的文件夹，注意不能用eclipse修改包名的方法删除，这样会报错的。

2、打开pom.xml文件修改对应的数据库连接配置，然后解决appfuse2中displaytag中文乱码问题，具体修改对应代码为如下（红字为修改部分）：
<plugin>
                <groupId>org.codehaus.mojo</groupId>
                <artifactId>native2ascii-maven-plugin</artifactId>
                <version>1.0-alpha-1</version>
                <configuration>
                    <dest>target/classes</dest>
                    <src>src/main/resources</src>
                </configuration>
                <executions>
                    <execution>
                        <id>native2ascii-utf8</id>
                        <goals>
                            <goal>native2ascii</goal>
                        </goals>
                        <configuration>
                            <encoding>UTF8</encoding>
                            <includes>
                                ApplicationResources_ko.properties,
                                ApplicationResources_no.properties,
                                ApplicationResources_tr.properties,
                                *_zh*.properties
                            </includes>
                        </configuration>
                    </execution>
                    <execution>
                        <id>native2ascii-8859_1</id>
                        <goals>
                            <goal>native2ascii</goal>
                        </goals>
                        <configuration>
                            <encoding>8859_1</encoding>
                            <includes>
                                ApplicationResources_de.properties,
                                ApplicationResources_fr.properties,
                                ApplicationResources_nl.properties,
                                ApplicationResources_pt*.properties
                            </includes>
                        </configuration>
                    </execution>
                </executions>
            </plugin>

以及——

<resource>
                <directory>src/main/resources</directory>
                <excludes>
                    <exclude>ApplicationResources_de.properties</exclude>
                    <exclude>ApplicationResources_fr.properties</exclude>
                    <exclude>ApplicationResources_ko.properties</exclude>
                    <exclude>ApplicationResources_nl.properties</exclude>
                    <exclude>ApplicationResources_no.properties</exclude>
                    <exclude>ApplicationResources_pt*.properties</exclude>
                    <exclude>ApplicationResources_tr.properties</exclude>
                    <exclude>*_zh*.properties</exclude>
                    <exclude>applicationContext-resources.xml</exclude>
                    <exclude>struts.xml</exclude>
                </excludes>
                <filtering>true</filtering>
            </resource>

3、用cmd进入工程对应文件夹并运行mvn下载所有的包和文件 和mvn jetty:run-war 可通过http://localhost:8080访问程序

4、如果不想用appfuse的jar包可运行 mvn appfuse:full-source，此命令会将appfuse中的源代码抽出来，并将包名修改为你项目的包名，同时将源代码放入项目的源码文件夹中，这样所有你项目中用到的appfuse类都变成了你自己的类。同时会修改pom.xml以适合你的工程，修改后属性amp.fullSource的值为 <amp.fullSource>true</amp.fullSource>，此属性表示此工程已运行过mvn appfuse:full-source，即不再依赖appfuse的包。如果在运行命令时报像“''svn: PROPFIND request failed on'' ”的错则在org.appfuse.plugins的节点<configuration>下加上<trunk>https://svn.java.net/svn/appfuse~svn/</trunk>

5、由表生成model （pojo），然后由model 生成action、service、dao和对应的页面，以及设置相应的配置文件。首行创建表employee
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;
然后运行命令mvn appfuse:gen-model 会在model包中生成Employee.java，但是会报错， 查看原代码，原来model中有两个ID的生成策略，如下：
@Id @GeneratedValue(strategy=IDENTITY) @GeneratedValue(strategy = GenerationType.AUTO)
删除@GeneratedValue(strategy=IDENTITY)，只剩下一个。
接下来是由model 生成CRUD：在项目下的pom.xml中查找genericCore，找到 将属性true 改为false，不修改默认将不会生成dao和service，然后运行命令mvn appfuse:gen -Dentity=Employee 将会生成相应的employeeList.jsp、employeeForm.jsp、EmployeeAction.java 和对应的dao、service。运行 mvn jetty:run 在浏览器中查看界面吧，相应连接都已在界面中。


6、配置eclipse运行调试环境。打开eclipse并刷新工程文件，然后选择菜单栏run下的run Configurations..进入运行设置窗口。新建一Maven Build设置，命名为mvn jetty run，在Base directory中选择或填写对应的工程，然后在Goals中填入命令jetty:run，并勾选下面的Skip Tests（此项可在运行时跳过测试，也在在pom.xml 的属性中新建<skipTests>true</skipTests>），确定运行。配置完后即可在pom.xml上右击，选择run呀debug中的maven build，然后选择mvn jetty run运行或调试启动jetty.

7、常用的命令介绍：
------------------------------------------------------------------------------------------

mvn war:inplace 将war中的文件放入 自己的项目的webapp目录
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       编译并发布你的应用程序到Jetty, 查看在 http://localhost:8080
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;





  12、如果要跳过单元测试在<properties>添加 <skipTests>true</skipTests>