|
| |
 精品推荐 |
 |
|
| |
|
|
|
|
XML-RPC规范(中文版)
|
日期：2008年6月16日 作者： 查看:[大字体
中字体 小字体]
|
本规范说明的XML-RPC协议实现UserLand Frontier 5.1。
关于非技术性说明，请访问XML-RPC for Newbies。
文档提供了实现XML-RPC所需要的所有信息。
前言
XML-RPC是一种基于Internet的远程函数调用协议。
XML-RPC消息都是HTTP-POST请求。请求的主要部分的XML。服务器端执行后的返回结果同样也是XML格式。
函数调用的参数可以是scalars, numbers, strings, dates等等；也可以是混合型的记录和结构体。
Request请求样式
下面是一个XML-RPC请求的例子：
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"?>
<methodCall>
<methodName>examples.getStateName</methodName>
<params>
<param>
<value><i4>41</i4></value>
</param>
</params>
</methodCall>
关于请求头
第一行的URI格式不是特定的。可以为空，如果服务器只处理XML-RPC请求甚至可以只是简单的一个斜线。可是，如果服务器除了XML-RPC外还提供其他的HTTP请求，URI可以帮助我们把请求指向特定的XML-RPC服务。
User-Agent和Host项是必须的。
Content-Type的值必须是text/xml.
Content-Length必须指定，而且必须是正确的值。
有效的格式
XML-RPC具有和XML一样的有效格式，并且是一个<methodCall>结构。
<methodCall>必须包含一个值为字符型的<methodName>子元素，用来表明被调用的方法。这个字符必须符合以下规定：大小写字母、数字0-9、下划线、点、冒号和斜线。至于怎么解释这个字符串将有服务器端来决定。
例如，methodName可以是一个包含执行request请求的文件的名字，可以是数据表中列的名字，还可以是表示目录和文件结构的路径。
如果远程调用接受参数，<methodCall>就必须包含<params>子元素。<params>可以包含任意个<param>元素，每个<param>包含一个<value>子元素。
Scalar <value>s <value>
<value>值被嵌入类型标签中，支持的类型如下表:
Tag Type Example
<i4> or <int> four-byte signed integer -12
<boolean> 0 (false) or 1 (true) 1
<string> string hello world
<double> double-precision signed floating point number -12.214
<dateTime.iso8601> date/time 19980717T14:08:55
<base64> base64-encoded binary eW91IGNhbid0IHJlYWQgdGhpcyE=
如果没有指定类型，默认为字符串。
<struct>s
参数值可以是<struct>。
每个<struct>包含若干<member>，每个<member>包含一个<name>和一个<value>.
如果所示为包含两个值的<struct>
<struct>
<member>
<name>lowerBound</name>
<value><i4>18</i4></value>
</member>
<member>
<name>upperBound</name>
<value><i4>139</i4></value>
</member>
</struct>
<struct>是可以递归使用的，任何<value>都里还可以<struct>或其他任何类型，包括后面将要说明的<array>。
<array>s
上一篇:让Win2000和XP SP1支持System.EnterpriseServices
下一篇:Firefox遭遇开发人员与资金危机
|
| 相关文章： |
|
|
|
| 相关软件： |
|
|
|
|
