1. 全栈程序员必看首页

关于AxisFault的说明[通俗易懂]

全栈程序员-用户IM • • 未分类

关于AxisFault的说明[通俗易懂]copyfrom:http://tenn.iteye.com/blog/94324一般说来，不可避免的WebService的服务中也会出现异常，举个简单的例子，一个服务接受一个SOAP请求消息，获取有效负载后，进行一个数据库更新操作，而在更新操作过程中发生了SQLException，这个时候就需要告诉客户端（调用WebService）出现异常了，Axis2将异常封装成为一个Axis…

大家好，又见面了，我是你们的朋友全栈君。如果您正在找激活码,请点击查看最新教程,关注关注公众号 “全栈程序员社区” 获取激活教程,可能之前旧版本教程已经失效.最新Idea2022.1教程亲测有效,一键激活。

Jetbrains全系列IDE使用 1年只要46元 售后保障 童叟无欺

一般说来，不可避免的Web Service的服务中也会出现异常，举个简单的例子，一个服务接受一个SOAP请求消息，获取有效负载后，进行一个数据库更新操作，而在更新操作过程中发生了SQLException，这个时候就需要告诉客户端（调用Web Service）出现异常了，Axis2将异常封装成为一个AxisFault进行抛出。任何类型的异常Axis2都会对其进行封装，而不管该异常是运行时异常，还是用户自定义异常。
 
下面是对AxisFault API的一点介绍：
public class AxisFault extends RemoteException
An exception which maps cleanly to a SOAP fault. This is a base class for exceptions which are mapped to faults.
See Also:
SOAP faults contain
1.    
A fault string
2.    
A fault code
3.      A fault actor
4.      Fault details; an xml tree of fault specific elements
（其中红色的部分为一个AxisFault构造时所必须的部分）
As SOAP1.2 faults are a superset of SOAP1.1 faults, this type holds soap1.2 fault information. When a SOAP1.1 fault is created, spurious information can be discarded. Mapping 
SOAP1.2              SOAP1.1
node                 faultactor
reason(0).text       faultstring
faultcode.value      faultcode
faultcode.subcode    (discarded)
detail               detail
role                 (discarded)
 
构造函数之一为：
AxisFault
(org.apache.axiom.soap.SOAPFaultCode soapFaultCode, org.apache.axiom.soap.SOAPFaultReason soapFaultReason, org.apache.axiom.soap.SOAPFaultNode soapFaultNode, org.apache.axiom.soap.SOAPFaultRole soapFaultRole, org.apache.axiom.soap.SOAPFaultDetail soapFaultDetail)
 
由于SOAP 1.1的SOAPFault和SOAP 1.2的SOAPFault的结构不相同，从而导致了如果以1.2的方式构造的SOAPFault不能够被1.1版本的SOAPFault所理解，从而导致异常，异常的内容经常为如下消息：
org.apache.axiom.soap.SOAPProcessingException: Expecting SOAP 1.1 implementation
of SOAP Fault Code. But received some other implementation
 
一般情况下，SOAPFault是通过SOAPFactory这个工厂类构造的，而SOAP11Factory和SOAP12Factory均继承SOAPFactory，从而对应与两个不同的SOAP协议版本。
 
可以将SOAP1.1的SOAPFault与SOAP1.2的SOAPFault进行转换，但是比较麻烦。
下面以一个实际的例子来说明有关SOAPFault的一些内容：
 
1.      建立工程TestFault，如下图所示目录结构：
关于AxisFault的说明[通俗易懂]
其中类库使用的是从http://ws.apache.org/axis2下载的最新版本的axis2软件中的类库（笔者写这篇文章时的最新axis2版本为1.1.1）。下载后解压缩，将解压缩后的目录中的lib文件夹下所有的jar文件拷贝到${eclipse.home}/workspace/TestFault/src下，目录结构可能与此不同，只需要将这些jar文件加入到TestFault工程的构建路径中即可。
 
编写服务器端和客户端的类：
FaultService.java
package l.z.z;
 
import javax.xml.namespace.QName;
 
