Knight of the round table

wansong

Webservice - XML-RPC

http://baike.baidu.com/view/643379.htm


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.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.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;
  /**
  *
  * <b><code>HelloClient</code></b> is a simple XML-RPC client
  * that makes an XML-RPC request to <code>HelloServer</code>
  */
  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请求中的类型是匹配的。一旦匹配成功,这个方法就被调用了,其结果被编码后返回客户方。

posted on 2011-01-05 11:23 w@ns0ng 阅读(509) 评论(0)  编辑  收藏 所属分类: J2EEweb service


只有注册用户登录后才能发表评论。


网站导航: