首页 > 代码库 > XML-RPC

XML-RPC

2024-07-31 14:10:47   220人阅读

XML-RPC的全称是XML Remote Procedure Call，即XML（标准通用标记语言下的一个子集）远程方法调用。它是一套允许运行在不同操作系统、不同环境的程序实现基于Internet过程调用的规范和一系列的实现。这种远程过程调用使用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
 1 <?xmlversion="1.0"?> 2 <methodCall> 3 <methodName>examples.getStateName</methodName> 4 <params> 5 <param> 6 <value> 7 <i4>41</i4> 8 </value> 9 </param>10 </params>11 </methodCall>

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 GMTServer: UserLand Frontier/5.1.2-WinNT
 1 <?xmlversion="1.0"?> 2 <methodResponse> 3 <params> 4 <param> 5 <value> 6 <string> 7 SouthDakota 8 </string> 9 </value>10 </param>11 </params>12 </methodResponse>

基本做法

以下的入门程序包括一个管理器（HelloHandler）、一个服务器（HelloServer）、一个客户程序（HelloClient）。
首先要做的是创建用于远程过程调用的类和方法，人们常常称之为管理器。XML-RPC管理器是一个方法和方法集，它接受XML-RPC请求，并对请求的内容进行解码，再向一个类和方法发出请求。

管理器类

 1 package xmlRpc; 2 /***@authortrier*********************************************************************************** 3 * <b><code>HelloHandler</code></b> 4 * is a simple handler that can be registered with an XML-RPCserver 5 **************************************************************************************************/ 6 public class HelloHandler 7 { 8     public String SayHello(String name) 9     {10         return "Hello" + name;11     }12 }

服务器程序将创建的管理器注册到服务器上，并为服务器指明应用程序其他特定的参数。

服务器类

 1 package xmlRpc; 2 /************************************************************* 3 * 4 * <b><code>HelloServer</code></b> is a simple XML-RPCserver 5 * that will take the 6 * <code>HelloHandler</code> class available for XML-PRC calls. 7 *  8 *************************************************************/ 9 import org.apache.xmlrpc.WebServer;10 import org.apache.xmlrpc.XmlRpc;11 import java.IOException;12 public class HelloServer13 {14     public static void main(String[]args)15     {16         if(args.length<1)17         {18             System.out.println("Usage:java HelloServer[port]");19             System.exit(-1);20         }21         try22         {23             XmlRpc.setDriver("org.apache.xerces.parsers.SAXParser");24 25             //start the server26             System.out.println("StartingXML-RPCServer......");27             WebServer server = newWebServer(Integer.parseInt(args[0]));28 29             //register our handler class30             server.addHandler("hello",new HelloHandler());31 32             System.out.println("Now accepting requests......");33 34         }35         catch(Class NotFoundExceptione)36         {37             System.out.println("Could not locate SAXDriver");38         }39         catch(IOExceptione)40         {41             System.out.println("Could not start server:" + e.getMessage());42         }43     }44 }

客户程序

 1 package xmlRpc; 2 /********************************************************** 3 * 4 * <b><code>HelloClient</code></b>is a simple XML-RPC client 5 * that makes an XML-RPC request to <code>HelloServer</code> 6 * 7 **********************************************************/ 8 import java.i.IOException; 9 import java.util.Vector;10 import org.apache.xmlrpc.XmlRpc;11 import org.apache.xmlrpc.XmlRpcClient;12 import java.t.MalformedURLException;13 import org.apache.xmlrpc.XmlRpcException;14 public class HelloClient15 {16     public static void main(String[]args)17     {18         if(args.length<1)19         {20             System.out.println("Usage:java HelloClient[yourname]");21             System.exit(-1);22         }23         try24         {25             //Use the Apache Xereces SAXDriver26             XmlRpc.setDriver("org.apache.xerces.parsers.SAXParser");27 28             //Specify the    server29             XmlRpcClient client = new XmlRpcClient("http://localhost:8585");30 31             //create request32             Vector params = new Vector();33             params.addElement(args[0]);34 35             //make a request and print the result36             String result = (String)client.execute("hello.sayHello",params);37             System.out.println("Response from server:" + result);38         }39         catch(ClassNotFoundExceptione)40         {41             System.out.println("Could not locate SAXDriver");42         }43         catch(MalformedURLExceptione)44         {45             System.out.println("Incorrect URL for xml-rpc server foramt:"+e.getMessage());46         }47         catch(XmlRpcExceptione)48         {49             System.out.println("XmlRpcException:"+e.getMessage());50         }51         catch(IOExceptione)52         {53             System.out.println("IOException:"+e.getMessage());54         }55     }56 }

RPC和RMI的简单比较：

调用形式

在RMI和RPC之间最主要的区别在于方法是如何被调用的。在RMI中，远程接口使每个远程方法都具有方法签名。如果一个方法在服务器上执行，但是没有相匹配的签名被添加到这个远程接口上，那么这个新方法就不能被RMI客户方所调用。

classname.methodname的形式

在RPC中，当一个请求到达RPC服务器时，这个请求就包含了一个参数集和一个文本值，通常形成“classname.methodname”的形式。

methodname

这就向RPC服务器表明，被请求的方法在为“classname”的类中，名叫“methodname”。然后RPC服务器就去搜索与之相匹配的类和方法，并把它作为那种方法参数类型的输入。这里的参数类型是与RPC请求中的类型是匹配的。

匹配成功后

一旦匹配成功，这个方法就被调用了，其结果被编码后返回客户方。

XML-RPC


联系
我们