import org.apache.axiom.om.OMAbstractFactory;
import org.apache.axiom.om.OMElement;
import org.apache.axiom.soap.SOAP12Constants;
import org.apache.axiom.soap.SOAPBody;
import org.apache.axiom.soap.SOAPEnvelope;
import org.apache.axiom.soap.SOAPFactory;
import org.apache.axiom.soap.SOAPFault;
import org.apache.axiom.soap.SOAPFaultCode;
import org.apache.axiom.soap.SOAPFaultReason;
import org.apache.axiom.soap.SOAPFaultText;
import org.apache.axiom.soap.SOAPFaultValue;
import org.apache.axis2.AxisFault;
 
public class FaultService {
 
      public OMElement testFault(OMElement soap) throws AxisFault {
           if (soap.getLocalName().equals(“Satan”)) {
                 throw getAxisFault(“Satan”);
           }
           throw getAxisFault(“God”);
      }
 
      public AxisFault getAxisFault(String message) {
           SOAPFactory factory = OMAbstractFactory.getSOAP12Factory();
           SOAPEnvelope envelope = factory.createSOAPEnvelope();
           SOAPBody body = factory.createSOAPBody(envelope);
           SOAPFault soapFault = factory.createSOAPFault(body);
           SOAPFaultCode faultCode = factory.createSOAPFaultCode(soapFault);
           SOAPFaultReason faultReason =
factory.createSOAPFaultReason(soapFault);
           SOAPFaultValue faultValue = factory.createSOAPFaultValue(faultCode);
           SOAPFaultText reasonText =
factory.createSOAPFaultText(faultReason);
           QName value =
new QName(SOAP12Constants.SOAP_ENVELOPE_NAMESPACE_URI,
                      SOAP12Constants.SOAP_FAULT_VALUE_SENDER,
                      SOAP12Constants.SOAP_DEFAULT_NAMESPACE_PREFIX);
           faultValue.setText(value);
           reasonText.setText(message);
           AxisFault axisFault = new AxisFault(soapFault.getCode(), soapFault
                      .getReason(), null, null, null);
           return axisFault;
      }
}
 
TestFaultService.java
 
package l.z.z.test;
 
import java.io.FileInputStream;
import java.io.FileNotFoundException;
 
import javax.xml.stream.FactoryConfigurationError;
import javax.xml.stream.XMLInputFactory;
import javax.xml.stream.XMLStreamException;
import javax.xml.stream.XMLStreamReader;
 
import org.apache.axiom.om.OMElement;
import org.apache.axiom.om.impl.builder.StAXOMBuilder;
import org.apache.axis2.AxisFault;
import org.apache.axis2.addressing.EndpointReference;
import org.apache.axis2.client.Options;
import org.apache.axis2.client.ServiceClient;
 
