本文分兩部分:第一部分示範以 .NET 作為使用者端去呼叫 Java 寫的 Web Services;第二部分則反過來,用 Java 當使用者端去呼叫以 .NET 開發的 Web Services。
◆ Windows XP Professional(含 IIS)
◆ Eclipse 3.1(已裝好 Tomcat 與 Axis)
◆ VS.NET 2003
備註:需下載並安裝 Tomcat 5.5.16 與 Axis 開發套件,並完成相應設定。
用 Eclipse 建立 Web Services 相當簡單。新增一個 Web 專案,右鍵建立類別 HelloClient.java,程式碼如下:
public class HelloClient
{
public String getName(String name)
{
return "Hello,"+name;
}
}
對著這個檔案按右鍵選擇「WebServices」→「Create Web Service」,即可把它部署成本機的服務。在 IE 輸入 https://localhost:8008/testWebService/services/HelloClient 可看到已部署的 HelloClient 服務;輸入 https://localhost:8008/testWebService/services/HelloClient?wsdl 則可看到這支服務的描述檔。
接著新增一個專案(WinForm 或 ASP.NET 皆可),本文以 ASP.NET 為例。在起始頁放一個文字輸入框供輸入、一個標籤顯示呼叫結果,再放一顆按鈕觸發呼叫。然後選擇「加入 Web 參考」,在 URL 欄填入 https://localhost:8008/testWebService/services/HelloClient?wsdl,參考名稱取為 JavaWebService,按下加入即可。此時在 VS.NET 的 Solution Explorer 就能看到這個 Web 參考。程式碼如下:
protected System.Web.UI.WebControls.TextBox txtName;
protected System.Web.UI.WebControls.Button btnSend;
protected System.Web.UI.WebControls.Label lblMsg;
private JavaWebService.HelloClientService ws;
private void Page_Load(object sender, System.EventArgs e)
{
// 在此處放置使用者程式碼以初始化頁面
ws=new testWebService.JavaWebService.HelloClientService();
}
private void btnSend_Click(object sender, System.EventArgs e)
{
lblMsg.Text=ws.getName(txtName.Text);
}
這樣一個 .NET 使用者端就完成了,測試執行結果正常。
用 VS.NET 新增一個 ASP.NET Web Services 專案,加入一個名為 Service1.asmx 的 Web 服務,並新增一個 Web Method:
//指定 SoapAction
[SoapRpcMethod(Action="https://www.xxx.com/Rpc",
RequestNamespace="https://www.xxx.com/SU",ResponseNamespace="https://www.xxx.com/SU")]
[WebMethod]
public string getName(string name)
{
return "Hello"+name;
}
執行它,並用 IE 測試通過。
開啟 Eclipse,新增一個 Web 專案並加入 JSP 頁面 action_hello.jsp,輸入下列程式碼:
<%@page pageEncoding="GBK" contentType="text/Html; charset=GBK" %>
<%@page import="org.apache.axis.client.Call"%>
<%@page import="org.apache.axis.client.Service"%>
<%@page import="Javax.XML.namespace.QName"%>
<%
request.setCharacterEncoding("GBK");
String name=request.getParameter("name");
String endpoint="https://localhost/HelloClient/Service1.asmx";
Service service = new Service();
Call call = (Call)service.createCall();
call.setTargetEndpointAddress(new Java.Net.URL(endpoint));
call.setOperationName(new QName("https://www.zjh.com/SU","getName"));
call.addParameter("name",org.apache.axis.encoding.XMLType.XSD_DATE,Javax.XML.rpc.ParameterMode.IN);
call.setReturnType(org.apache.axis.encoding.XMLType.XSD_STRING);
call.setUseSOAPAction(true);
call.setSOAPActionURI("https://www.zjh.com/Rpc");
String res =(String)call.invoke(new Object[]{name});
out.print(res);
%>
這條路徑比「Java 呼叫 Java 的服務」複雜一些。服務端與 Java 使用者端都必須設定 SOAPAction,否則會拋出例外:System.Web.Services.Protocols.SoapException: 伺服器無法辨識 HTTP 標頭 SOAPAction 的值。
折騰兩天之後,可以確認一件事:透過 Web Services 讓 .NET 與 Java 互通,技術上完全可行。但有兩點必須留意:
1. 提供 Web Services 時,參數盡量選用 XML Schema 支援的型別。若採用 .NET 的 DataSet 這類型別,對 Java 端來說解析形同災難——理論上能解,但效率上不划算。Web Services 與使用者端每次交換訊息都涉及序列化與反序列化,DataSet 還要額外做序列化,很吃資源;改用 string 就單純多了。
2. 若用到 SOAP Header 等擴充功能(例如微軟的 WSE),彼此通訊需要另外做特殊處理。