跳转到内容

XML-RPC

本页使用了标题或全文手工转换
维基百科,自由的百科全书

XML-RPC是一个远程过程调用Remote Procedure Call,RPC)的分布式计算协议,通过XML将调用函数封装,并使用HTTP协议作为发送机制。[1]

历史

[编辑]

XML-RPC发表于1998年,由UserLand SoftwareUserLand Software英语UserLand Software)的Dave WinerMicrosoft共同发表[2]。后来在新的功能不断被引入下,这个标准慢慢演变成为今日的SOAP协议。

XML-RPC协议是已登记的专利项目,由Phillip Merrick、Stewart Allen及Joseph Lapp共同持有,于1998年3月提出申请,指其将用于一个构想中的应用程式,并于2006年4月获得接纳。现时这个专利由位于美国维珍尼亚州费尔法克斯webMethods使用[3]

用法

[编辑]

XML-RPC透过向装置了这个协议的伺服器发出HTTP请求。发出请求的客户端一般都是需要向远程系统要求调用的软件。

JSON-RPCJSON-RPC)跟 XML-RPC 相类似。

数据类型

[编辑]

以下的例子为日常的数据类型在转化为等同的XML后的面貌:

名称 标记示例 描述
array
<array>
  <data>
    <value><i4>1404</i4></value>
    <value><string>Something here</string></value>
    <value><i4>1</i4></value>
  </data>
</array>
base64
<base64>eW91IGNhbid0IHJlYWQgdGhpcyE=</base64>
boolean
<boolean>1</boolean>
布尔型逻辑值 (0 或 1)
date/time
<dateTime.iso8601>19980717T14:08:55</dateTime.iso8601>
double
<double>-12.53</double>
双倍精确浮点数
integer
<i4>42</i4>

or

<int>42</int>
整数
string
<string>Hello world!</string>
字符串,必须遵守XML encodingXML encoding)的格式。
struct
<struct>
  <member>
    <name>foo</name>
    <value><i4>1</i4></value>
  </member>
  <member>
    <name>bar</name>
    <value><i4>2</i4></value>
  </member>
</struct>
结构体
nil
<nil/>

示例

[编辑]

以下为一个寻常的 XML-RPC 请求的示例:

<?xml version="1.0"?>
<methodCall>
  <methodName>examples.getStateName</methodName>
  <params>
    <param>
        <value><i4>40</i4></value>
    </param>
  </params>
</methodCall>

相对于上述请求,以下为一个寻常回应的示例:

<?xml version="1.0"?>
<methodResponse>
  <params>
    <param>
        <value><string>South Dakota</string></value>
    </param>
  </params>
</methodResponse>

以下为一个寻常的 XML-RPC 错误:

<?xml version="1.0"?>
<methodResponse>
  <fault>
    <value>
      <struct>
        <member>
          <name>faultCode</name>
          <value><int>4</int></value>
        </member>
        <member>
          <name>faultString</name>
          <value><string>Too many parameters.</string></value>
        </member>
      </struct>
    </value>
  </fault>
</methodResponse>

批评

[编辑]

实现

[编辑]

Python

[编辑]

C++

[编辑]

Objective-C / GNUstep / Cocoa

[编辑]

Erlang

[编辑]

Java

[编辑]

XMPP

[编辑]

Other

[编辑]

参看

[编辑]

参考资料

[编辑]
  1. ^ Simon St. Laurent, Joe Johnston, Edd Dumbill. Programming Web Services with XML-RPC. First Edition. O'Reilly. 2001-06. 
  2. ^ Box, Don. A Brief History of SOAP. O'Reilly. 2001-04-01 [2008-10-09]. (原始内容存档于2008-09-15). 
  3. ^ Merrick; et al. US Patent 7,028,312. 2006-04-11 [2008-09-18]. (原始内容存档于2011-12-03). 

外部链接

[编辑]