j2ee|php5|web|web服务|程序|访问
PHP Weather 客户机
这一节将建立我们自己的 PHP Weather 客户机。这里提供了一些代码片段，建议下载完整的客户机和 WSDL 文件。
用于表示 Weather Service 的 ext/soap 类是 SoapClient。正如我们介绍 Weather Forecast 应用程序时所讨论的，我们知道应用服务器在 http://host:port/ItsoWebServer2RouterWeb/wsdl/itso/session/WeatherForecastEJB.wsdl 中提供了 WSDL。我们使用的是默认端口，并且在作为服务器的计算机上工作，这样就可以通过查找 WSDL 文件创建第一个 SoapClient：
＜?php
$soapClient = new SoapClient("http://localhost:9080/" .
"ItsoWebService2RouterWeb/wsdl/itso/session/WeatherForecastEJB.wsdl");
?＞
注意，因为 ext/soap 是内置的，所以，在引用 SoapClient 之前，不需要任何 include 或 require 语句。
现在已经实例化了客户机，还要联系 Weather 服务，并调用它的 getForecast 操作。在 WSDL 模式下使用 SoapClient 时，ext/soap 有一种很好的特性，即可以直接引用远程操作，就像它是 SoapClient 自身的函数一样。但是在建立输入参数时需要一点技巧。ext/soap 可以提供从 WSDL 中发现的操作和参数的数组：
$functions = $soapClient-＞__getFunctions();
print_r($functions);
$types = $soapClient-＞__getTypes();
print_r($types);
只需要显示与 getForecast 相关的结果，并重新格式化这些结果，以方便阅读，于是我们看到以下代码：
getForecastResponse getForecast(getForecast $parameters)
struct getForecast {
dateTime startDate;
int days;
}
struct getForecastResponse {
Weather getForecastReturn;
}
struct Weather {
string condition;
dateTime date;
string windDirection;
int windSpeed;
int temperatureCelsius;
boolean dbflag;
}
ext/soap 实际上并没有为我们定义 getForecast 类，我们必须创建该操作所需要的输入参数数组：
$getForecastParam = array('startDate' =＞time(), 'days' =＞ 3);
然后像 SoapClient 的方法那样调用该操作：
$forecastResponse = $soapClient-＞getForecast($getForecastParam);
最后我们得到了返回的 getForecastResponse 对象，它本身是一个 Weather 对象数组，然后在表格中显示结果：
echo "＜table border=1 cellpadding=5＞";
echo "＜tr＞＜th＞Date＜/th＞＜th＞Condition＜/th＞＜th＞Temperature＜/th＞＜th＞Wind＜/th＞＜/tr＞";
$weatherArray = $forecastResponse-＞getForecastReturn;
foreach ($weatherArray as $weather) {
echo "＜tr＞",
"＜td＞",strftime("%a. %b %d, %Y", strtotime($weather-＞date)),"＜/td＞",
"＜td＞$weather-＞condition＜/td＞",
"＜td＞$weather-＞temperatureCelsius＜/td＞",
"＜td＞$weather-＞windDirection $weather-＞windSpeed＜/td＞",
"＜/tr＞";
}
echo "＜/table＞";
PHP 客户机与 Java 客户机的输出相同，于是我们知道圣诞节期间 San Jose 不会下雪……
图 3. PHP WeatherClient
观察 SOAP 流
我们成功地与 Weather 服务取得了联系，并显示了结果。但是如果出现错误，得不到预期的结果，该怎么办？ext/soap 可以显示客户机与服务器之间交换的 SOAP 消息，能够帮助我们确定问题所在。
只有使用 trace 选项创建 SoapClient 时，才要使用跟踪功能。我们在 options 数组参数中设置 trace 选项，将该参数传递给 SoapClient 构造函数。我们将构造函数的使用改为：
$soapClient = new SoapClient("http://localhost:9080/" .
"ItsoWebService2RouterWeb/wsdl/itso/session/WeatherForecastEJB.wsdl",
array('trace' =＞ 1));
并在调用 goForecast 之后调用 trace 方法：
echo "Request :＜br＞", htmlspecialchars($soapClient-＞__getLastRequest()), "＜br＞";
echo "Response :＜br＞", htmlspecialchars($soapClient-＞__getLastResponse()), "＜br＞";
一定要使用 htmlspecialchars 内置函数对 trace 输出进行编码，因为它将 SOAP xml 分界符转换成特殊字符，如
下面是某个请求的 trace 输出：
＜?xml version="1.0" encoding="UTF-8"?＞
＜SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="http://session.itso"＞
＜SOAP-ENV:Body＞
＜ns1:getForecast＞
＜ns1:startDate＞2004-11-30T13:41:59＜/ns1:startDate＞
＜ns1:days＞0＜/ns1:days＞
＜/ns1:getForecast＞
＜/SOAP-ENV:Body＞
＜/SOAP-ENV:Envelope＞
对应的应答是：
＜?xml version="1.0" encoding="UTF-8"?＞
＜soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"＞
＜soapenv:Body＞
＜getForecastResponse xmlns="http://session.itso"＞
＜getForecastReturn xmlns:ns-239399687="http://mapping.itso"＞
＜ns-239399687:condition＞sunny＜/ns-239399687:condition＞
＜ns-239399687:date＞2004-11-30T00:00:00.000Z＜/ns-239399687:date＞
＜ns-239399687:windDirection＞W＜/ns-239399687:windDirection＞
＜ns-239399687:windSpeed＞18＜/ns-239399687:windSpeed＞
＜ns-239399687:temperatureCelsius＞6＜/ns-239399687:temperatureCelsius＞
＜ns-239399687:dbflag＞1＜/ns-239399687:dbflag＞
＜/getForecastReturn＞
＜/getForecastResponse＞
＜/soapenv:Body＞
＜/soapenv:Envelope＞
如果在开启跟踪功能的情况下运行客户机来收集这些输出，那么需要将 days 参数设置为 0，只有这样做，SOAP 应答才会输出较少的行。但是我们遇到了没有预料到的行为。我们本来期望 getForecastResponse 和以前一样是一个 Weather 对象数组，但是它应该只有一个元素，而不是 4 个元素。然而，它被转换成了一个简单的 Weather 对象，我们必须根据这种行为进行编码，就像您在最终的示例 PHP 客户机代码中看到的那样。这与 Java 客户机的行为有所不同，在客户机行为中，getForecast 总是返回 Weather 对象数组，无论服务器响应中有多少个 Weather 对象。SoapClient::_getTypes() 输出并没有为我们理解这种差异提供足够的细节，因此我们要求助于 WSDL 文档来了解完整的接口规范。
