探討C++、C#和JAVA：webservice互操作問題
首先，分別介紹一下C++、C#和JAVA。
c++用的是gsoap,關于使用gsoap創建webservice的客戶端服務端問題，可以參見我以前的隨筆: < < gsoap使用心得>>
JAVA用的是axis，用axis創建webservice的客戶端和服務端的問題，可以google一番，很多這方面的介紹。
C#用的是system.webserive這個類庫。
我們的目標是要求C++、C#和JAVA這三者之間的webservice互相通訊正常，即能收到客戶端發過來的一串字符串，服務器 端返回給客戶端一段字符串。
要保證互相通訊正常，則必須首先明確webservice的采用的SOAP協議。
根據網上的資料:
style屬性可分為rpc document，rpc document之間的區別為:
* RPC 樣式
RPC樣式指定 元素包含一個將被調用的web方法的名稱的元素（wrapper element（封裝元素））。這個元素依次為該方法的每個參數還有返回值作了記錄。
* Document 樣式
如果是document 樣式，就沒有像在RPC樣式中的wrapper元素。轉而代之的是消息片斷直接出現在< SPAN>> 元素之下。沒有任何SOAP格式化規則規定元素下能包含什么；它包含的是一個發送者和接收者都達成一致的XML文檔。
‘Use’ 屬性。這與各種類型如何在XML中顯示有關，它指定使用某種編碼規則對消息片段進行編碼，還是使用消息的具體架構來定義片段。如下就是提供的兩種選擇：
* encoded
如果use的值是”encoded”, 則每個消息片段將使用類型屬性來引用抽象類型。通過應用由 encodingStyle 屬性所指定的編碼樣式，可使用這些抽象類型生成具體的消息。最常用到的SOAP編碼樣式是在SOAP1.1中定義的一組序列化規則，它說明了對象、結構、數組和圖形對象應該如何序列化。通常，在應用程序中使用SOAP編碼著重于遠程進程調用和以后適合使用RPC消息樣式。
* Literal
如果use 的值是”Literal”， 則每個片段使用 element 屬性（對于簡單片段）或 type 屬性（對于復合片段）來引用具體架構，例如，數據根據指定的架構來序列化，這架構通常使用W3C XML架構來表述。
我找了很多這方面的資料，但是具體理解起來還是很困難。單從字面取理解其實很簡單，但是聯系到實際操作中,根據各種方式生成的wsdl來看，卻很難理解其中的異同。因為遵循document格式的soap消息看上去很像rpc格式。而且對于簡單對象如int string等類型來說，好像并未有十分明顯的異同，因此在我測試過程中，一直都是比較模糊的。我也采用了comview，iris抓包工具，抓獲它們之間發送的數據包，對問題分析還是有所幫助的。
我是以gsoap為主線進行測試的，因此在測試完成后，對自己的測試結果持有懷疑，我感覺是自己對gsoap的rpc docment encoded literal之間的差異并沒有理解透徹，我是這么定義的：
document/literal方式：
- //gsoap ns service name: EASReceive
- //gsoap ns service location: http://services.xmethods.net/soap
- //gsoap ns service namespace: http://tempuri.org/
- //gsoap ns service style: document
- //gsoap ns service encoding: literal
- //gsoap ns service method-action: EASReceive ""
- typedef char *xsd__string;
- int ns__EASReceive(xsd__string strSubmitData ,xsd__string *strPxFormData);
rpc/encoded方式：
- //"OAMethod.h"的內容:
- //gsoap ns service name: EASReceive
- //gsoap ns service location: http://services.xmethods.net/soap
- //gsoap ns service namespace: http://tempuri.org/
- //gsoap ns service style: rpc
- //gsoap ns service encoding: encoded
- //gsoap ns service method-action: EASReceive ""
- int ns__EASReceive(char* strSubmitData ,char** strPxFormData);
可我發現生成的wsdl中除了style use屬性值不一樣外，并沒有其它什么區別，對了在encoded中我還加了soap2cpp.exe -e選項（加與不加都測試過）。
C#的客戶端多種方式都測試過，經測試只有采用
- [System.Web.Services.Protocols.SoapRpcMethodAttribute(
- "http://tempuri.org/EASReceive",
- RequestNamespace = "http://tempuri.org/",
- Resp,
- Use = System.Web.Services.Description.SoapBindingUse.Literal)]
或
- [System.Web.Services.Protocols.SoapRpcMethodAttribute(
- "http://tempuri.org/EASReceive",
- RequestNamespace = "http://tempuri.org/",
- Resp,
- Use = System.Web.Services.Description.SoapBindingUse.encoded)]
可以調通。
C#的服務端卻只有一種方式可以調通:
- [WebMethod]
- [SoapRpcMethod(
- Action = "http://tempuri.org/EASReceive",
- RequestNamespace = "http://tempuri.org/",
- Resp,
- Use = System.Web.Services.Description.SoapBindingUse.Literal)] //encoded不行
- [return: XmlElement("strPxFormData", IsNullable = false)]
也用C#的wsdl自動生成工具測試過，根據gsoap生成的wsdl文件 ，自動生成的代碼也不能和gsoap完成通訊正常。我一直理解不明白，按道理說只要將編碼方式一致即可通訊，不知是否我c#端代碼編寫有問題？在網上搜索 C#端的資料時，發現C#端對webservice中自定義xml文件方案是十分靈活的，可以隨意定制傳輸的xml節點，因此其實關鍵問題還是格式必須保證互相一致，這樣在收到soap消息后，雙方都可以對xml進行正確的解析。經過反復調試，最終還是調通了，都采用rpc/literal方式即可。 JAVA端和gsoap通訊倒是沒有問題，采用何種編碼只要統一即可通訊，因此基于測試發現的C#的"局限性"，我們統一成rpc/literal。
JAVA客戶端代碼：
- String endpoint = "http://192.168.8.94/csharp_demo/Service1.asmx";
- Service service = new Service();
- Call call = (Call) service.createCall();
- call.setTargetEndpointAddress( new java.net.URL(endpoint) );
- call.setUseSOAPAction(true);
- String soapActi;
- call.setSOAPActionURI(soapActionURI);
- call.setOperationStyle(org.apache.axis.constants.Style.RPC);
- call.setOperationUse(org.apache.axis.constants.Use.LITERAL);
- String strSubmitData = new String("yes or no!???");
- call.setOperationName(new QName("http://tempuri.org/","EASReceive"));
- call.addParameter("strSubmitData",org.apache.axis.encoding.XMLType.XSD_STRING,javax.xml.rpc.ParameterMode.IN);
- //call.addParameter(new QName("http://tempuri.org/","strSubmitData"), org.apache.axis.encoding.XMLType.XSD_STRING, javax.xml.rpc.ParameterMode.IN);
- call.setReturnType( XMLType.XSD_STRING );
- //oper.setElementQName(new QName("http://tempuri.org/","EASReceive"));
- //call.setOperation(oper);
- String ret = (String) call.invoke( new Object[] { strSubmitData} );
- System.out.println("Get result : " + ret);
JAVA服務端代碼:略
***，歡迎大家一起探討，感覺問題還是很多，現在雖然保證了通訊正常，但實際上我頭腦還是漿糊著呢，呵呵！
令關于C#端必須要求soapAction的問題，有兩種解決方案：
1、C#服務端加入以下代碼，但測試發現，部署到IIS后，并不起作用，具體原因不知道。
- [SoapRpcService(RoutingStyle = SoapServiceRoutingStyle.RequestElement)] //設置無需指派soapAction 但部署到iis 上時并未起作用
- //[SoapDocumentService(RoutingStyle = SoapServiceRoutingStyle.RequestElement)]
2、在客戶端加上soapAction，gsoap客戶端傳入soapAction即可。
還有一個棘手的問題，就是中文亂碼問題，呵，說棘手是因為如果不清楚的確很棘手，其實解決起來也很簡單，就是保證通訊編碼一致。這里的通訊編碼一致有兩層意思：
1、webservice間傳輸編碼，都保證為UTF8,gsoap加入soap_set_mode(s.soap, SOAP_C_UTFSTRING)即可。java,c#端都是默認以utf8傳輸的。
2、傳輸前參數的字符編碼，
終于，C++、C#和JAVA中webservice互操作問題就解決了，希望大家一起來討論。
【編輯推薦】
