Apache CXF 在 WebLogic 9.2 上的问题定位分析及权宜之计

http://yulimin.javaeye.com/blog/129015

同样的程序在 Tomcat 5.5.16/25 以及 Jetty 5.1.12 上都能够成功部署及运行，但是部署到 WebLogic 9.2 上时出错
org.springframework.web.context.ContextLoader initWebApplicationContext
FATAL: Context initialization failed
org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'xxxWebService': Invocation of init method failed; nested exception is java.lang.NoSuchMethodError: portName
Caused by: java.lang.NoSuchMethodError: portName
at org.apache.cxf.jaxws.support.JaxWsImplementorInfo.getEndpointName(JaxWsImplementorInfo.java:154)
at org.apache.cxf.jaxws.support.JaxWsServiceConfiguration.getEndpointName(JaxWsServiceConfiguration.java:89)
at org.apache.cxf.service.factory.ReflectionServiceFactoryBean.getEndpointName(ReflectionServiceFactoryBean.java:983)
at org.apache.cxf.frontend.AbstractEndpointFactory.createEndpoint(AbstractEndpointFactory.java:91)
at org.apache.cxf.frontend.ServerFactoryBean.create(ServerFactoryBean.java:107)
at org.apache.cxf.jaxws.JaxWsServerFactoryBean.create(JaxWsServerFactoryBean.java:147)
at jrockit.reflect.VirtualNativeMethodInvoker.invoke(Ljava.lang.Object;[Ljava.lang.Object;)Ljava.lang.Object;(Unknown Source)
at java.lang.reflect.Method.invoke(Ljava.lang.Object;[Ljava.lang.Object;I)Ljava.lang.Object;(Unknown Source)
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.invokeCustomInitMethod(AbstractAutowireCapableBeanFactory.java:1214)
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.invokeInitMethods(AbstractAutowireCapableBeanFactory.java:1179)
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.initializeBean(AbstractAutowireCapableBeanFactory.java:1145)
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.createBean(AbstractAutowireCapableBeanFactory.java:427)
at org.springframework.beans.factory.support.AbstractBeanFactory$1.getObject(AbstractBeanFactory.java:251)
at org.springframework.beans.factory.support.DefaultSingletonBeanRegistry.getSingleton(DefaultSingletonBeanRegistry.java:144)
at org.springframework.beans.factory.support.AbstractBeanFactory.getBean(AbstractBeanFactory.java:248)
at org.springframework.beans.factory.support.AbstractBeanFactory.getBean(AbstractBeanFactory.java:160)
at org.springframework.beans.factory.support.DefaultListableBeanFactory.preInstantiateSingletons(DefaultListableBeanFactory.java:279)
at org.springframework.context.support.AbstractApplicationContext.refresh(AbstractApplicationContext.java:360)
at org.springframework.web.context.ContextLoader.createWebApplicationContext(ContextLoader.java:241)
at org.springframework.web.context.ContextLoader.initWebApplicationContext(ContextLoader.java:184)
at org.springframework.web.context.ContextLoaderListener.contextInitialized(ContextLoaderListener.java:49)

从 Stack Trace 来分析，Spring 在 ContextLoaderListener 进行加载配置文件时出错了。
通过查看 JaxWsImplementorInfo.java:154 的源程序
代码
portName = wsAnnotations.get(x).portName();  

可以知道 wsAnnotations 的定义为
代码
private List<WebService> wsAnnotations = new ArrayList<WebService>(2);  

得到List里的对象类型为WebService，并得到全称为javax.jws.WebService
通过 JarClassFind 来搜索，可以得到 Apache CXF 中的 geronimo-ws-metadata_2.0_spec-1.1.1.jar 包含有这个类
而 WebLogic 9.2 中的则有两个 .jar 文件包含有此类：
No.1
Jar Package:%WLS_HOME%/server/lib/api.jar
No.2
Jar Package:%WLS_HOME%/server/lib/weblogic.jar
经过对比，WebLogic 9.2 里的两个 .jar 文件里带个类是一样的，况且，正常启动时 WebLogic 也只是将 weblogic.jar 加到 CLASSPATH 中。

问题猜测应当是由于这两类的版本不一样导致的，拆出来 jad 一下，WebLogic 中的 javax.jws.WebService.java 代码为：
代码
package javax.jws;  
 
import java.lang.annotation.Annotation;  
 
public interface WebService  
    extends Annotation  
{  
 
    public abstract String name();  
 
    public abstract String targetNamespace();  
 
    public abstract String serviceName();  
 
    public abstract String wsdlLocation();  
 
    public abstract String endpointInterface();  
}  

拆出 Apache CXF 里的 javax.jws.WebService jad 一下，代码为：
代码
package javax.jws;  
 
import java.lang.annotation.Annotation;  
 
public interface WebService  
    extends Annotation  
{  
 
    public abstract String name();  
 
    public abstract String targetNamespace();  
 
    public abstract String serviceName();  
 
    public abstract String wsdlLocation();  
 
    public abstract String endpointInterface();  
 
    public abstract String portName();  
}  

这下就完全明白了，是 Apache CXF 期望加载的 javax.jws.WebService 注解与 Weblogic 中 javax.jws.WebService 注解版本不一致导致的。

OK，现在首先想到的是在 weblogic.xml 设置 prefer-web-inf-classes 为 true 来提前加载了。如下：
代码
<?xml version="1.0" encoding="UTF-8"?>  
<weblogic-web-app>  
    <container-descriptor>  
        <prefer-web-inf-classes>true</prefer-web-inf-classes>  
    </container-descriptor>  
</weblogic-web-app>  

总以为能够象往常一样，这样可以了，但是将 prefer-web-inf-classes 设置为 true 后，却发生了另一个异常了：
代码
FATAL: Context initialization failed  
org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'xxxWebService': Invocation of init method failed; nested exception is java.lang.LinkageError: Class javax/xml/namespace/QName violates loader constraints  
Caused by: java.lang.LinkageError: Class javax/xml/namespace/QName violates loader constraints  
        at com.sun.xml.bind.v2.model.impl.RuntimeBuiltinLeafInfoImpl.<clinit>(RuntimeBuiltinLeafInfoImpl.java:186)  
        at com.sun.xml.bind.v2.model.impl.RuntimeTypeInfoSetImpl.<init>(RuntimeTypeInfoSetImpl.java:25)  
        at com.sun.xml.bind.v2.model.impl.RuntimeModelBuilder.createTypeInfoSet(RuntimeModelBuilder.java:84)  
        at com.sun.xml.bind.v2.model.impl.RuntimeModelBuilder.createTypeInfoSet(RuntimeModelBuilder.java:41)  
        at com.sun.xml.bind.v2.model.impl.ModelBuilder.<init>(ModelBuilder.java:104)  
        at com.sun.xml.bind.v2.model.impl.RuntimeModelBuilder.<init>(RuntimeModelBuilder.java:49)  
        at com.sun.xml.bind.v2.runtime.JAXBContextImpl.getTypeInfoSet(JAXBContextImpl.java:372)  
        at com.sun.xml.bind.v2.runtime.JAXBContextImpl.<init>(JAXBContextImpl.java:236)  
        at com.sun.xml.bind.v2.ContextFactory.createContext(ContextFactory.java:76)  
        at com.sun.xml.bind.v2.ContextFactory.createContext(ContextFactory.java:55)  
        at jrockit.reflect.InitialMethodInvoker.invoke(Ljava.lang.Object;[Ljava.lang.Object;)Ljava.lang.Object;(Unknown Source)  
        at java.lang.reflect.Method.invoke(Ljava.lang.Object;[Ljava.lang.Object;I)Ljava.lang.Object;(Unknown Source)  
        at javax.xml.bind.ContextFinder.newInstance(ContextFinder.java:210)  
        at javax.xml.bind.ContextFinder.find(ContextFinder.java:366)  
        at javax.xml.bind.JAXBContext.newInstance(JAXBContext.java:574)  
        at org.apache.cxf.jaxb.JAXBDataBinding.createJAXBContext(JAXBDataBinding.java:377)  
        at org.apache.cxf.jaxb.JAXBDataBinding.initialize(JAXBDataBinding.java:182)  
        at org.apache.cxf.service.factory.ReflectionServiceFactoryBean.buildServiceFromClass(ReflectionServiceFactoryBean.java:244)  
        at org.apache.cxf.service.factory.ReflectionServiceFactoryBean.initializeServiceModel(ReflectionServiceFactoryBean.java:272)  
        at org.apache.cxf.service.factory.ReflectionServiceFactoryBean.create(ReflectionServiceFactoryBean.java:146)  
        at org.apache.cxf.jaxws.support.JaxWsServiceFactoryBean.create(JaxWsServiceFactoryBean.java:89)  
        at org.apache.cxf.frontend.AbstractEndpointFactory.createEndpoint(AbstractEndpointFactory.java:83)  
        at org.apache.cxf.frontend.ServerFactoryBean.create(ServerFactoryBean.java:107)  
        at org.apache.cxf.jaxws.JaxWsServerFactoryBean.create(JaxWsServerFactoryBean.java:147)  

面对这个 java.lang.LinkageError: Class javax/xml/namespace/QName 错误，自然又联想到了版本不一致的问题。
继续 JarClassFind ，在 Apache CXF 里找到 stax-api-1.0.1.jar 包含有这个类。
No.1
Jar Package:%WLS_HOME%/server/lib/api.jar
No.2
Jar Package:%WLS_HOME%/server/lib/weblogic.jar
No.3
Jar Package:%WLS_HOME%/server/lib/webserviceclient+ssl.jar
No.4
Jar Package:%WLS_HOME%/server/lib/webserviceclient.jar
No.5
Jar Package:%WLS_HOME%/server/lib/xbean.jar
同样与 WebLogic 启动时有关的仍是 weblogic.jar ，怪异的是 WebLogic 中居然有三个版本的 javax/xml/namespace/QName 这个类，真是比较糟糕的事情。
api.jar、weblogic.jar 与 webserviceclient+ssl.jar、webserviceclient.jar 和 xbean.jar 中各是一个版本。

但是通过 jad 发现 weblogic 里的 javax/xml/namespace/QName 与 Apache CXF 里的是一样的，比较奇怪了。。。
再进行认真地比较发现，文件的时间不同，再直接进行对比 .class 文件，还是有两处有不同之处。Apache CXF 的时间晚于 WebLogic 里的类的时间，于是只能怀疑后者引起类在加载时发生了 java.lang.LinkageError 错误。
经查JDK文档：LinkageError 的子类指示一个类在一定程度上依赖于另一个类；但是，在编译前一个类之后，后一个类发生了不相容的改变。

于是真相大明了？因为 Apache CXF 里的类的时间晚于 WebLogic 里的类的时间，而且类的二进制内容也发生了改变，于是原来 WebLogic 里的其它类由于我们通过了 prefer-web-inf-classes 设置为 true 后，而引用到了现在的 Apache CXF 里的类了，就发生了 java.lang.LinkageError 错误。

由于设置 prefer-web-inf-classes 设置为 true 后，提前加载了应用程序中 lib 目录下的 .jar 文件，而发生了这个问题，于是就尝试去掉 prefer-web-inf-classes 的设置，直接在 WebLogic 的启动脚本中增加第一次异常时相关的 jar 到 CLASSPATH 中，即 geronimo-ws-metadata_2.0_spec-1.1.1.jar 文件，只提前加载这个 jar 文件。
代码
set CLASSPATH_CXF=X:/xyz/geronimo-ws-metadata_2.0_spec-1.1.1.jar  
set CLASSPATH=%CLASSPATH_CXF%;%CLASSPATH%;%MEDREC_WEBLOGIC_CLASSPATH%  

于是，再次进行启动，这下则可以正常启动了。

为了支持 Aegis ，除了必需的之外，还需要再增加如下 jar 包：
- jaxen.jar
- jdom.jar
- stax-utils.jar 

Trackback: http://tb.blog.csdn.net/TrackBack.aspx?PostId=1810650