分享
 
 
 

PHP5中使用Web服务访问J2EE应用程序(2)

王朝php·作者佚名  2008-05-19
窄屏简体版  字體: |||超大  

我们成功地与 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 文档来了解完整的接口规范。

解释 WSDL

我们已经成功地调用了 Weather 服务,但是还没有看过它的 WSDL 文档。WSDL 中的细节要比 SoapClient 公开的多。我们如何知道应该在 startDate 参数中放什么呢?我们应该期望从返回的数据中实际得到什么?要回答这些问题,必须更深入地分析 WSDL。

可以从下载部分下载 Weather Forecast 应用程序的 WSDL。如果使用不同的 Web 服务,只需要在浏览器中打开相应的 WSDL 文档即可。

getForecast 操作的 WSDL 是:

<wsdl:operation name="getForecast">

<wsdl:input message="intf:getForecastRequest" name="getForecastRequest"/>

<wsdl:output message="intf:getForecastResponse" name="getForecastResponse"/>

</wsdl:operation>

其中的 getForecastRequest 消息被定义为:

<wsdl:message name="getForecastRequest">

<wsdl:part element="intf:getForecast" name="parameters"/>

</wsdl:message>

而 getForecast 结构被定义为:

<element name="getForecast">

<complexType>

<sequence>

<element name="startDate" nillable="true" type="xsd:dateTime"/>

<element name="days" type="xsd:int"/>

</sequence>

</complexType>

</element>

于是我们知道该函数需要两个参数,xsd:dateTime 类型的 startDate 和整数类型的 days。这与我们所了解的 SoapClient::_getTypes 函数完全匹配,但是现在我们还知道 startDate 可以为空(nillable)。毫无疑问,如果我们简化输入参数,那么该函数将如下所示:

$forecastResponse = $soapClient->getForecast(array('startDate'=>Null, 'days'=>3));

如果明确指定今天的日期,结果会与所指定的完全一致。

如果希望制定其他起始日期怎么办呢?XML Schema将 dateTime 定义成一种基本类型,按照 ISO 8601 标准格式化,比如“2004-12-01T00:00:00”。假设希望了解三天之后的天气预报,可以使用内置函数 strtotime("+3 days") 获得需要的日期,该函数与 time() 函数相同,都返回标准 UNIX 格式的日期时间,即表示从公元纪年开始到现在的秒数的一个整数。我们知道 XML Schema 要求日期采用具有字符串字段的 ISO 8601 格式进行编码,于是在示例客户机中编写了 timeToIso8601 函数,将整数日期转换成 SOAP 编码定义的格式。但我们吃惊地发现,其实并不需要这样做,ext/soap 非常聪明地将整数日期转化成了需要的字符串字段格式。无论传递的是整数还是预格式化的字符串,都没有关系,最终传送的 SOAP 消息都是一样的。

响应中的日期又如何呢?在回程中,ext/soap 从 SOAP 响应获得了 dateTime 字段,但是没有做任何格式转换。我们希望它返回一个整数,以表示从公元纪年到现在的秒数,但实际上得到的是按照 ISO 8601 格式化的字符串。于是我们使用 strtotime 函数将其转化成整数,然后使用 strftime 格式化该整数,以便于表示。

Weather Service 按日期提供预报,但它忽略了 dateTime 编码中的时间成分。所以我们没有考虑这方面的调整,如果从运行在不同时区内的服务中请求天气预报,那么可能必须这样做。如果希望进一步了解时区转换,请参阅参考资料中给出的描述 ISO 8601 标准的文章。

现在再回到响应格式上来。上一节中曾经提到 getForecast 返回数据的不一致性。WSDL 描述告诉我们 getForecast 返回一个 getForecastResponse 对象,getForecastResponse 可以包含无限多个称为 Weather 的复杂类型的列表:

<element name="getForecastResponse">

<complexType>

<sequence>

<element maxOccurs="unbounded" name="getForecastReturn" type="tns2:Weather"/>

