XML-RPC實例（Java）

在本節中，將通過Java編程語言演示如何使用XML-RPC，首先創建一個使用Java類來充當處理XML-RPC消息的服務器，然後再創建一個Java客戶端來調用服務器上的過程(函數或方法)。

Java端使用Apache XML Project的Apache XML-RPC，可從 http://xml.apache.org/xmlrpc/ 獲得。

將所有.jar文件放在適當的路徑(如：構建路徑)中，然後使用JAVA創建一個客戶端和一個小型XML-RPC服務器。

1. 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);
      }
   }
}

看看上面的示例客戶端發生是如何執行的，

Java包org.apache.xmlrpc包含XML-RPC Java客戶端和XML-RPC服務器的類，例如XmlRpcClient。
包類java.util是導入Vector類所必需的。
這裏sample表示在服務器中定義的處理程序。
注意，過程調用的所有參數始終在Vector中。
通過指定服務器計算機的「Web地址」，然後指定/RPC2來構造XmlRpcClient類。
- localhost - 是指在本地機器
- 可以指定IP號而不是localhost，例如：194.80.215.219
- 也可以指定一個域名：yiibai.com
- 可以將端口號與域名一起指定爲yiibai.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>

2. XML-RPC服務器

以下是用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

XML-RPC遠程方法調用教程

XML-RPC實例

1. XML-RPC客戶端

2. XML-RPC服務器