XML-RPC入门 (转)

XML-RPC入门 (转)[@more@]

一、  什么是XML-RPCmicrosoft-com:Office:office" />

xml-rpc 是一套允许运行在不同操作系统、不同环境的程序实现基于inte.NET过程调用的规范和一系列的实现。

这种远程过程调用使用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

 

 

<?xml version="1.0"?>

  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

 

 

<?xml version="1.0"?>

 

 

  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.apache.xmlrpc.webServer;

import org.apache.xmlrpc.XmlRpc;

import Java.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.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;

 

/**

*

 * 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("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客户方所调用。在RPC中，当一个请求到达RPC服务器时，这个请求就包含了一个参数集和一个文本值，通常形成“classname.methodname”的形式。这就向RPC服务器表明，被请求的方法在为“classname”的类中，名叫“methodname”。然后RPC服务器就去搜索与之相匹配的类和方法，并把它作为那种方法参数类型的输入。这里的参数类型是与RPC请求中的类型是匹配的。一旦匹配成功，这个方法就被调用了，其结果被编码后返回客户方。

 

来自 “ ITPUB博客 ” ，链接：http://blog.itpub.net/10752043/viewspace-993068/，如需转载，请注明出处，否则将追究法律责任。

转载于:http://blog.itpub.net/10752043/viewspace-993068/