上一次成功的使用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 ...nusoapnusoap.php on line 6002
于是找到nusoap.php的6002行看一下为何UserInfo向string转换:
$this->debug("serializing array element: $k, $v of type: $typeDef[arrayType]");
代码没有多看,不过很明显只是个debug的代码,没什么实际作用。于是直接注释掉继续调用,OK!通过了,一切顺利。
注:这个错误现在还不知是因为我的使用方法有违了设计本意还是nuSOAP本身的bug,反复列举了一些应用都没有什么问题后就算是成功了,如果有什么错误还请大家指正