AppFuse3.5对接oracle数据库

AppFuse是一个使用Java语言开发web应用系统的集成框架。java开发人员最头痛的事情就是面对大量的框架不知该如何选择。这些框架性能如何，兼容性如何等等都需要筛选比较。Appfuse作者Matt Raible对于这些框架做了深入研究，把这些框架中最优秀的部分拿出来集成到一起，形成了最优秀的集成框架。目前这个框架的最新稳定版本是3.5.

AppFuse中的基础框架:

• Bootstrap 和jQuery
• Maven, Hibernate, Spring 和Spring Security
• Java 7, Annotations, JSP 2.1, Servlet 3.0
• Web框架: GWT, JSF, Struts 2, Spring MVC, Tapestry 5, Wicket
• JPA

AppFuse提供了许多应用需要的开箱即用的功能，包括:

• 验证和授权
• 用户管理
• 记住我 (保存登录信息，不必每次都登录)
• 密码提示
• 注册和登记
• SSL切换
• 电子邮件
• Extension-less URLs （不知道该怎么翻译，求助！！！）
• 文件上传
• 生成CRUD后端
• 完全支持Eclipse, IDEA 和NetBeans
• 使用Maven和Jetty等插件，进行快速启动和部署
• 使用Cargo以及Maven的多模式选项（profiles）支持多种前台应用和多种数据库的选择部署，并且做到可测试

最新的AppFuse和Maven关系紧密。几乎所有的操作都通过Maven来执行，所以要对Maven以及模块化开发有一定的了解，对Maven profiles有比较深入的了解，对Maven的仓库结构也需要有一定了解。

AppFuse支持多种数据库（Derby、H2、HSQLDB、MySQL、Oracle、PostgreSQL、SQL Server），默认数据库是MySQL。在我切换到Oracle数据库的时候，发现了一下问题，才有了此文。下面我介绍发现的问题和解决方法。

1.首先下载安装Maven 3.1.0+，网上有很多教程，这里就不赘述了。当然，你还需要JDK7+， MySQL 5.5+ 。

2.使用Maven生成包含AppFuse框架的空项目：

mvn archetype:generate -B -DarchetypeGroupId=org.appfuse.archetypes -DarchetypeArtifactId=appfuse-modular-spring-archetype -DarchetypeVersion=3.5.0 -DgroupId=com.myCompany.myProject -DartifactId=myProject -DarchetypeRepository=https://oss.sonatype.org/content/repositories/appfuse

首先解释一下：这是个mvn生成（archetype:generate）框架代码的命令，后续会用到。其中myCompany是公司名称，myProject是项目名称。AppFuse版本是3.5.0。最关键的部分是appfuse-modular-spring-archetype，modular代表多模块，spring代表前段框架是spring MVC。

启动命令行（cmd）。修改当前目录到Java的workspace（你想要放置代码的目录）。输入上面的一大串以mvn开头的字符，回车。由于天朝众人皆知的原因和Google的退出，有些jar包可能找不到源头，可能你被迫必须翻墙（FreeGate）才能完成这个命令。也可能由于网速太慢，下载超时，你需要反复尝试上面的命令。

总之，需要艰辛的努力，还可能需要一些非常规手段。。。

神奇的事情发生了，你发现你的workspace下面多了一个文件夹。

别着急，你还需要小小的几步。

3.下载框架中用到的源代码和模板。

mvn appfuse:full-source

这个时候如果系统运行环境JDK和数据库MySql（root的密码为空）已经准备好，就可以到web目录下运行命令mvn jetty:run部署启动项目，登录http://localhost:8080访问你的项目了！

4.生成项目文件。

命令行当前目录切换到myproject目录下。如果你使用的是eclipse，你可以运行：mvn eclipse:eclipse 命令。如果你使用的是idea，运行：mvn idea:idea。项目文件和相关依赖会生成。

5.切换到Oracle数据库。

AppFuse为我们准备了多款数据库选择（profiles）。查看这些profiles，可以键入以下命令：

mvn help:full-profiles

显示全部可以profiles。

mvn help:active-profiles

显示激活的profiles。

本来事情很简单，我们只需要执行以下命令即可切换到oracle.

mvn clean install -P oracle

清除项目生成的文件，并安装oracle Profile。

但执行过程中报了三个错误，导致执行失败。

问题1：找不到odbc jar包。

我们到Maven的仓库中找到oracle相关的仓库：C:\Users\[localUser]\.m2\repository\com\oracle\ojdbc14\10.2.0.2.0。这个仓库是由AppFuse生成的，但下面缺少Jar包。我们需要从Oracle网站上下载一个10.2.0.2.0版本对应的ojdbc14-.jar放到这个目录下面，并且改名为：ojdbc14-10.2.0.2.0.jar。

也有人觉得现在oracle版本已经12了，还用10的驱动，有点过时。你可以安装自己的oracle库。方法是下载oracle相应jar，执行maven命令安装jdbc依赖。我正好安装了oracle数据库11.2G，就用它的驱动了，省的下载。

