在PHP中使用XML技术构造远程服务(下)

"struct");
?＞


第一种形式创建的是xmlrpc字符串值。第二种形式创建的是描述值和类型的值。第三种形式通过在数组之类的结构中组合其他xmlrpc值创建复杂的对象，例如：

＜?php
$myArray=new xmlrpcval(array(new xmlrpcval("Tom"), new xmlrpcval("Dick"),new xmlrpcval("Harry")), "array");
$myStruct=new xmlrpcval(array(
"name" => new xmlrpcval("Tom"),
"age" => new xmlrpcval(34, "int"),
"geek" => new xmlrpcval(1, "boolean")),"struct");
?＞


应答对象是xmlrpcresp类型，通过调用客户对象的send方法获得。在服务器端，我们可以通过如下方式创建xmlrpcresp类型的对象：

$resp=new xmlrpcresp($xmlrpcval);

而在客户端，则使用如下方法从应答获取xmlrpcval：

$xmlrpcVal=$resp->value();

接下来我们就可以用下面这种方式获取描述应答结果的PHP变量：

$scalarVal=$val->scalarval();

对于复杂的数据类型，有两个函数非常有用，这两个函数都在xmlrpc.inc内：

$arr=xmlrpc_decode($xmlrpc_val);

该函数返回一个PHP数组，其中包含了xmlrpcval变量$xmlrpc_val之内的数据，这些数据已经被转换成PHP本身具有的变量类型。

$xmlrpc_val=xmlrpc_encode($phpval);

该函数返回一个xmlrpcval类型的值，其中包含了$phpval描述的PHP数据。对于数组和结构，此方法能够进行递归分析。注意，这里不存在对非基本数据类型（如base-64数据，或者日期-时间数据）的支持。

4.3 服务器端

利用xmlrpcs.inc提供的类编写服务非常简单。要创建一个服务，我们按照如下方式创建xmlrpc_server的实例：

＜?php
$s=new xmlrpc_server( array("examples.myFunc" =>
array("function" => "foo")));
?＞

传递给xmlrpc_server构造函数的是一个联合数组的联合数组。过程“examples.myFunc”调用“foo”函数，由于这个原因foo被称为方法句柄。

编写方法句柄很简单。下面是一个方法句柄的骨架：

＜?php
function foo ($params) {
global $xmlrpcerruser; // 引入用户错误代码值
// $params是一个xmlrpcval对象的数组
if ($err) {
// 错误条件
return new xmlrpcresp(0, $xmlrpcerruser+1, // 用户错误1
"Error!");
} else {
// 成功
return new xmlrpcresp(new xmlrpcval("Fine!", "string"));
}
}
?＞


可以看到，程序检查了错误，如存在错误则返回错误（从$xmlrpcerruser+1开始）；否则如果一切正常，则返回描述操作成功信息的xmlrpcresp。

五、应用实例
在下面这个例子中我们将构造一个服务。对于给定的数值n，服务返回n*2。客户端利用该服务计算5*2的值。

服务器端的代码如下：

＜?php
include("xmlrpc.inc");
include("xmlrpcs.inc");
function foo ($params)
{
global $xmlrpcerruser; // 引入用户错误代码值
// $params是xmlrpcval对象的一个数组
$vala=$params->params[0];
$sval=$vala->scalarval();
$ret=$sval*2;
return new xmlrpcresp(new xmlrpcval($ret, "int"));
}
$s=new xmlrpc_server( array("product" =>
array("function" => "foo")));
?＞


客户端代码如下：

＜?php
include("xmlrpc.inc");
if ($HTTP_POST_VARS["number"]!="") {
$f=new xmlrpcmsg('product',array(new xmlrpcval($HTTP_POST_VARS["number"], "int")));
$c=new xmlrpc_client("/xmlrpc/servfoo.php", "luigi.melpomenia.com.ar", 80);
$c->setDebug(0);
$r=$c->send($f);
$v=$r->value();
if (!$r->faultCode()) {
print "Number ". $HTTP_POST_VARS["number"] . " is " .
$v->scalarval() . "＜BR＞";
print "＜HR＞来自服务器的结果!＜BR＞＜PRE＞" .
htmlentities($r->serialize()). "＜/PRE＞＜HR＞n";
} else {
print "操作失败: ";
print "代码: " . $r->faultCode() .
" 原因: '" .$r->faultString()."'＜BR＞";
}
}
print "＜FORM METHOD="POST"＞
＜INPUT NAME="number" VALUE="${number}"＞
＜input type="submit" value="go" name="submit"＞＜/FORM＞＜P＞
输入一个数值";
?＞


结束语：XML_RPC服务的运作还涉及其他许多基础设施和基础工作，如分布式过程的编目和索引机制，又如在编程语言中处理XML_RPC的更好接口等。有关XML_RPC和服务式Web的报道非常多，让我们密切关注它们的发展吧！

关键词：在PHP中运用XML技术构造远程服务(下)