标签:
AppFuse是一个使用Java语言开发web应用系统的集成框架。java开发人员最头痛的事情就是面对大量的框架不知该如何选择。这些框架性能如何,兼容性如何等等都需要筛选比较。Appfuse作者Matt Raible对于这些框架做了深入研究,把这些框架中最优秀的部分拿出来集成到一起,形成了最优秀的集成框架。目前这个框架的最新稳定版本是3.5.
AppFuse中的基础框架:
AppFuse提供了许多应用需要的开箱即用的功能,包括:
最新的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>
标签:
原文地址:http://www.cnblogs.com/zhaowenyuan/p/4671188.html