问题
我正在尝试将我的web服务客户端从Apache AXIS-1迁移到ApacheCXF。web服务本身运行omAXIS-1,这是我无法控制的
我生成了所有CXF工件,客户端一直工作良好,直到服务抛出任何故障。错误的XML看起来像:
<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<soapenv:Fault>
<faultcode>soapenv:Server</faultcode>
<faultstring>Remote error processing component card request</faultstring>
<detail>
<fault>
<faultcode>:-303</faultcode>
<faultstring>Remote error processing component card request</faultstring>
<faultactor>remote_service</faultactor>
<detail>
<common-detail>
<code>-303</code>
<message>Remote error processing component card request</message>
</common-detail>
</detail>
</fault>
</detail>
</soapenv:Fault>
</soapenv:Body>
</soapenv:Envelope>
这使得CXF生成的客户端出现异常:
javax.xml.bind.UnmarshalException: unexpected element (uri:"", local:"fault").
Expected elements are <{http://some.namespace.org}AnsBonusAutopayStatus>,<{http://some.namespace.org}AnsBonusAutopaySubscribe>,
...
<{http://some.namespace.org}fault>
at com.sun.xml.bind.v2.runtime.unmarshaller.UnmarshallingContext.handleEvent(UnmarshallingContext.java:603)
at com.sun.xml.bind.v2.runtime.unmarshaller.Loader.reportError(Loader.java:244)
at com.sun.xml.bind.v2.runtime.unmarshaller.Loader.reportError(Loader.java:239)
at com.sun.xml.bind.v2.runtime.unmarshaller.Loader.reportUnexpectedChildElement(Loader.java:116)
at com.sun.xml.bind.v2.runtime.unmarshaller.UnmarshallingContext$DefaultRootLoader.childElement(UnmarshallingContext.java:1009)
at com.sun.xml.bind.v2.runtime.unmarshaller.UnmarshallingContext._startElement(UnmarshallingContext.java:446)
at com.sun.xml.bind.v2.runtime.unmarshaller.UnmarshallingContext.startElement(UnmarshallingContext.java:427)
at com.sun.xml.bind.v2.runtime.unmarshaller.InterningXmlVisitor.startElement(InterningXmlVisitor.java:71)
at com.sun.xml.bind.v2.runtime.unmarshaller.SAXConnector.startElement(SAXConnector.java:137)
at com.sun.xml.bind.unmarshaller.DOMScanner.visit(DOMScanner.java:240)
at com.sun.xml.bind.unmarshaller.DOMScanner.scan(DOMScanner.java:123)
...
AFAIU从这个堆栈中,unmarshaller期望fault元素具有特定的命名空间声明,但它没有声明。
有人能建议客户出了什么问题以及如何避免错误吗?
经过测试的解决方案
有很多类似的问题,但并不是所有的解决方案都适用于我,因为我不能在服务器端更改任何内容(至少出于向后兼容性的原因),而且更改WSDL也不受欢迎。因此,更改仅限于客户端(包括其(重新)生成)。基于类似的问题,我尝试了几种可能的解决方案:
- 添加带有默认名称空间声明的package-info.class-没有任何更改
- 在构造异常对象的过程中,强制为CXF例程中生成的Fault和/或Fault_Exception类-NullPointerException设置空命名空间(请参阅下面的EDIT部分)
- 使用SAXXmlFilter-找不到将其嵌入CXF生成的例程的方法
其他信息
CXF为exception生成的类及其faultInfo(没有任何更改)看起来像:
故障类别:
@XmlAccessorType(XmlAccessType.FIELD)
@XmlType(name = "", propOrder = {
"faultcode",
"faultstring",
"faultactor",
"detail"
})
@XmlRootElement(name = "fault")
public class Fault {
@XmlElement(required = true)
protected String faultcode;
...
Fault_Exception类:
@WebFault(name = "fault", targetNamespace = "http://some.namespace.org")
public class Fault_Exception extends Exception {
private Fault fault;
public Fault_Exception() {
super();
}
...
一些WSDL摘录。WSDL错误消息声明:
<wsdl:message name="Fault">
<wsdl:part name="fault" element="fault"/>
</wsdl:message>
XSD错误元素:
<xs:element name="fault">
<xs:annotation>
<xs:documentation>Comment describing your root element</xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="faultcode">...</xs:element>
<xs:element name="faultstring">...</xs:element>
<xs:element name="faultactor">...</xs:element>
<xs:element minOccurs="0" name="detail">...</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
WSDL操作描述示例:
<wsdl:operation name="BonusConversionState">
<wsdl:input name="BonusConversionStateRequest" message="tns:BonusConversionStateRequest"/>
<wsdl:output name="BonusConversionStateResponse" message="tns:BonusConversionStateResponse"/>
<wsdl:fault name="Fault" message="tns:Fault"/>
</wsdl:operation>
WSDL根元素:
<?xml version="1.0" encoding="UTF-8"?>
<wsdl:definitions targetNamespace="http://some.namespace.org"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:tns="http://some.namespace.org"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/">
可以提供更多附加信息
提前感谢!
编辑:
在"调查"过程中,我发现NullPointerException(我在"已测试的解决方案"中提到)不是我错误操作的结果。这是CXF:的一个错误
- https://issues.apache.org/jira/browse/CXF-2555
- https://issues.apache.org/jira/browse/CXF-3763.
这两张票都以"Fixed"的分辨率关闭,但在评论中,用户报告他们仍然发现了这个错误。开发人员似乎没有涵盖CXF处理自定义异常的所有情况,并且由于某些原因,它有时会导致
org.apache.cxf.enterceptor.ClientFaultConverter进程FaultDetails
信息:创建异常时发生异常:null
java.lang.NullPointerException
有人也遇到过这个问题吗?
这似乎是一种服务不遵守其自身合同的情况。虽然您可能无法控制服务,但这值得与服务提供商讨论。
客户抱怨的错误元素是第一个"detail"元素的直接子元素。
根据异常消息,"detail"的第一个子元素应为(假定目标命名空间为http://some.namespace.org')AnsBonusAutopayStatus或AnsBonus AutopaySubscribe,而不是{}fault元素。
如果您能够围绕操作中的错误声明和wsdl类型提供更多wsdl,则可以提供额外的静态分析。