在webLogic 10.3中部署Hibernate 3.5出现 ClassNotFoundException解决办法

在开发Hibernate的Web项目应用时使用tomcat时运行很好，但实际生产环境中要部署到WebLogic就会出现一些ClassNotFoundException异常。

org.hibernate.QueryException: ClassNotFoundException: org.hibernate.hql.ast.HqlToken异常
这是使用Hibernate 3.0以后版本均会出现的异常；

exception is java.lang.NoSuchMethodError: javax.persistence.UniqueConstraint.name()Ljava/lang/String，如果使用Hibernate 3.5，在实体中使用了唯一约束会出现这个异常，因为在Hibernate 3.5使用了最新的Jpa 2.0，WebLogic中还是Jpa 1.0， UniqueConstraint.name在Jpa 2.0才有。

exception is java.lang.NoSuchMethodError: org.apache.commons.lang.ArrayUtils.isNotEmpty，我在项目使用了比较新版本的commons-lang-2.5.jar在webLogic 10.3会报这个异常；

在网search一下，解决ClassNotFoundException异常最常用的办法就是将出现异常类所在的jar包入到weblogic环境中的classpath最前面加载，将相应的antlr-2.7.6.jar、hibernate-jpa-2.0-api-1.0.0.Final.jar、commons-lang-2.5.jar copy到${WL_HOME/}server/lib/或其他目录，可以修改${DOMAIN_HOME}/bin/startWebLogic.sh,在CLASSPATH之前加上下面一句：

Java代码  

1. PRE_CLASSPATH=”${WL_HOME/}server/lib/antlr-2.7.6.jar:${WL_HOME/}server/lib/hibernate-jpa-2.0-api-1.0.0.Final.jar:${WL_HOME/}server/lib/commons-lang-2.5.jar”  

并将修改为CLASSPATH="${SAVE_CLASSPATH}"

Java代码  

1. CLASSPATH="${PRE_CLASSPATH}:${SAVE_CLASSPATH}"  

或者修改${DOMAIN_HOME}/bin/setDomainEnv.sh，在setDomainEnv.sh前面加入一句：

Java代码  

1. EXT_PRE_CLASSPATH=”${WL_HOME/}server/lib/antlr-2.7.6.jar:${WL_HOME/}server/lib/hibernate-jpa-2.0-api-1.0.0.Final.jar:${WL_HOME/}server/lib/commons-lang-2.5.jar”  
2. export EXT_PRE_CLASSPATH  

在我项目实践中发现加入antlr-2.7.6.jar、hibernate-jpa-2.0-api-1.0.0.Final.jar、commons-lang-2.5.jar后，前两个起作用，异常消除，commons-lang-2.5.jar没有作用，exception is java.lang.NoSuchMethodError: org.apache.commons.lang.ArrayUtils.isNotEmpty异常依旧，当时没有解决方法，只好在项目中去掉ArrayUtils.isNotEmpty，杯具!!!

后来在网上找到一种更有效解决ClassNotFoundException的，可以解决所有WebLogic中的ClassNotFoundException。改解决办法是将web项目包含进ear包中。将web项目打包成war文件，在war文件相同目录下建立META-INF目录，目录建立application.xml、weblogic-application.xml两个文件，文件内容很简单，开发过weblogic EJB应用的应该很清楚。
application.xml

Java代码  

1. <?xml version="1.0" encoding="UTF-8"?>  
2. <!DOCTYPE application PUBLIC '-//Sun Microsystems, Inc.//DTD J2EE Application 1.3//EN' 'http://java.sun.com/dtd/application_1_3.dtd'>  
3. <application>  
4.   <display-name>cckzzx</display-name>  
5.   <description>cckzzx</description>  
6.   <module>  
7.     <web>  
8.       <web-uri>cckzzx.war</web-uri>  
9.       <context-root>cckzzx</context-root>  
10.     </web>  
11.   </module>  
12. </application>  

weblogic-application.xml

Java代码  

1. <?xml version="1.0"?>  
2. <weblogic-application xmlns="http://www.bea.com/ns/weblogic/90"  
3.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">  
4.     <application-param>  
5.         <param-name>webapp.encoding.default</param-name>  
6.         <param-value>UTF-8</param-value>  
7.     </application-param>  
8.     <prefer-application-packages>  
9.         <package-name>org.apache.commons.*</package-name>     
10.         <package-name>antlr.*</package-name>  
11.         <package-name>javax.persistence.*</package-name>  
12.     </prefer-application-packages>  
13. </weblogic-application>  

<prefer-application-packages>
表示在weblogic中优先使用当前应用中的jar包
最后将war文件和META-INF目录打包成ear包、部署。在这里我参考网上资料写了一个ant脚本build.xml对项目进行ear打包
build.xml

Java代码  

