请输入您要查询的百科知识:

 

词条 XML-RPC
释义

XML-RPC的全称是XML Remote Procedure Call,即XML远程方法调用。它是一套允许运行在不同操作系统、不同环境的程序实现基于Internet过程调用的规范和一系列的实现。这种远程过程调用使用http作为传输协议,XML作为传送信息的编码格式。Xml-Rpc的定义尽可能的保持了简单,但同时能够传送、处理、返回复杂的数据结构。

关于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.0User-Agent: Frontier/5.1.2 (WinNT)Host: betty.userland.comContent-Type: text/xmlContent-length: 181

<?xml version="1.0"?>

<methodCall>

<methodName>examples.getStateName</methodName>

<params>

<param>

<value><i4>41</i4></value>

</param>

</params>

</methodCall>

Response example

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

HTTP/1.1 200 OKConnection: closeContent-Length: 158Content-Type: text/xmlDate: Fri, 17 Jul 1998 19:55:08 GMTServer: UserLand Frontier/5.1.2-WinNT

<?xml version="1.0"?>

<methodResponse>

<params>

<param>

<value><string>South Dakota</string></value>

</param>

</params>

</methodResponse>

XML-RPC入门程序

基本做法

以下的入门程序包括一个管理器(HelloHandler)、一个服务器(HelloServer)、一个客户程序(HelloClient)。

首先要做的是创建用于远程过程调用的类和方法,人们常常称之为管理器。Xml-rpc管理器是一个方法和方法集,它接受xml-rpc请求,并对请求的内容进行解码,再向一个类和方法发出请求。

管理器类

package xmlRpc;

/**

* @author trier

*

* <b><code>HelloHandler</code></b> 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;

/**

*

* <b><code>HelloServer</code></b> is a simple XML-RPC server

* that will take the <code>HelloHandler</code> class available

* for XML-PRC calls.

* <o:p

*/

import org.apache.xmlrpc.WebServer;

import org.apache.xmlrpc.XmlRpc;

import java.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.setDriver("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;

/**

*

* <b><code>HelloClient</code></b> is a simple XML-RPC client

* that makes an XML-RPC request to <code>HelloServer</code>

*/

import java.i.IOException;

import java.util.Vector;

import org.apache.xmlrpc.XmlRpc;

import org.apache.xmlrpc.XmlRpcClient;

import java.t.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("http://localhost:8585");

//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的简单比较

调用形式

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

classname.methodname的形式

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

methodname

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

匹配成功后

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

随便看

 

百科全书收录4421916条中文百科知识,基本涵盖了大多数领域的百科知识,是一部内容开放、自由的电子版百科全书。

 

Copyright © 2004-2023 Cnenc.net All Rights Reserved
更新时间:2025/1/31 9:25:30