你的位置:首页 > Java教程

[Java教程]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包可能找不到源头,可能你被迫必须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.

  <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>