1. <?xml version="1.0"?>  
2. <project name="cckzzx" default="ear" basedir=".">  
3.     <property name="project.name" value="cckzzx" />  
4.     <property name="app.dir" value="${basedir}" />  
5.     <property name="src.java.dir" value="${app.dir}/src/main/java" />  
6.     <property name="src.resources.dir" value="${app.dir}/src/main/resources" />  
7.     <property name="weblogic.home" value="/opt/Oracle/Middleware/wlserver_10.3" />  
8.     <property name="wls.username" value="weblogic" />  
9.     <property name="wls.password" value="weblogic123" />  
10.     <property name="wls.hostname" value="localhost" />  
11.     <property name="wls.port" value="7001" />  
12.     <property name="wls.server.name" value="AdminServer" />  
13.     <property name="build.dir" value="${app.dir}/build" />  
14.     <property name="build.classes.dir" value="${build.dir}/classes" />  
15.     <property name="build.tmp.dir" value="${build.dir}/tmp" />  
16.     <path id="build.classpath" description="编译时的classpath路径">  
17.         <fileset dir="${basedir}/WebRoot/WEB-INF/lib">  
18.   
19.         <include name="*.jar" />  
20.         </fileset>  
21.         <fileset dir="${weblogic.home}/server/lib">  
22. <include name="weblogic.jar" />  
23.         </fileset>  
24.         <pathelement location="${build.classes.dir}" />  
25.     </path>  
26.     <taskdef name="wldeploy" classname="weblogic.ant.taskdefs.management.WLDeploy" classpathref="build.classpath" />  
27.     <target name="clean" description="删除编译目录">  
28.         <delete dir="${build.dir}" />  
29.     </target>  
30.     <target name="prepare" depends="clean" description="创建编译目录">  
31.         <mkdir dir="${build.dir}" />  
32.         <mkdir dir="${build.classes.dir}" />  
33.         <mkdir dir="${build.tmp.dir}" />  
34.     </target>  
35.     <target name="compile" depends="prepare" description="编译">  
36. <javac srcdir="${src.java.dir}" destdir="${build.classes.dir}" compiler="org.eclipse.jdt.core.JDTCompilerAdapter" encoding="UTF-8" source="1.6" target="1.6" debug="on" deprecation="on" optimize="off" includes="**">  
37.     <classpath refid="build.classpath" />  
38.     </javac>  
39.     </target>  
40.     <target name="ear" depends="compile" description="打包EAR包">  
41.     <jar jarfile="${build.dir}/${project.name}.jar">  
42.     <fileset dir="${build.classes.dir}">  
43.     <include name="com/**/*.class" />  
44.     <include name="**/*.xml" />  
45.     </fileset>  
46.     </jar>  
47.     <mkdir dir="${build.tmp.dir}/WebRoot" />  
48.     <copy todir="${build.tmp.dir}/WebRoot">  
49.     <fileset dir="${app.dir}/WebRoot">  
50.     <exclude name="WEB-INF/classes/**" />  
51.     </fileset>  
52.     </copy>  
53.     <copy todir="${build.tmp.dir}/WebRoot/WEB-INF/lib">  
54.     <fileset file="${build.dir}/${project.name}.jar" />  
55.     </copy>  
56.     <mkdir dir="${build.tmp.dir}/WebRoot/WEB-INF/classes" />  
57.     <copy todir="${build.tmp.dir}/WebRoot/WEB-INF/classes">  
58.     <fileset dir="${src.resources.dir}" />  
59.     </copy>  
60.     <war warfile="${build.dir}/${project.name}.war" webxml="${build.tmp.dir}/WebRoot/WEB-INF/web.xml">  
61.     <fileset dir="${build.tmp.dir}/WebRoot">  
62.     <exclude name="WEB-INF/web.xml" />  
63.     </fileset>  
64.     </war>  
65.     <ear earfile="${build.dir}/${project.name}.ear" appxml="${app.dir}/src/weblogic/META-INF/application.xml">  
66.             <fileset dir="${app.dir}/src/weblogic">  
67.                 <include name="META-INF/weblogic-application.xml" />  
68.     </fileset>  
69.     <fileset dir="${build.dir}">  
70.     <include name="${project.name}.war" />  
71.     </fileset>  
72.     </ear>  
73.   
74.     <delete file="${build.dir}/${project.name}.jar" />  
75.     <delete file="${build.dir}/${project.name}.war" />  
76.     <delete dir="${build.classes.dir}" />  
77.     <delete dir="${build.tmp.dir}" />  
78.     </target>  
79.   
80.     <target name="deploy" depends="ear,undeploy" description="布署EAR服务">  
81.         <wldeploy action="deploy" name="${project.name}" source="${build.dir}/${project.name}.ear" targets="${wls.server.name}" user="${wls.username}" password="${wls.password}" adminurl="t3://${wls.hostname}:${wls.port}" debug="true" verbose="true" failοnerrοr="true" />  
82.     <echo message="come here......" />    <echo message="deploy success......." />  
83.     </target>  
84.     <target name="undeploy" description="删除EAR服务">  
85.     <wldeploy action="undeploy" name="${project.name}" targets="${wls.server.name}" user="${wls.username}" password="${wls.password}" adminurl="t3://${wls.hostname}:${wls.port}" debug="false" verbose="false" failοnerrοr="false" />  
86.     </target>  
87. </project>  

如果项目中使用了泛型，使用该脚本如果抛出无法确定 T 的类型参数；对于上限为 T ,java.lang.Object 的类型变量 T，不存在唯一最大实例异常，在eclipse中可以编译运行，为什么用ant就不行了呢？
解决方法是在classpath加入${eclipse_home}/plugins/org.eclipse.jdt.core_3.6.1.v_A68_R36x.jar和从org.eclipse.jdt.core_3.6.1.v_A68_R36x.jar解决出来的jdtCompilerAdapter.jar两个包。