xmlrpc

使用http协议做为传输协议的rpc机制，使用xml文本的方式传输命令和数据

xml rpc是使用http协议作为传输协议的rpc机制，使用xml文本的方式传输命令和数据。一个rpc系统，必然包括2个部分：1.rpc client，用来向rpc server调用方法，并接收方法的返回数据；2.rpc server,用于响应rpc client的请求，执行方法，并回送方法执行结果。RPC是Remote Procedure Call的缩写，翻译成中文就是远程过程调用，是一种在本地的机器上调用远端机器上的一个过程（方法）的技术，这个过程也被大家称为“分布式计算”，是为了提高各个分立机器的“互操作性”而发明出来的技术。

简介

按照“数据即程序”的观点来看，RPC无非是借助一些通信手段来互相传递数据（信息），所以它也是“高”层次的通信手段，无非是这种通信手段看起来更像是“过程的调用”，因为它往往以一个“函数”的面目示人，从而掩盖了她交换信息的实质。

在各种RPC技术中，我想应该以Sun的RPC最为著名，比较流行的网络文件系统NFS就是建立在SUN RPC技术基础之上的。

XMLRPC，顾名思义就是应用了XML（标准通用标记语言的子集）技术的RPC。

在Sun RPC中，调用双方传递的数据是二进制的，而在XMLRPC中数据将是XML格式的。那么为什么用XML而不用二进制呢？我想一方面应该是为了兼容更多的语言，因为这个世界上除了C/C++等编译语言，还有很多类似python，perl，javascript等的脚本语言（有些文章也称其为“动态语言”，因为他们通常不需要自己管理内存），另一方面是为了隔离操作系统的差异，比如说Little Endian和Big Endian的差异等。基于种种原因，XMLRPC选择了XML这种中间语言作为其信息的格式，然后由各个语言负责将其转变成各自native（本土）的数据类型。关于为了兼容各个语言所发明的中间语言还有IDL（Interface Definition Language:接口定义语言），它被用于CORBA接口的定义。

工作原理

完整的需要参考xmlrpc规范

简单描述:

rpcclient的工作原理:rpcclient根据URL找到rpcserver -＞构造命令包，调用rpcserver上的某个服务的某个方法 -＞接收到rpcserver的返回,解析响应包，拿出调用的返回结果。

rpcserver的工作原理:启动一个webserver(在使用内置的webserver的情况下) -＞注册每个能提供的服务，每个服务对应一个Handler类 -＞进入服务监听状态。

对应关系

参考附录中test2.XmlRPCClient类与test2.JavaServer类。

在这里简单描述一下:

xmlrpc中的Array类型，对应到java中的Vector类型

例如:在RPC Server中的某个服务方法的返回值的声明类型是String[]，但在Client中接收到的将是Vector对象;

反之，如果Client传送过去的调用参数为String[]，但在RPC Server中所接收到的将是Vector对象

当然，如果我们不使用String[]，直接声明为Vector，也是可以的。

xmlrpc中的struct类型，对应到java中的Hashtable类型

其它的类型，如:String,int,double,boolean,Date等，都比较好对应。需要注意的是:在rpc Client中，如果使用到int/double/boolean这些基本类型时，需要将他们封装成一个相应的Object，例如:Integer /Double/Boolean。

可用版本

xml rpc client和xml rpc server都有很多版本的实现。一般而言,一个实现版本都会同时实现client/server。但由于都满足xml rpc规范，从理论上讲,任何一个版本的rpc client实现与任何一个版本的rpc server都能配套使用。

更进一步，由于xml rpc以xml文本的方式,使用http协议传输，所以与编程语言无关。例如:rpc client的已实现版本包括了:perl,php,python,c/c++,java，等等;rpc server的实现语言包括perl,java,等。

同一种编程语言所实现的版本也不止一个。例如java版的实现有:Marque的xmlrpc实现,apache的xmlrpc 实现

实现版本

这个sample中，假设所传输的object都实现了XmlRPCSerializable接口。这个例子的目的是:模拟unionmon中的command对象。当假设所传输的数据是一个 Object[]时，可以用这种方式传输。结合unionmon中的代码生成机制，每个vo的序列化/反序列化方法可以在代码生成过程中完成。同样地,vox的序列化/反序列化方法需要手写。

参考代码:附录中的test3.XmlRPCSerializable , test3.AccountVO , test3.XmlRPCClient , test3.JavaServer让tomcat支持rpc server　做法:1.实现一个Servlet，并配置到tomcat中;2.让rpc client直接找这个servlet，获得服务。

注意rpc client使用的是http post方法，所以该servlet中只需要实现doPost方法。

过程:在tomcat中的web.xml增加如下配置:

SampleServiceServlet

test4.ServletXmlRPCServer

SampleServiceServlet

/SampleServiceServlet

参考类:附件中的test4.SampleService,test4.ServletXmlRPCServer,test4.XmlRPCClient

其他信息

3.1.能否通过introspect方式,使得自定义类型的vo的序列化/反序列化工作自动完成.castor可以完成对象的xml binding,似乎可参考

3.2.soap协议比xmlrpc复杂并强大。soap不熟悉。另，soap一定与web service在一起用?能否不用web service,但使用soap做rmi的协议。

例子

2.0.环境准备:下载如下包并设置到CLASSPATH中

