wsdl SOAP Action的真正面貌

最近在工作中遇到一个SOAP Action的问题，有的为空有的不为空,犯迷糊了

(soapAction 属性的这个URI类型值指定这个方法的SOAPAction头的值；在请求中不要使用相对的URI，而应该使用绝对URI。对于HTTP协议的SOAP绑定，这个值是必须的。对于其他协议的SOAP绑定，禁止明确指定此值。soap:action元素可以缺省。)

所以上次在电信给的wsdl中他们用的是rpc的格式的,但是没有指定soapaction,当我把他sope格式改为document时,生成的客户端soapaction值为空,运行的时候是不行的.但是http的请求时就必须要soapAction.

　　据说SOAPAction header这玩意在SOAP 1.1规范中着实让不少开发者喝了一壶。真的有这么难理解么?我想这应该是因为SOAP有两种非常不同的使用方式，而SOAPAction主要是被用来支持其中应用较少的一种方式的原因。在我看来，这种方式也非常有价值。

　　让我们先看看SOAP 1.1规范是怎么定义HTTP SOAPAction header的：

　　SOAPAction HTTP request header被用来标识SOAP HTTP请求的目的地，其值是个URI地址。SOAP发送并不限制格式、URI特征或其必须可解析，那么在这种情况下，发送一个HTTP SOAP请求时，其HTTP客户端必须使用/指明SOAPAction HTTP request header。

　　SOAPAction header的内容可以被用在服务端，诸如：防火墙适当的过滤基于HTTP的SOAP请求消息等场景。SOAPAction header的值为空串("")表示SOAP消息的目的地由HTTP请求的URI标识;无值则表示没有指定这条消息的目的地。

　　看了官方的定义，相信大家也迷糊了，迷糊在“目的地”这个词上吧?那么，给它一个准确的说法吧——“确定执行某一行为的路径”。

　　看一个SOAP消息的例子：

＜ SOAP-ENV:Envelope
   xmlns:SOAP-ENV ="http://schemas.xmlsoap.org/soap/envelope/"
  SOAP-ENV:encodingStyle ="http://schemas.xmlsoap.org/soap/encoding/" ＞
    ＜ SOAP-ENV:Body ＞
        ＜ m:GetLastTradePrice  xmlns:m ="Some-URI" ＞
            ＜ symbol ＞XYS ＜/ symbol ＞
        ＜/ m:GetLastTradePrice ＞
    ＜/ SOAP-ENV:Body ＞
＜/ SOAP-ENV:Envelope ＞

　　很明显的，这条消息指明了要去执行服务端的“GetLastTradePrice”这个方法，开发者不会对此没有疑问，这样看来，SOAP Action也许显得多余了?

　　然而，在另一种SOAP消息的发送场景中，却少不了SOAP Action。在这种场景中，SOAP消息并没有显示的指定要调用的服务方法名，而是利用底层的传输协议发送(这样的话，一般会被Web services忽视)，例如使用HTTP的Post方式发送的SOAP消息。

　　拿AWT组件容器来举个例子吧，我们知道有很多AWT容器，例如：Panel，Box，Window等等，很多情况下，开发者知道他们创建的泛型容器对象下真正是什么对象。那么，假设下面两段代码里的java.awt.Container对象其实是一个Box吧：

　　1.

　　comp = new TextField( "test" );
　　java.awt.Container c = Foo.bar();
　　c.add( comp );

　　2.

　　comp = new TextField( "test" );
　　java.awt.Container c = Foo.bar();
　　((java.awt.Panel)c).add( comp );

　　以上两段代码产生两种不同的结果。“add()”方法对两者似乎有着相同的意义，但是在代码2中其被扩展为“作为一个Panel对象去add”。所以很明显的，代码2会抛出一个异常，因为我们知道这个对象实际上是Box，而我们的代码期待的是Panel。

　　HTTP POST的意义正如这个例子中的“add()”方法一样，HTTP POST提供一个关于SOAPAction如何被使用的索引;而SOAPAction header的值则应该被用来指明这个“扩展”的目的地——这条SOAP/HTTP消息发送者所期待的处理容器的名称(可以这样理解：即相应的API方法)。那么，正如上面那个AWT例子一样，如果这种期待没有被满足，就会产生一个错误。

　　注意：在SOAP 1.2规范中，SOAPAction header这个属性被"action"所取代，但其作用和工作原理都没有变化。

　　有意思的是，在Tibco的EAI工具BW中，使用SOAP服务端活动必须指定SOAP Action属性，如果引用的原始WSDL没有使用这个属性的话，也必须显示的指明;因此，相应的，其客户端也要注意啦——必须为SOAP Action属性填入期待的URI。