作者:samisa
以下文中的翻译名称对照表 :
payload: 交谈内容
object: 实例
function: 函数
使用 php来实现网络服务
使用框架: WSO2 WSF/PHP
安装环境: windows 或者 linux
(厌恶于眼下计算机文章夹杂无数难懂的翻译以及术语,此处尽量使用口语以及汉语。)
WSMessages 类:
在调用网络服务的过程中,需要两个消息,发送的消息和接受的消息,又来有往方能来往不是。 WSMessages 这个类就是在 Web services framework for php (简称 WSF)这个开源框架中,用来封装这两个消息的类。
WSMessages 有一个很重要的变量 str来保存消息内容,以 xml格式来保存“有效的载荷” (他们把这个叫做 payload,我查英文字典,就是这个意思,但是它来回的出现,反复的出现,今观之,也就是交谈内容,实际上就是除去那些 xml的定义,以及一些其他的所谓‘命名空间' ->namespace的定义而已。要搞清楚什么是命名空间,请查看 xml的 W3C定义 )。有效载荷实在是莫名其妙,我以后还是用‘交谈内容'来指代它把。
如果你通过客户程序发送一个请求,那么你需要构造一个 WSMessage 的实例,并且用 xml形式的交谈内容填写好这个实例。对应请求的回应,也还是一个‘交谈内容'会通过你的程序返回,并且返回的东西也仍然是一个 WSMessage 实例。
也就是说,你的客户端函数掉应一个网络服务,那么他的返回值也是一个 WSMessage 实例。
你可以在一个函数中发送请求,调用网络服务的程序,并且把返回内容放在 WSMessage实例中,并且让函数返回这个 WSMessage实例。
WSMessage 更倾向于发送和接受比较复杂的内容比如有附件什么的。下面就来详细解释一下如何使用 WSMessage 来实现客户端和服务端的交流。
处理交谈内容:
在此之前已经讲解过如何使用 php来创建网络服务,并且已经做了一个简单的客户 -服务端程序来说明工作流程。但是这些程序并没有深入的解释我们怎么处理‘交谈内容'。换句话来说,我们只是把 xml格式的交谈内容发送到了服务端,但并没有想到去处理它。在这里,我们来详细的解释一下如何处理交谈内容并且把它用到计算程序中去。
交谈内容是一个商业逻辑定义的内容,并且用 SOAP( Simple Object Access Protocol)来封装的,(请参见 SOAP w3c的文章)。让我们用个例子来说明如何计算一个阶乘吧。
客户端需要发送的交谈内容:
6
服务端需要明白这个交谈内容并且把变量分辨出来并且计算它的阶乘。下面就是服务端程序:
function getFactorial ( $message ) {
$simplexml = new SimpleXMLElement ( $message -> str ) ;
$value = $simplexml -> param [ 0 ] ;
$result = factorial ( $value ) ;
$responsePayloadString =
XML;
return $responsePayloadString ;
}
第 3行,我们用输入的‘交谈内容'创建了一个 simpleXmlElement 的实例。你可以看到,输入的交谈内容被保存到了通过函数参数传递进来的 WSMessage 实例 $message的 str变量中。注: SimpleXml是一个 php的扩展,用于处理 xml文件或者字符串。 WSO2 WSF/PHP并没有规定我们必须使用哪一个 php扩展来处理 xml。你可以使用你喜欢的人和 xml php 扩展来处理,比如 domdocument, saxdom之类。
第 4行将交谈内容中的参数值提取出来,这表示服务程序需要知道如何理解这些参数,比如说参数类型之类的东西。(正常来说需要在交谈内容中说明这个参数的类型)。函数中剩下的就是正常的处理阶乘。在第六行,阶乘通过调用其他函数被计算出来。从 8到 12行,回复的交谈内容也被写好并且准被返回此内容。第 14行我们返回回复的交谈内容。
回复的交谈内容应该差不多是这样的:
同样的,客户端也可以用同样的方法处理回复的交谈内容:
$response = $client -> request ( $reqestPayloadString ) ;
$simplexml = new SimpleXMLElement ( $response -> str ) ;
echo "Result = " . $simplexml -> result [ 0 ] . "
" ;
在第 3行,用回复的交谈内容创建了一个 SimpleXMLElement 实例。同样的 $response 也是一个 WSMessage的实例,我们可以访问他的成员变量 str,这个变量保存了 xml格式的回复的交谈内容。我们把它交给一个 SimpleXMLElement 构造函数,由此创建一个 SimpleXMLElement的实例。然后我们就可以访问结果元素 (或者叫节点? element, xml里面可以称之为元素,但对于树状结构的它来说,节点也不为过? )
现在你应该学会如何处理交谈信息中的内容,不管是客户端的申请也好还是服务端的回应也好。
注:在服务端的 getFactorial函数 (14行 ),你可以之间返回一个 WSmessage而不是一个回复的交谈内容。你可以用下面的这一小段程序来实现这个功能。
$outMessage = new WSMessage( $responsePayloadString );
return $outMessage ;
这其实也就是说服务端程序及可以返回 xml格式的交谈内容也可以返回 WSMessage的实例
完整的程序将在这篇文章的末尾附上。
跟踪消息
通过 WSO2 Web services framework for PHP ,你可以跟踪 SOAP消息被客户端发出,然后客户端又收到了来自服务端的消息,(即他们的交谈内容)。网络客户服务类, WSClient 有两个函数可以实现这个目的: getLastReauest()和 getLastResponse()。客户端在使用 request()这个函数以后,你可以通过这两个函数去得到交谈信息。
$response = $client -> request ( $reqestPayloadString ) ;
printf ( "
Request = %s " ,
htmlspecialchars ( $client -> getLastRequest ())) ;
printf ( "
Response = %s " ,
htmlspecialchars ( $client -> getLastResponse ())) ;
以上的程序片段会显示 request()这个函数实现的请求与回复的内容。
实际上,这段程序差不多会输出这样的东西:
Request =