//宣告一個簡易的 XmlRpcClient (使用標準的 J2SDK 套件)  XmlRpcClient client = new XmlRpcClient ("http://knight.fcu.edu.tw:8080/XML-RPC");  //params 存放了您的方法中所使用到的參數  Vector params = new Vector ();  params.addElement ("您的參數");  //execute 方法將回傳字傳型態  String result = (String) client.execute ("方法名稱", params);

Tip:
請各位朋友特別留意的是在當執行 execute 方法時可能會丟出 XmlRpcException 以及 IOException, 您必須再程式碼中宣告當例外發生時候的處理模式.

非同步的 XML 遠端程式呼叫:
Apache XML-RPC 援助非同步的遠端程式呼叫. 它是經由 XML-RPC Client 類別中的 eexecuteAsync() 方法來達成. 使用該方法會啟動另外一個執行緒來執行該方法的呼叫, 而 executeAsync 會立即回傳, 而不像 execute 方法會等待處理結果. 假如您想要知道遠端的執行結果, 或是想要在例外發生時被通知, 您可以傳入一個實作 org.apache.xmlrpc.AsyncCallback 介面的物件類別. 此介面定義了兩個方法:

public void handleResult (Object result, URL url, String method);
public void handleError (Exception exception, URL url, String method);

此兩方法會視遠端執行的狀況而個別被呼叫.

[使用教學 Server 篇]
在 Server 這端, 您可以選擇把函式庫綁入現有的 server 框架軟體, 或者使用此套件中內建的迷你 HTTP 伺服器. 就讓我們先來看看要如何使用 Server 端的相關類別, 並學習如何在 Server 上註冊相對應的處理物件.

XML-RPC Handler Objects
Apache XML-RPC 套件在 Server 端也同樣提供了兩個類別供各位朋友使用, 分別簡述如下:

1. org.apache.xmlrpc.XmlRpcServer
此類別為 Apache XML-RPC 中的標準 Server 類別, 可用于和現成的 Server 整合.
2. org.apache.xmlrpc.WebServer
此類別提供前面我提到的迷你 HTTP 伺服器.

上面的兩個 Server 端類別都提供下列方法以供您註冊或註銷當作 XML 遠端成呼叫處理類別的 Java 物件.

addHandler (String name, Object handler);
removeHandler (String name);

Tip:
視您提供給 Server 的處理類別, 將會出現下列的情形:
假如您傳給 XmlRpcServer 任何的 Java 物件, 它將會透過物件的自省機製 (object introspection) 嘗試著去解析所有進來的程式呼叫. 舉例來說: 透過尋找在處理類別之中的公用方法, 找出相對應于呼叫裡頭所要求的方法名稱以及參數型態. 特別留意的是在 XML 遠端程式呼叫的要求中的參數型態必須符合下列規定:

A.
XML-RPC 資料型態: <i4> or <int>
XML Parser 所產生的資料型態: java.lang.Integer
Client 所預期的資料型態: int

B.
XML-RPC 資料型態: <boolean>
XML Parser 所產生的資料型態: java.lang.Boolean
Client 所預期的資料型態: boolean

C.
XML-RPC 資料型態: <string>
XML Parser 所產生的資料型態: java.lang.String
Client 所預期的資料型態: java.lang.String

D.
XML-RPC 資料型態: <double>
XML Parser 所產生的資料型態: java.lang.Double
Client 所預期的資料型態: double

F.
XML-RPC 資料型態: <dateTime.iso8601>
XML Parser 所產生的資料型態: java.util.Date
Client 所預期的資料型態: java.util.Date

G.
XML-RPC 資料型態: <struct>
XML Parser 所產生的資料型態: java.util.Hashtable
Client 所預期的資料型態: java.util.Hashtable

H.
XML-RPC 資料型態: <array>
XML Parser 所產生的資料型態: java.util.Vector
Client 所預期的資料型態: java.util.Vector

G.
XML-RPC 資料型態: <base64>
XML Parser 所產生的資料型態: byte[ ]
Client 所預期的資料型態: byte[ ]

否則呼叫將會失敗. 同樣地, 所回傳的結果型態也必須被此 XML 遠端程式呼叫套件所援助. 而若您傳入實作 org.apache.xmlrpc.XmlRpcHandler 或 org.apache.xmlrpc.AuthenticatedXmlRpcHandler 介面的程式處理物件給 XmlRpcServer 時, execute() 方法將會在每次遠端程式呼叫時被呼叫. 因此您能夠完全的控制如何來處理 XML 遠端程式呼叫要求, 也讓您能夠對輸入和輸出的參數來作檢查以及轉換, 以及進行