</sequence>

</complexType>

</element>

<complexType name="Weather">

<sequence>

<element name="condition" nillable="true" type="xsd:string"/>

<element name="date" nillable="true" type="xsd:dateTime"/>

<element name="windDirection" nillable="true" type="xsd:string"/>

<element name="windSpeed" type="xsd:int"/>

<element name="temperatureCelsius" type="xsd:int"/>

<element name="dbflag" type="xsd:boolean"/>

</sequence>

</complexType>

WSDL 不允许出现单元素数组这种特例。不幸的是,当响应只包含一个 Weather 对象时,ext/soap 没有考虑 WSDL 中应用于 getForecastResponse 的 <sequence> 标签,因为这种行为在客户机代码中造成了不必要的复杂性。

最后,WSDL 文档还告诉 SOAP 客户机可以从网络中的哪个地方找到该服务:

<wsdl:service name="WeatherForecastEJBService">

<wsdl:port binding="intf:WeatherForecastEJBSoapBinding"

name="WeatherForecastEJB">

<wsdlsoap:address location=

"http://localhost:9080/ItsoWebService2RouterWeb/services/WeatherForecastEJB"/>

</wsdl:port>

</wsdl:service>

处理 SOAP 错误

如果运行客户机时出现错误怎么办?与其他语言(如 Java)一样,PHP 5 新增加了一种异常机制。ext/soap 使用这种新的机制,以 SoapFault 对象的形式返回错误。比方说,可以用下面这种形式将代码包装起来:

try {

... some SOAP operation

} catch (SoapFault $soapFault) {

echo $soapFault;

}

注意,与 Java 有所不同,PHP 语言的 try - catch 块不能包含 finally

 
 
 
免责声明:本文为网络用户发布,其观点仅代表作者个人观点,与本站无关,本站仅提供信息存储服务。文中陈述内容未经本站证实,其真实性、完整性、及时性本站不作任何保证或承诺,请读者仅作参考,并请自行核实相关内容。
2023年上半年GDP全球前十五强
 百态   2023-10-24
美众议院议长启动对拜登的弹劾调查
 百态   2023-09-13
上海、济南、武汉等多地出现不明坠落物
 探索   2023-09-06
印度或要将国名改为“巴拉特”
 百态   2023-09-06
男子为女友送行,买票不登机被捕
 百态   2023-08-20
手机地震预警功能怎么开?
 干货   2023-08-06
女子4年卖2套房花700多万做美容:不但没变美脸,面部还出现变形
 百态   2023-08-04
住户一楼被水淹 还冲来8头猪
 百态   2023-07-31
女子体内爬出大量瓜子状活虫
 百态   2023-07-25
地球连续35年收到神秘规律性信号,网友:不要回答!
 探索   2023-07-21
全球镓价格本周大涨27%
 探索   2023-07-09
钱都流向了那些不缺钱的人,苦都留给了能吃苦的人
 探索   2023-07-02
倩女手游刀客魅者强控制(强混乱强眩晕强睡眠)和对应控制抗性的关系
 百态   2020-08-20
美国5月9日最新疫情:美国确诊人数突破131万
 百态   2020-05-09
荷兰政府宣布将集体辞职
 干货   2020-04-30
倩女幽魂手游师徒任务情义春秋猜成语答案逍遥观:鹏程万里
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案神机营:射石饮羽
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案昆仑山:拔刀相助
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案天工阁:鬼斧神工
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案丝路古道:单枪匹马
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案镇郊荒野:与虎谋皮
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案镇郊荒野:李代桃僵
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案镇郊荒野:指鹿为马
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案金陵:小鸟依人
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案金陵:千金买邻
 干货   2019-11-12
 
推荐阅读
 
 
 
>>返回首頁<<
 
靜靜地坐在廢墟上,四周的荒凉一望無際,忽然覺得,淒涼也很美
© 2005- 王朝網路 版權所有