appfuse2.0.2在eclipse下的开发和使用

1．准备工作
包括JDK 5+、MySQL 5.x和Maven 2.1.0。Maven的环境变量配置：新建变量名为“M2_HOME”，路经为Maven根目录的环境变量，然后在Path中添加“;%M2_HOME%\bin”。如果你不想在线下载工程的依赖包,可以到appfuse-dependencies-2.0.2.zip下载,然后解压,并且将maven目录下conf文件夹下的settings.xml的localRepository变量设置为你刚刚解压的路径如C:\Docume~1\%username%\.m2\repository

2. 创建工程
接下来我们习惯性的想要去寻找AppFuse的工程源码，其实这个完全没有必要，Maven全部为我们代劳了。当然前提条件是你的机器必须能够上网。

因为我一直使用的都是struts+spring+ibatis的框架，所以接下来就是构建这个工程了。

进入命令行窗口，转到想要存放工程的路径下，输入
mvn archetype:create -DarchetypeGroupId=org.appfuse.archetypes -DarchetypeArtifactId=appfuse-basic-struts -DremoteRepositories=http://static.appfuse.org/releases -DarchetypeVersion=2.0.1 -DgroupId=com.mycompany.app -DartifactId=myproject
其中的-DgroupId和-DartifactId可以修改为自己想要的包名和工程名。如果你下载了上面的依赖包的话,"-DremoteRepositories=http://static.appfuse.org/releases "这个就不用加了

使用其它框架的可以到http://appfuse.org/display/APF/AppFuse+QuickStart查找相应的命令。

命令执行完，显示BUILD SUCCESSFUL后，进行下一步。

3．配置数据库
打开工程根目录下的pom.xml，找到最后一个<jdbc.username>和<jdbc.password>，即MySQL的配置项，把用户名和密码修改为自己MySQL的配置。AppFuse默认root用户的密码为空，如果你的数据库是这样设置的，当然就不用改了。

4. 因为appfuse默认的是hibernate,所以要修改为ibatis工程(修改pom.xml)

     ①删掉文件中的**/hibernate.cfg.xml

     ②把这个<artifactId>appfuse-hibernate</artifactId>改成<artifactId>appfuse-ibatis</artifactId>

     ③<dao.framework>hibernate</dao.framework>改为<dao.framework>ibatis</dao.framework>

     ④在<properties></properties>中加上<ibatis.version>2.3.4.726</ibatis.version>

 

5．运行工程
在命令行进入工程根目录，运行mvn，Maven开始下载jar包、Tomcat和运行集成测试。这一工作需要的时间还是挺长的，我的机器运行了半小时以上，所以你可以先去干点别的。如果你有了第一步的依赖包,就会节省很多时间.

接下来有可能会提示没有mysql-schema.sql文件,所以你建一个空的就可以了,再次运行mvn

接下来运行mvn jetty:run-war，Maven开始打包、发布程序，并启动Jetty，运行完成后，你就可以通过http://localhost:8080，使用admin/admin或者user/user登录，浏览这个web应用了。

从表面看，除了样式，功能没有多少变化。

5．开发工程
到现在的阶段还看不到工程源码，接下来运行mvn appfuse:full-source，如果你的操作系统是Windows，会有一个Ant1.7.0的bug而导致构建失败，解决办法要么下载Ant1.7.1（似乎目前还未发布），要么是在C:\Documents and Settings\%username%\.m2下建立一个settings.xml文件（其中username是你当前进入系统的用户名），内容是
<?xml version="1.0" encoding="UTF-8"?>
<settings>
    <localRepository>C:\Docume~1\%username%\.m2\repository</localRepository>
</settings>

重新运行mvn appfuse:full-source，工程源码就下载到工程目录下了。

其实这个路径C:\Docume~1\%username%\.m2\repository就是第一步你的依赖包解压位置,如果你已经在maven的settings文件配置了的话,这个settings.xml可以不用了

运行mvn install eclipse:eclipse，生成eclipse项目文件，这一过程也需要半小时左右。然后使用Eclipse打开它，可以欣赏最新的AppFuse源码了。如果你是下载并配置了appfuse-dependencies-2.0.2.zip,可以使用这个命令mvn clean eclipse:eclipse -o,就省略了下载jar的过程.

接下来还有一个问题，eclipse找不到jar包，源码里全是红叉。打开Java Build Path，发现有大量引用M2_REPO，大概eclipse不知道这个文件夹在哪里。添加一个变量，名字M2_REPO，路径指到C:\Docume~1\%username%\.m2\repository，确定后系统提示要重新编译，之后大部分红叉都会消失了。
 以下的附件是我的pom.xml文件,这个可以根据自己的需要定制的.