在本節中,將通過Java程式設計語言演示如何使用XML-RPC,首先建立一個使用Java類來充當處理XML-RPC訊息的伺服器,然後再建立一個Java用戶端來呼叫伺服器上的過程(函式或方法)。
Java端使用Apache XML Project的Apache XML-RPC,可從 http://xml.apache.org/xmlrpc/ 獲得。
將所有.jar
檔案放在適當的路徑(如:構建路徑)中,然後使用JAVA建立一個用戶端和一個小型XML-RPC伺服器。
下面編寫一個XML-RPC用戶端來呼叫一個名稱為:sum
的函式。 此函式接受兩個引數並返回它們的總和。
import java.util.*;
import org.apache.xmlrpc.*;
public class JavaClient {
public static void main (String [] args) {
try {
XmlRpcClient client = new XmlRpcClient("http://localhost/RPC2");
Vector params = new Vector();
params.addElement(new Integer(17));
params.addElement(new Integer(13));
Object result = server.execute("sample.sum", params);
int sum = ((Integer) result).intValue();
System.out.println("The sum is: "+ sum);
} catch (Exception exception) {
System.err.println("JavaClient: " + exception);
}
}
}
看看上面的範例用戶端發生是如何執行的,
org.apache.xmlrpc
包含XML-RPC Java用戶端和XML-RPC伺服器的類,例如XmlRpcClient
。java.util
是匯入Vector
類所必需的。sample
表示在伺服器中定義的處理程式。Vector
中。XmlRpcClient
類。localhost
- 是指在本地機器localhost
,例如:194.80.215.219tw511.com
tw511.com:8080
,預設埠為:80
catch
語句捕獲它。由於上述呼叫,用戶端將以下訊息傳送到伺服器。 請注意,這是由server.execute(...)
在內部處理的,所以我們不需要做什麼。
請求的內容和格式如下 -
<?xml version="1.0" encoding="ISO-8859-1"?>
<methodCall>
<methodName>sample.sum</methodName>
<params>
<param>
<value><int>17</int></value>
</param>
<param>
<value><int>13</int></value>
</param>
</params>
</methodCall>
以下是用Java編寫的XML-RPC伺服器的原始碼。 它使用了org.apache.xmlrpc.*
中提供的內建類。
import org.apache.xmlrpc.*;
public class JavaServer {
public Integer sum(int x, int y){
return new Integer(x+y);
}
public static void main (String [] args){
try {
System.out.println("Attempting to start XML-RPC Server...");
WebServer server = new WebServer(80);
server.addHandler("sample", new JavaServer());
server.start();
System.out.println("Started successfully.");
System.out.println("Accepting requests. (Halt program to stop.)");
} catch (Exception exception){
System.err.println("JavaServer: " + exception);
}
}
}
看看上面的範例伺服器中的實現工作 -
org.apache.xmlrpc
包含用於XML-RPC服務實現的WebServer
類。sum
是作為類中的公共方法實現的。80
)。catch
語句捕獲。對於給定範例用戶端中的遠端方法呼叫,伺服器將以下響應傳送回用戶端:
<?xml version="1.0" encoding="ISO-8859-1"?>
<methodResponse>
<params>
<param>
<value><int>30</int></value>
</param>
</params>
</methodResponse>
現在伺服器程式已準備好,因此提示符下編譯並執行它,如下所示:
C:\worksp\xmlrpc\java>java JavaServer
Attempting to start XML-RPC Server...
Started successfully.
Accepting requests. (Halt program to stop.)
接下來測試用戶端的呼叫結果,請按如下方式呼叫此伺服器:
C:\worksp\xmlrpc\java>java JavaClient
30