XML-RPC入門 (轉)

XML-RPC入門 (轉)[@more@]

一、  什麼是-RPCmicrosoft-com::office" />

xml-rpc 是一套允許執行在不同操作、不同環境的實現基於inte過程的規範和一系列的實現。

這種過程呼叫使用http作為傳輸，xml作為傳送資訊的編碼格式。Xml-Rpc的定義儘可能的保持了簡單，但同時能夠傳送、處理、返回複雜的資料結構。

Xml-rpc是工作在internet上的遠端過程呼叫協議。一個xml-rpc訊息就是一個請求體為xml的http-post請求，被呼叫的方法在端並將執行結果以xml格式編碼後返回。

Request example

Here's an example of an XML-RPC request:

POST /RPC2 HTTP/1.0

User-Agent: Frontier/5.1.2 (WinNT)

Host: betty.userland.com

Content-Type: text/xml

Content-length: 181

 

 

  examples.getStateName

 

 

  41

 

 

 

Response example

Here's an example of a response to an XML-RPC request:

HTTP/1.1 200 OK

Connection: close

Content-Length: 158

Content-Type: text/xml

Date: Fri, 17 Jul 1998 19:55:08 GMT

Server: UserLand Frontier/5.1.2-WinNT

 

 

 

 

  South Dakota

 

 

 

 

二、  xml-rpc程式

以下的入門程式包括一個管理器（HelloHandler）、一個伺服器（HelloServer）、一個客戶程式（HelloClient）。

首先要做的是建立用於遠端過程呼叫的類和方法，人們常常稱之為管理器。Xml-rpc管理器是一個方法和方法集，它接受xml-rpc請求，並對請求的內容進行解碼，再向一個類和方法發出請求。

//管理器類

package xmlRpc;

 

/**

 * @author trier

 *

 * HelloHandler is a simple handler than can

 *  be registered with an XML-RPC server

 */

public class HelloHandler {

  public String sayHello(String name){

    return "Hello " + name;

  }

}

伺服器程式將建立的管理器註冊到伺服器上，併為伺服器指明應用程式其他特定的引數。

//伺服器類

package xmlRpc;

 

/**

 *

 * HelloServer is a simple XML-RPC server

 * that will take the HelloHandler class available

 * for XML-PRC calls.

 *

 */

import org..xmlrpc.Server;

import org.apache.xmlrpc.XmlRpc;

import .io.IOException;

 

public class HelloServer {

  public static void main(String[] args){

    if(args.length<1){

    System.out.println("Usage: java HelloServer [port]");

    System.exit(-1);

  }

  try{

    XmlRpc.set("org.apache.xerces.parsers.SAXParser");

    //start the server

    System.out.println("Starting XML-RPC Server......");

    WebServer server = new WebServer(Integer.parseInt(args[0]));

    //register our handler class

    server.addHandler("hello",new HelloHandler());

    System.out.println("Now accepting requests......");

    }catch(ClassNotFoundException e){

    System.out.println("Could not locate SAX Driver");

    }catch(IOException e){

    System.out.println("Could not start server: "+e.getMessage());

  }

  }

}

//客戶程式

package xmlRpc;

 

/**

*

 * HelloClient is a simple XML-RPC client

 * that makes an XML-RPC request to HelloServer

 */

import java.io.IOException;

import java.util.Vector;

 

import org.apache.xmlrpc.XmlRpc;

import org.apache.xmlrpc.XmlRpcClient;

import java.net.MalformedURLException;

import org.apache.xmlrpc.XmlRpcException;

 

public class HelloClient {

  public static void main(String[] args){

    if(args.length<1){

    System.out.println("Usage: java HelloClient [your name]");

    System.exit(-1);

  }

  try{

    //Use the Apache Xereces SAX Driver

    XmlRpc.setDriver("org.apache.xerces.parsers.SAXParser");

 

    //Specify the server

    XmlRpcClient client = new XmlRpcClient("");

 

    //create request

    Vector params = new Vector();

    params.addElement(args[0]);

 

    //make a request and print the result

    String result = (String)client.execute("hello.sayHello",params);

    System.out.println("Response from server: "+ result);

    }catch(ClassNotFoundException e){

    System.out.println("Could not locate SAX Driver");

    }catch(MalformedURLException e){

    System.out.println("Incorrect URL fro xml-rpc server foramt:"+e.getMessage());

    }catch(XmlRpcException e){

    System.out.println("XmlRpcException :"+e.getMessage()); 

    }catch(IOException e){

    System.out.println("IOException:"+e.getMessage());

  }

  }

}

 

三、  RPC和的簡單比較

在RMI和RPC之間最主要的區別在於方法是如何別呼叫的。在RMI中，遠端介面使每個遠端方法都具有方法簽名。如果一個方法在伺服器上執行，但是沒有相匹配的簽名被新增到這個遠端介面上，那麼這個新方法就不能被RMI客戶方所呼叫。在RPC中，當一個請求到達RPC伺服器時，這個請求就包含了一個引數集和一個文字值，通常形成“classname.methodname”的形式。這就向RPC伺服器表明，被請求的方法在為“classname”的類中，名叫“methodname”。然後RPC伺服器就去搜尋與之相匹配的類和方法，並把它作為那種方法引數型別的輸入。這裡的引數型別是與RPC請求中的型別是匹配的。一旦匹配成功，這個方法就被呼叫了，其結果被編碼後返回客戶方。