博客园自动化之XML-RPC
XML-RPC
XML-RPC是一个远程过程调用(远程过程调用)(remote procedure call,RPC)的分布式计算协议,通过XML将调用函数封装,并使用HTTP协议作为发送机制。
XML-RPC发表于1998年,由UserLand Software(UserLand Software)的Dave Winer及Microsoft共同发表。后来在新的功能不断被引入下,这个标准慢慢演变成为今日的SOAP协议。
XML-RPC协议是已登记的专利项目,由Phillip Merrick、Stewart Allen及Joseph Lapp共同持有,于1998年3月提出申请,指其将用于一个构想中的应用程序,并于2006年4月获得接纳。现时这个专利由位于美国维珍尼亚州费尔法克斯的webMethods使用。
用法
XML-RPC透过向设备了这个协议的服务器发出HTTP请求。发出请求的客户端一般都是需要向远程系统要求调用的软件。
JSON-RPC(JSON-RPC)跟 XML-RPC 相类似。
数据类型
以下的例子为日常的数据类型在转化为等同的XML后的面貌:
名称 | 标记示例 | 描述 |
---|---|---|
array | ||
base64 | eW91IGNhbid0IHJlYWQgdGhpcyE= | |
boolean | 布尔型逻辑值 (0 或 1) | |
date/time | <dateTime.iso8601>19980717T14:08:55</dateTime.iso8601> | |
double | 双倍精确浮点数 | |
integer | 整数 | |
string | 字符串,必须遵守XML encoding(XML encoding)的格式。 | |
struct |
|
结构体 |
nil |
标准的XML-RPC
以下为一个寻常的 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>