mvn install:install-file -Dfile=C:\app/[localUser]/product/11.2.0/dbhome_1/jdbc/lib/ojdbc6_g.jar -DgroupId=com.oracle -DartifactId=ojdbc6 -Dversion=11.2.0 -Dpackaging=jar

如果你本机没有装Oracle，或者全局数据库名不是XE，你可能需要修改默认的数据库连接选项。打开文件：C:\Users\[localUser]\.m2\repository\org\appfuse\appfuse\3.5.0\appfuse-3.5.0.pom。做好备份。找到oracle相关的profile，修改成下面的样子：

        <profile>
            <id>oracle</id>
            <properties>
                <dbunit.dataTypeFactoryName>org.dbunit.ext.oracle.OracleDataTypeFactory</dbunit.dataTypeFactoryName>
                <dbunit.schema>MYPROJECT</dbunit.schema>
                <!-- Make sure to capitalize the schema name -->
                <!--<dbunit.operation.type>CLEAN_INSERT</dbunit.operation.type>-->
                <hibernate.dialect>org.hibernate.dialect.Oracle10gDialect</hibernate.dialect>
                <hibernate.export.schema.delimiter></hibernate.export.schema.delimiter>
                <jdbc.groupId>com.oracle</jdbc.groupId>
                <jdbc.artifactId>ojdbc6</jdbc.artifactId>
                <jdbc.version>11.2.0</jdbc.version>
                <jdbc.driverClassName>oracle.jdbc.OracleDriver</jdbc.driverClassName>
                <jdbc.url><![CDATA[jdbc:oracle:thin:@localhost:1521:Orcl]]></jdbc.url>
                <jdbc.username>myproject</jdbc.username>
                <jdbc.password>myproject</jdbc.password>
                <jdbc.validationQuery><![CDATA[SELECT 1 + 1 from DUAL]]></jdbc.validationQuery>
            </properties>
        </profile>

其中myproject是我专门为该项目创建的数据库。本机数据库的全局实例名是orcl。jdbc也改成了11.2的。还有一些更改后续会提到。

问题2：数据库脚本无法执行。到myproject\core\target目录下，找到schema.sql。打开查看，发现一切正常，你到sqlplus下面执行这个sql文件也没有问题。

文件发生的原因是这个sql不是由sqlplus执行的，而是2.有hibernate执行的！hibernate执行sql语句的时候，不能有段落结束符合“；”。所以报错！解决办法是在appfuse-3.5.0.pom中的oracle profile中增加一个设置，把段落分割符设置成空：

<hibernate.export.schema.delimiter></hibernate.export.schema.delimiter>

这样问题就解决了！

问题3：单元测试不能通过。报一个奇怪的错误：

Tests run: 9, Failures: 0, Errors: 1, Skipped: 0, Time elapsed: 2.167 sec <<< FAILURE!
testUpdateUser(com.exam.dao.UserDaoTest)  Time elapsed: 0.088 sec  <<< ERROR!
java.lang.Exception: Unexpected exception, expected<org.springframework.dao.DataIntegrityViolationException> but was<org.springframework.orm.hibernate4.HibernateSystemException>

这个问题已经被提交到AppFuse的邮件列表中，但是还没有正面的回复，只有一个规避的办法。深层次的原因需要有能力的人继续挖掘！

规避办法是注释掉测试代码UserDaoTest.java的第68行：//user2.setRoles(user.getRoles());

        user2.setLastName(user.getLastName());
        user2.setPassword(user.getPassword());
        user2.setPasswordHint(user.getPasswordHint());
        //user2.setRoles(user.getRoles());
        user2.setUsername(user.getUsername());
        user2.setWebsite(user.getWebsite());

修改了这几个问题，oracle profile就会成功激活，测试通过并生成jar包、war包。

另外，我修改oracle数据库profile(appfuse-3.5.0.pom)的方式比较不可取，更科学的方式是修改myproject下面的pom.xml.

    <properties>
        ...其他设置
        <!-- 为链接oracle数据库添加了以下设置项，这些设置项的默认值指向mysql数据库 -->
        <dbunit.dataTypeFactoryName>org.dbunit.ext.oracle.OracleDataTypeFactory</dbunit.dataTypeFactoryName>
        <dbunit.schema>MYPROJECT</dbunit.schema>
        <hibernate.dialect>org.hibernate.dialect.Oracle10gDialect</hibernate.dialect>
        <jdbc.groupId>com.oracle</jdbc.groupId>
        <jdbc.artifactId>ojdbc6</jdbc.artifactId>
        <jdbc.version>11.2.0</jdbc.version>
        <jdbc.driverClassName>oracle.jdbc.OracleDriver</jdbc.driverClassName>
        <jdbc.url><![CDATA[jdbc:oracle:thin:@localhost:1521:Orcl]]></jdbc.url>
        <jdbc.username>myproject</jdbc.username>
        <jdbc.password>myproject</jdbc.password>
        <jdbc.validationQuery><![CDATA[SELECT 1 + 1 from DUAL]]></jdbc.validationQuery>
    </properties>