用nuSOAP传递对象数组的问题终于解决

上一次成功的使用nuSOAP传递对象，实际生产过程中经常还有另外一个需求，就是远程返回对象数组。花了一下午的时间终于成功测试成功，于是迫不及待的拿出来给大家分享：）

 

准备工作

 

首先定义一个类UserInfo：

class UserInfo {
    var $UserName;
    //...
    var $Sequence;
}

 

然后写一个测试用的远程方法：

function hello() {
    $a = new UserInfo();
    $a->UserName = "Jaypei";
    $a->Sequence = 1928388199;
    $b = new UserInfo();
    $b->UserName = "cnblogs";
    $b->Sequence = 83910021;
    return array($a, $b);
}

一个普通的nuSOAP程序如下：（整个过程是对它的改造）

$soap = new soap_server();
// 使用UTF-8
$soap->soap_defencoding = 'UTF-8';
$soap->decode_utf8 = false;
// 需设置WSDL命名空间，假设jaypei.cnblogs.com
$soap->configureWSDL('jaypei.cnblogs.com', 'urn:jaypei.cnblogs.com');

//... ...

$soap->register('hello');

$soap->service($HTTP_RAW_POST_DATA);

 

 

改造过程

 

首先，注册一个UserInfo的复合类型，方法如下：（这个之前已写过）

$soap->wsdl->addComplexType(
    'UserInfo', 
    'complexType', 
    'struct', 
    'all',
    '',
    array(
        'UserName'=>array('name'=>'UserName', 'type'=>'xsd:string'),
        'Sequence'=>array('name'=>'Sequence', 'type'=>'xsd:int')
    ));

这样就可以通过以下方式返回一个单一的UserInfo对象：（hello中返回$a或者返回$b）

$soap->register('hello', array(),array('return'=>'tns:UserInfo'));

 

如果要返回一个列表，则需要改动return处的类型。起初找到了返回string或int等基础类型的列表方法，如下：

$soap->register('hello', array(), array('return'=>'SOAP-ENC:Array') );

 

当这个方法用到自定义复合类型上时类型处会变成：

xsi:type="SOAP-ENC:Array" SOAP-ENC:arrayType="object[2]"

 

object并不是我们想要的。于是上网找相关资料发现了如下方法：

$soap->register('hello', array(), array('return'=>'tns:UserInfoArray') );

这里要自定义添加一个tns:UserInfoArray的数组类型，方法如下：

$soap->wsdl->addComplexType(
    'UserInfoArray',
    'complexType',
    'array',
    '',
    'SOAP-ENC:Array',
    array(),
    array(
        array('ref'=>'SOAP-ENC:arrayType','wsdl:arrayType'=>'tns:UserInfo[]')
    ),
    'tns:UserInfo'
);

 

此时代码部分已完成，但是调用时nuSOAP缺报错了，是一个PHP错误：

Catchable fatal error: Object of class UserInfo could not be converted to string in ...\nusoap\nusoap.php on line 6002

 

于是找到nusoap.php的6002行看一下为何UserInfo向string转换：

$this->debug("serializing array element: $k, $v of type: $typeDef[arrayType]");

代码没有多看，不过很明显只是个debug的代码，没什么实际作用。于是直接注释掉继续调用，OK！通过了，一切顺利。

 

注：这个错误现在还不知是因为我的使用方法有违了设计本意还是nuSOAP本身的bug，反复列举了一些应用都没有什么问题后就算是成功了，如果有什么错误还请大家指正。