首先来介绍一下 XML-RPC 协议。XML-RPC 是一个通过 Internet 进行的远程过程调用协议。每一个 XML-RPC 消息都是一个 HTTP-POST 请求；请求体则是 XML 格式的。过程在服务器上执行，其返回值同样是 XML 格式。这意味着，我们需要使用 QtNetwork 和 QtXml 两个模块来实现这个客户端。

XML-RPC 协议的过程参数应该是标量，例如数字、字符串、日期等，也可以是复杂的结构体或者数组等。

XML-RPC 请求

下面是一个合法的 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 调用时）。不过，普遍情况应该是服务器处理很多类型的 HTTP 请求。在这种情况下，我们就得利用这个 URI 识别出，这个请求应该由 XML-RPC 处理代码进行处理。在这个例子中，URI 是 /RPC2，也就是说，需要将这个请求分发给 RPC2 这个响应函数。

User-Agent 和 Host 必须指定。

Content-Type 必须是 text/xml。

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

有效信息格式

有效信息以 XML 的格式发送，其根标签是 <methodCall> 。

<methodCall> 必须包含一个 <methodName> 子项，类型是一个字符串，包含需要调用的函数名称。这个字符串只能包含可识别字符：大写和小写的 A-Z，数字 0-9，下划线，点号，冒号和斜线。这个名字由服务器进行解释。例如，methodName 可以是包含可执行代码的脚本文件的文件名，可以是数据库表的单元格名，也可以是包含了子目录和子文件的文件夹名。

如果过程调用需要参数， <methodCall> 必须包含一个 <params> 子项。 <params> 则包含若干 <param> 子项，每一个 <param> 都要有一个 <value> 标签。

<value>

<value> 可以是任何标量，类型允许嵌套。合法的子标签如下表所示：

如果不能识别该类型，则当做 string 处理。

<struct>

值类型也可以是 <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>

值类型也可以是 <array> 。 <array> 包含一个 <data> 子标签， <data> 则包含若干个 <value> 。

例如，下面的示例是一个包含了四个元素的数组：

<array>
        <value><i4>12</i4></value>
        <value><string>Egypt</string></value>
        <value><boolean>0</boolean></value>
        <value><i4>-31</i4></value>
    </data>
</array>

<array> 标签没有名字。

正如上面的代码所示，我们可以将不同类型的数据组装成一个数组。

<arrays> 也可以嵌套，任何值都可以包含 <array> 或其它类型，包括 <struct> 。

XML-RPC 响应

下面是一个合法的 XML-RPC 响应：

HTTP/1.1 200 OK
Connection: close
Content-Length: 158
Content-Type: text/xml
Date: Fri, 17 Jul 1998 19:55:08 GMT
Server: UserLand Frontier/5.1.2-WinNT
<?xml version="1.0"?>
<methodResponse>
    <params>
        <param>
            <value><string>South Dakota</string></value>
        </param>
    </params>
</methodResponse>

响应格式

第一行，除非有其它服务器错误，返回值总是 200 OK。

Content-Type 是 text/xml。Content-Length 必须指定，并且是正确的。

响应体是一个 XML 结构，根标签是 <methodResponse> ，包含一个 <params> 标签，该标签又包含一个 <value> 。

<methodResponse> 也可能包含一个 <fault> 标签，这个 <fault> 包含一个 <value> ，该标签是一个 <struct> ，包含两个元素： <faultCode> ， <int> 类型以及 <faultString> ， <string> 类型。

<methodResponse> 不允许同时包含 <fault> 和 <params> 。

<fault> 示例

HTTP/1.1 200 OK
Connection: close
Content-Length: 426
Content-Type: text/xml
Date: Fri, 17 Jul 1998 19:55:02 GMT
Server: UserLand Frontier/5.1.2-WinNT
<?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>