AppFuse3.5对接oracle数据库

yxsailing

　　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包可能找不到源头，可能你被迫必须FQ（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>