浪跡天涯

C++,C#,JAVA之間webservice互操作問題探討

首先聲明：我只是一個C++程序員，對C#,JAVA都是一知半解，因此整篇文章我是以gsoap的webservice為主線，如果有不對之處，還請大家指正，互相探討！

c++用的是gsoap,關于使用gsoap創建webservice的客戶端服務端問題，可以參見我以前的隨筆:<<gsoap使用心得>>
JAVA用的是axis，用axis創建webservice的客戶端和服務端的問題，可以google一番，很多這方面的介紹。
C#用的是system.webserive這個類庫。

我們的目標是要求這三者之間的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/",
        ResponseNamespace = "http://tempuri.org/",
        Use = System.Web.Services.Description.SoapBindingUse.Literal)]
或
    [System.Web.Services.Protocols.SoapRpcMethodAttribute(
        "http://tempuri.org/EASReceive",
        RequestNamespace = "http://tempuri.org/",
        ResponseNamespace = "http://tempuri.org/",
        Use = System.Web.Services.Description.SoapBindingUse.encoded)]
可以調通。

C#的服務端卻只有一種方式可以調通:
        [WebMethod]
        [SoapRpcMethod(
            Action = "http://tempuri.org/EASReceive",
            RequestNamespace = "http://tempuri.org/",
            ResponseNamespace = "http://tempuri.org/",
            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 soapActionURI = "http://tempuri.org/EASReceive"; 
  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、傳輸前參數的字符編碼，也保證為utf8即可，發送前如果字符不是utf8，則首先轉換成utf8再發送，接收到后當成utf8處理即可。

posted on 2008-09-16 10:22 浪跡天涯 閱讀(6959) 評論(7)  編輯 收藏 引用 所屬分類: C++