AppFuse 3常见问题与解决方法
起步
使用appfuse的第一步自然是通过archetype:generate生成项目。这本不是一问题，官方的QuickStart：http://appfuse.org/display/APF/AppFuse+QuickStart 页面上给出了帮助我们生成archetype:generate命令行的工具，不幸的是这个页面引用了一些位于googleapis.com上的js文件，中国的小朋友们可能获取不了这些文件（原因你懂的）。至少在写作这篇文章的时候googleapis.com是无法从国内訪问的。假设缺少这些JS文件，页面就不能自己主动生成命令行了，尽管这个命令本身并不复杂，可是手写出它的archetypeRepository地址和archetypeArtifactId还是非常费力的，以下给出四个演示样例，可依此为蓝本进行改动：
演示样例一：建立名称为demo的基于spring mvc+spring+hibernate的单一project，appfuse版本号：3.0.0
mvn archetype:generate -B -DarchetypeGroupId=org.appfuse.archetypes -DarchetypeArtifactId=appfuse-basic-spring-archetype -DarchetypeVersion=3.0.0 -DgroupId=com.yourcompany -DartifactId=demo -DarchetypeRepository=https://oss.sonatype.org/content/repositories/appfuse
演示样例二：建立名称为demo的基于spring mvc+spring+hibernate的单一project，appfuse版本号：3.0.1-SNAPSHOT
mvn archetype:generate -B -DarchetypeGroupId=org.appfuse.archetypes -DarchetypeArtifactId=appfuse-basic-spring-archetype -DarchetypeVersion=3.0.1-SNAPSHOT -DgroupId=com. yourcompany -DartifactId=demo -DarchetypeRepository=https://oss.sonatype.org/content/repositories/appfuse
演示样例三：建立名称为sample的基于spring mvc+spring+hibernate的多模块project。appfuse版本号：3.0.0
mvn archetype:generate -B -DarchetypeGroupId=org.appfuse.archetypes -DarchetypeArtifactId=appfuse-modular-spring-archetype -DarchetypeVersion=3.0.0 -DgroupId=com. yourcompany -DartifactId=sample -DarchetypeRepository=https://oss.sonatype.org/content/repositories/appfusec
演示样例四：建立名称为sample的基于spring mvc+spring+hibernate的多模块project，appfuse版本号：3.0.1-SNAPSHOT
mvn archetype:generate -B -DarchetypeGroupId=org.appfuse.archetypes -DarchetypeArtifactId=appfuse-modular-spring-archetype -DarchetypeVersion=3.0.1-SNAPSHOT -DgroupId=com. yourcompany -DartifactId=sample -DarchetypeRepository=https://oss.sonatype.org/content/repositories/appfusec
生成项目之后。依照官方文档的指导非常easy就能够build并运行新建立起来的project了。可是假设你不走运的话，就可能会遇到例如以下一些问题：
问题与解决方法
问题一：
使用3.0.0版本号，运行mvn appfuse:full-source失败，使用 mvn appfuse:full-source -e查看错误信息。报例如以下错误：
[ERROR] Failed to execute goal org.appfuse.plugins:appfuse-maven-plugin:3.0.0:full-source (default-cli) on project demo: Execution default-cli of
goal org.appfuse.plugins:appfuse-maven-plugin:3.0.0:full-source failed: java.net.UnknownHostException: raw.github.com: Unknown host raw.github.com
解决方法：
对于该问题，appfuse的作者在http://appfuse.547863.n4.nabble.com/Appfuse-failed-to-get-full-source-td4657086.html 中给出了解释，原因是github更改的子域名导致的。为此作者新建了一个3.0.1-SNAPSHOT版本号来解决这一问题。
就我个人的使用情况来看这是一个非常奇怪的问题。第一次运行mvn appfuse:full-source确实遇到了这一问题。第二天就没有问题了，理论上raw.github.com会重定向到新的目标域名，可是看起来受到网络以及配置的种种原因，这个问题确实是有可能发生的。只是使用3.0.1-SNAPSHOT版本号并不是是一个好的解决方法，接下来的常见问题二就是发生在3.0.1-SNAPSHOT版本号上的。
问题二：
使用3.0.1-SNAPSHOT版本号。运行mvn jetty:run时报例如以下错误：
java.lang.IllegalStateException: org.slf4j.LoggerFactory could not be successfully initialized.解决方法：
这个问题确实是开发人员给使用者挖的一个“坑”，只从报错日志上非常难找到直接原因，可是日志中的一行信息：
An API incompatibility was encountered while executing org.eclipse.jetty:jetty-maven-plugin:xxxxxx:run: java.lang.ExceptionInInitializerError: null
多少还是给了我们一些线索。检查使用3.0.1-SNAPSHOT版本号生成的pom.xml文件，我们发现jetty插件的配置是这种：
<plugin> <groupId>org.eclipse.jetty</groupId> <artifactId>jetty-maven-plugin</artifactId> <version>8.1.14.v20131031</version> <configuration> <webApp> <contextPath>/</contextPath> </webApp> </configuration> </plugin>
再细致地检查，我们就会发现jetty迁移eclipse之后，其版本号是从9.0.0開始的，根本没有8.1.14.v20131031这个版本号，而这个8.1.14.v20131031版本号是怎么来的呢？看看3.0.0的pom.xml我们找到了答案：
<plugin> <groupId>org.mortbay.jetty</groupId> <artifactId>jetty-maven-plugin</artifactId> <version>8.1.14.v20131031</version> <configuration> <webApp> <contextPath>/</contextPath> </webApp> </configuration> </plugin>
8.X版本号的jetty还是其在mortbay下时的版本号。非常显然，作者在从3.0.0向3.0.1-SNAPSHOT升级的时候，配错了jetty的版本号！
这样，解决方法也就出来了，把插件配置中的<groupId>org.eclipse.jetty</groupId>改为<groupId>org.mortbay.jetty</groupId>就能够了。
问题三：
乱码
解决方法：
请參考还有一篇文章：AppFuse 3的乱码问题
建议
因为3.0.1-SNAPSHOT尚处于开发阶段，在不同一时候期使用可能会出现不同的问题，前文提及的第二个问题就是一个样例，因此建议先使用3.0.0版。