public class TestFaultService {
      private static EndpointReference targetEPR = new EndpointReference(
                 “http://localhost/axis2/services/FaultService”);
 
      public static void main(String[] args) throws FileNotFoundException,
                 FactoryConfigurationError, XMLStreamException {
           OMElement requestSoapMessage =
getSoapRequestMessage(“sample/Satan.xml”);
           Options options = new Options();
           options.setAction(“urn:testFault”);
           options.setTo(targetEPR);
           ServiceClient sender = null;
           try {
                 sender = new ServiceClient();
                 sender.setOptions(options);
                 sender.sendReceive(requestSoapMessage);
           } catch (AxisFault e) {
                 System.out.println(e.getMessage());
           }
      }
 
      public static OMElement getSoapRequestMessage(String filePath)
                 throws FileNotFoundException, XMLStreamException,
                 FactoryConfigurationError {
           XMLStreamReader reader = XMLInputFactory.newInstance()
                      .createXMLStreamReader(new FileInputStream(filePath));
           StAXOMBuilder builder = new StAXOMBuilder(reader);
           OMElement requestMessage = builder.getDocumentElement();
           return requestMessage;
      }
}
 
然后编写services.xml文件，内容如下：
<
serviceGroup
>
     
<
service
name
=
“FaultService”
>
          
<
description
>
                 This is the service for revoking certificate.
          
</
description
>
          
<
parameter
name
=
“ServiceClass”
locked
=
“false”
>
                 l.z.z.FaultService
          
</
parameter
>
          
<
operation
name
=
“testFault”
>
                
<
messageReceiver
          
class
=
“org.apache.axis2.receivers.RawXMLINOutMessageReceiver”
/>
                
<
actionMapping
>
urn:testFault
</
actionMapping
>
          
</
operation
>
     
</
service
>
</
serviceGroup
>
 
由于本文假设读者已经有axis2开发Web Service的基础，所以对于以上类及配置文件不做解释，敬请原谅。
 
打包成FaultService.aar文件，文件中包含内容如下：
FaultService.aar
      —l
           —z
                 —z
                      —FaultService.class
      —META-INF
           —MANIFEST.MF
           —services.xml
将该aar包放置到${TOMCAT_HOME}\webapps\axis2\WEB-INF\services目录下。
启动Tomcat，进入
http://localhost:{port}/axis2
然后选择Services，察看服务是否部署成功，如果已经部署成功，进入下一步骤，否则，请重新检查以上各个步骤。成功后应该如下图所示：
关于AxisFault的说明[通俗易懂]
2执行TestFaultService类，可以看到错误消息如下：
（类代码参照上面列出的类）
Transport error 500 . Error Message is <html><head><title>Apache Tomcat/5.5.17 – Error report</title><style><!–H1 {color:white;background-color:#525D76;font-size:22px;} H2 {color:white;background-color:#525D76;font-size:16px;} H3 {color:white;background-color:#525D76;font-size:14px;} BODY {color:black;background-color:white;} B {color:white;background-color:#525D76;} P {background:white;color:black;font-size:12px;}A {color : black;}A.name {color : black;}HR {color : #525D76;}–></style> </head><body><h1>HTTP Status 500 – </h1><HR size=”1″ noshade=”noshade”><p><b>type</b> Exception report</p><p><b>message</b> <u></u></p><p><b>description</b> <u>The server encountered an internal error () that prevented it from fulfilling this request.</u></p><p><b>exception</b>
<pre>org.apache.axiom.soap.SOAPProcessingException: Expecting SOAP 1.1 implementation of SOAP Fault Code. But received some other implementation
     
org.apache.axiom.soap.impl.llom.soap11.SOAP11FaultImpl.setCode(SOAP11FaultImpl.java:81)
      org.apache.axis2.engine.AxisEngine.extractFaultInformationFromMessageContext(
AxisEngine.java:330
)
      org.apache.axis2.engine.AxisEngine.createFaultMessageContext(
AxisEngine.java:249
)
      org.apache.axis2.transport.http.AxisServlet.handleFault(
AxisServlet.java:317
)
      org.apache.axis2.transport.http.AxisServlet.doPost(
AxisServlet.java:277
)
      javax.servlet.http.HttpServlet.service(
HttpServlet.java:709
)
      javax.servlet.http.HttpServlet.service(
HttpServlet.java:802
)
 
其中红色的部分是问题的关键，该部分意思是说，客户端期望获得的是一个SOAP 1.1的SOAP Fault Code，但是，我们实际提供的却是一个1.2的实现，所以客户端处理不了，就抛出了异常，而实际出异常的地方那个是红色字体下面的蓝色字体：
SOAP11FaultImpl.setCode时，由于是一个SOAP1.2的SOAP Fault Code，所以不能够处理，只能跑出异常。
 
而通过使用SOAPMonitor观察到的传入SOAP请求消息是：
关于AxisFault的说明[通俗易懂]
 
注意，Axis2自动的将传入的消息加上一层封装，在传输过程中（没有到达Web Service方法testFault之前）是以这个形式传输的，而Axis2使用的默认的SOAP版本是1.1，所以，不管在FaultService类中构造的AxisFault是SOAP11还是SOAP12，最后都会试图将其转换为SOAP11的格式，而一旦此时出现版本冲突，就会发生异常。
AxisFault还没有返回到客户端，就已经发生了异常（上图中SOAPResponse内容为空）。
 
解决办法一：
将SOAP12的Fault转换为SOAP11的Fault,这样可以传出SOAP11构造的SOAPFault，但是，名称却和SOAP12一致（比如服务器端异常并不是使用SOAP11的”Server”，而是SOAP12的”Receiver”）。这种办法虽然可以实行，但是一旦客户端是SOAP12怎么办，缺少共通性。
 
解决办法二：
在构造SOAPFault时进行判断，如果客户端使用的是SOAP12，则使用SOAP12Factory来构造，否则使用SOAP11来构造。
 
这时，就需要在客户端设置使用的SOAP版本，通过一下方法：
Options
options =
new
Options
();
options.setSoapVersionURI(SOAP12Constants.SOAP_ENVELOPE_NAMESPACE_URI);
这样，就可以设置在传输过程中使用的SOAP封装是SOAP12版本。
这时，通过SOAPMonitor观察到的SOAP请求和响应的消息为：
关于AxisFault的说明[通俗易懂]
 
只所以会有这样的不同是因为通过使用
options.setSoapVersionURI(SOAP12Constants.SOAP_ENVELOPE_NAMESPACE_URI);
设置了将被使用的SOAP的版本。
 
由于有些客户端可能使用的是不支持SOAP12版本的SOAP协议，所以，有时候需要将SOAP11进行到SOAP12的装换。
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容， 请发送邮件至 举报，一经查实，本站将立刻删除。

发布者：全栈程序员-用户IM，转载请注明出处：https://javaforall.cn/194253.html原文链接：https://javaforall.cn

【正版授权，激活自己账号】： Jetbrains全家桶Ide使用，1年售后保障，每天仅需1毛

【官方授权 正版激活】： 官方授权 正版激活 支持Jetbrains家族下所有IDE 使用个人JB账号...

赞 (0)
全栈程序员-用户IM全栈程序员-用户IM
0 0
blank

相关推荐

  • Java并发——线程同步Volatile与Synchronized详解

    Java并发——线程同步Volatile与Synchronized详解

    Java并发——线程同步Volatile与Synchronized详解Java面试——线程同步volatile与synchronized详解0.前言面试时很可能遇到这样一个问题：使用volatile修饰int型变量i，多个线程同时进行i++操作，这样可以实现线程安全吗？提到线程安全、线程同步，我们经常会想到两个关键字：volatile和synchronized，那么这两者有什么区别呢？1.volatile与synchronized介绍volatile是变量修

    全栈程序员-用户IM 全栈程序员-用户IM
    2022年7月11日
  • 递归和迭代的差别

    递归和迭代的差别

    递归和迭代的差别

    全栈程序员-用户IM 全栈程序员-用户IM
    2021年11月30日
  • 银行风控模型

    银行风控模型

    银行风控模型风控催生原因对于银行来说，现今互联网贷款和信用卡办理面临的主要难题是数据和风控。站在银行或金融机构角度，自然而然是想获得更多的信息和数据，但是在收集数据这方面又是比较无力的。加上当下的发展趋势，消费贷以及贷款审批速度都要求快。如何在快的的过程中对客户进行一个全面的审查，得出一个合理的结果呢？如果没有详细的数据对客户进行评估，这势必会提高放贷的风险。风控概述所谓风控，是指多银行贷款资金的…

    全栈程序员-用户IM 全栈程序员-用户IM
    2022年6月13日
  • 使用CEGUI

    使用CEGUI

    使用CEGUI更多精彩内容，请见：http://www.16boke.comcegui 1 cegui渲染入门至少需要3步,才可以使cegui运行起来1 创建CEGUI::Renderer对象2 创建CEGUI::System对象3 调用渲染函数1 创建 CEGUI：Renderer对象支持的渲染组件（Direct3d9 OpenGl Ogre3d etc..)记得包含所使用的渲染组件的头文件。Direct3D 8.1CEGUI::Di

    全栈程序员-用户IM 全栈程序员-用户IM
    2022年7月24日
  • Pycharm设置点击无反应解决办法+Pycharm汉化「建议收藏」

    Pycharm设置点击无反应解决办法+Pycharm汉化「建议收藏」

    Pycharm设置点击无反应解决办法+Pycharm汉化「建议收藏」Pycharm汉化后会遇到设置点击无反应的情况。解决办法：1，如果你的lib文件下有汉化包“resources_ch.jar”直接删除就可以了。不过汉化就没了。2，删除原来的汉化包，更换汉化包。把“resources_zh_CN_PyCharm_2019.1_r1.jar”复制到lib文件夹下，记着不需要重命名。附亲测有效的汉化包：链接:https://pan.baidu.c…

    全栈程序员-用户IM 全栈程序员-用户IM
    2022年5月20日
  • 面试官：说一下Redis和MongoDB的区别？[通俗易懂]

    面试官：说一下Redis和MongoDB的区别？[通俗易懂]

    面试官：说一下Redis和MongoDB的区别？

    全栈程序员-用户IM 全栈程序员-用户IM
    2022年2月20日

发表回复

您的电子邮箱地址不会被公开。

关注全栈程序员社区公众号