apache xmlrpc软件包

commons-httpclient-3.0-rc4.jar

commons-codec-1.3.jar

ROS示例

在ROS中，节点之间的通信通过xmlrpc来交流信息

中文版

本规范说明的XML-RPC协议实现UserLand Frontier5.1。

关于非技术性说明，请访问XML-RPC for Newbies。

文档提供了实现XML-RPC所需要的所有信息。

前言

XML-RPC是一种基于Internet的远程函数调用协议。

XML-RPC消息都是HTTP-POST请求。请求的主要部分的XML。服务器端执行后的返回结果同样也是XML格式。

函数调用的参数可以是scalars, numbers, strings, dates等等；也可以是混合型的记录和结构体。

Request请求样式

关于请求头

第一行的URI格式不是特定的。可以为空，如果服务器只处理XML-RPC请求甚至可以只是简单的一个斜线。可是，如果服务器除了XML-RPC外还提供其他的HTTP请求，URI可以帮助我们把请求指向特定的XML-RPC服务。

User-Agent和Host项是必须的。

Content-Type的值必须是text/xml.

Content-Length必须指定，而且必须是正确的值。

有效的格式

XML-RPC具有和XML一样的有效格式，并且是一个结构。

必须包含一个值为字符型的子元素，用来表明被调用的方法。这个字符必须符合以下规定：大小写字母、数字0-9、下划线、点、冒号和斜线。至于怎么解释这个字符串将有服务器端来决定。

Scalar s

值被嵌入类型标签中，支持的类型如下表:

如果没有指定类型，默认为字符串。

参数值可以是。

每个包含若干，每个包含一个和一个.

如果所示为包含两个值的

是可以递归使用的，任何都里还可以或其他任何类型，包括后面将要说明的。

值可以个

一个简单的有一个元素。可以是任何合法类型。

下面是一个有4个值的array：

12 Egypt 0 -31

elements do not have names.

元素没有名字。

你可以混合使用上面列出的几种类型。

可以递归使用，其值可以是或其他类型，包括上面说明的。

Response应答样式

下面是一个 XML-RPC请求：

Response应答格式

除非底层操作出现错，否则总是返回200 OK.

Content-Type是text/xml。必须设置Content-Length，并且必须是正确的值。

应到内容是一个简单的XML，可是是包含一个,包含一个,包含一个。

可能含有一个< fault>标签。的值为类型,有两个元素，值为< int>的和值为的。

不能既有又有。

Fault example

Strategies/Goals

Firewalls. The goal of this protocol is to lay a compatible foundation across different environments, no new power is provided beyond the capabilities of the CGI interface. Firewall software can watch for POSTs whose Content-Type is text/xml.

Discoverability. We wanted a clean, extensible format that's very simple. It should be possible for an HTML coder to be able to look at a file containing an XML-RPC procedure call, understand what it's doing, and be able to modify it and have it work on the first or second try.

Easy to implement. We also wanted it to be an easy to implement protocol that could quickly be adapted to run in other environments or on other operating systems.

Updated 1/21/99 DW

The following questions came up on the UserLanddiscussion groupas XML-RPC was being implemented in Python.

boolean

Yes, boolean is a distinct data type. Some languages/environments allow for an easy coercion from zero to false and one to true, but if you mean true, send a boolean type with the value true, so your intent can't possibly be misunderstood.

What is the legal syntax (and range) for integers? How to deal with leading zeros? Is a leading plus sign allowed? How to deal with whitespace?

An integer is a 32-bit signed number. You can include a plus or minus at the beginning of a string of numeric characters. Leading zeros are collapsed. Whitespace is not permitted. Just numeric characters preceeded by a plus or minus.

Any characters are allowed in a string except < and &, which are encoded as < and &.A string can be used to encode binary data.

The struct element does not preserve the order of the keys. The two structs are equivalent.

Can the struct contain other members than and ? Is there a global list of faultCodes? (so they can be mapped to distinct exceptions for languages like Python and Java)?

A struct may not contain members other than those specified. This is true for all other structures. We believe the specification is flexible enough so that all reasonable data-transfer needs can be accomodated within the specified structures. If you believe strongly that this is not true, please post a message on the discussion group.

There is no global list of fault codes. It is up to the server implementer, or higher-level standards to specify fault codes.

What timezone should be assumed for the dateTime.iso8601 type? UTC? localtime?

Don't assume a timezone. It should be specified by the server in its documentation what assumptions it makes about timezones.

Additions

type. 1/21/99 DW.

Updated 6/30/03 DW

Changed copyright dates, below, to 1999-2003 from 1998-99.

This document and translations of it may be copied and furnished to others, and derivative works that comment on or otherwise explain it or assist in its implementation may be prepared, copied, published and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice and these paragraphs are included on all such copies and derivative works.

This document may not be modified in any way, such as by removing the copyright notice or references to UserLand or other organizations. Further, while these copyright restrictions apply to the written XML-RPC specification, no claim of ownership is made by UserLand to the protocol it describes. Any party may, for commercial or non-commercial purposes, implement this protocol without royalty or license fee to UserLand. The limited permissions granted herein are perpetual and will not be revoked by UserLand or its successors or assigns.

全国各地天气预报查询

上海市

云南省

云南省

云南省

云南省

云南省