Weather Forecast 应用程序

　　我们要从 PHP 中访问的 Web 服务是一个天气预报应用程序。这是 WebSphere Version 5.1 Application Developer 5.1.1 Web Services Handbook 中开发的示例应用程序。下载示例 Weather Forecast 应用程序，请参阅本文后面的下载部分。这本书设计了几种不同的场景，但我们只考虑一种，在该书中，这种场景称为“自下而上的开发，使用 HTTP 传输和 SOAP 消息从会话 EJB 生成 Web 服务”。在这里，自下而上的意思是说，Web 服务是围绕现有企业应用程序进行包装的。

图 1. 天气预报应用程序


　　图 1 中标出的 Weather Forecast 应用程序的主要组成包括：

　　预测天气的后台 WEATHER 数据库。天气预报中的信息包括：

　　　风向，八个方位
　　　风速，公里/小时
　　　气温，摄氏度
　　　天气状况：晴、有时阴、阴、雨、暴雨
　　　日期

　　WeatherPredictor 类用于访问 WEATHER 数据库。如果数据库中没有适用于请求日期的预报，那么 WeatherPredictor 会随机生成天气预测（与实际的天气预报不同），并将它保存到数据库中。

　　业务逻辑由 WeatherForecastEJB 会话 bean 提供，并公开为 Web 服务，它提供三项操作：

　　getDayForecast 返回某一天的天气预报。

　　getForecast 返回某个时期的天气预报。

　　getTemperatures 返回某个时期的气温预测。

　　将这个会话 bean 部署为 Web 服务所需的所有元素都是由 WebSphere Studio Application Developer 的 Web 服务向导生成的，并且是作为 ItsoWebService2RouterWeb 项目生成的。路由器 servlet 是连接 SOAP 消息和 EJB 容器的桥梁，需要配置和部署路由器 servlet，通过 URL ItsoWebService2EJBRouterWeb/services/WeatherServiceEJB 来使 Weather 服务可用。WSDL 文档 itso.session.WeatherForecastEJB.wsdl 在 ItsoWebService2EJBRouterWeb/wsdl 目录中。

　　Java 客户机是这本书中开发的多个 Weather Service 客户机之一。ItsoWebService2EJBClient 项目中的 WeatherClientEJB 是一个简单的 Java servlet，调用 getForecast Web 服务操作。典型的运行结果如下所示：



图 2. Java WeatherClient
　　下一步是在 PHP 中建立等价的客户机功能。

　　阅读本文不需要自己运行这个例子，可以针对从 XMethods 网站选择的服务建立 PHP 客户机。

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 文档来了解完整的接口规范。

上一页  [1] [2] [3] [4] 下一页