理解 WSRF第1部分-使用 WS-ResourceProperties

 

本 教程是一个由 4 部分组成的系列文章中的第 1 部分,该系列介绍 WSRF(Web Services Resource Framework)背后的概念。WSRF 是一组规范,提供一种标准方式,在 Web 服务应用程序的本质上“无状态的”环境中与“有状态”资源交互。这种有状态资源实际上可以是任何东西,从数据库到电子鼠标都是有状态资源。实际上,可以使 用 WSRF 来处理任何可以通过改变其属性来操纵的东西。

WS-Resource 是一个有状态资源(比如数据库或硬盘)和它与之交互的 Web 服务的组合。本教程解释了创建 WS-Resources、请求和更新用于定义 WS-Resource 状态的属性。我们将介绍以下内容:

1.       WSRF 规范的概述。

2.       本系列教程中使用的系统的概述。

3.       关于 WSDL 的基本信息。

4.       关于的 WS-Addressing 的基本信息,WS-Addressing 用于定位 WS-Resource。

5.       创建 WS-Resource。

6.       获得和设置 WS-Resource 属性。

注意,WSRF 作为一种规范,定义了描述这些操作的 WSDL 文件的结构。该 WSDL 文件然后可以被任何语言的实现所使用。本教程描述 WSDL 文件的创建并展示产生的 SOAP 消息。

一定要明白,WSRF 规范只定义应该做什么,而不定义应该如何做。这里描述的概念的实际实现留给了应用程序去完成。在本系列的第 4 部分中,我们将使用 Globus Alliance 提供的 Core Java WSRF 类来讨论该实现。

在本系列中,我们将使用一系列围绕地球的人造卫星作为例子。我们将创建一个 WS-Resource,它就代表这样一个人造卫星。然后我们将请求它的属性以检索它的数据,更改它的属性以将它发射到天空中,并更改它观测的对象。

l         网格计算简介

首先,我们指出 WSRF 的应用远远超出了网格,但是 WSRF 是在网格中开发的,所以网格是 WSRF 可以做什么的一个很好的例子。之后,将花点时间为那些不熟悉网格的人解释一下网格是什么。

数 百万的 Web 用户已经体验了网格计算,只是大多数人都没有感觉到而已。1998 年,由于 NASA 发起了一个新计划,使得 Search for Extraterrestrial Intelligence (SETI) 项目差点夭折,此时就创建了也许是最著名的网格计算项目。他们的 Aricebo 无线电望远镜得到非常大量的数据,但是没有足够的处理能力可以处理这些数据。为了解决这个问题,他们创建了一个 screensaver,当计算机不忙时,它会从中央服务器请求一包数据并进行分析,然后把结果发送回去。然后又请求一包新的数据,并重复刚才的步骤。数 百万用户下载了 screensaver 并参与该项目。

大型网格应用程序更加复杂,要处理的问题也更多,这些问题与身份验证、跨组织边界的进程间通信和高性能数据传输等方面有关。尽管网格狂热者可能不愿意听到 SETI@Home 的情况,但是它确实提供了网格工作原理的一个很好的例子。它涉及以下步骤:

工作被分成适合于在多个系统上处理的“单元”。该“工作”可以是计算、存储或其他类型的处理。

单元被分布到多个客户机。这个步骤通过让客户机请求或“pull”工作,或者让中央服务器将工作“push”给可用的客户机来完成。

总体进展、需求和状态由中央系统或系统组维护。

当前的网格应用程序一般遵循这种模式,有一个中央系统与客户机交互,这些客户机位于那些一般在地理位置上与中央服务器分离的系统上。

l         使用 Web 服务:承诺和问题

既然多个客户机在不同的地方,那么 Web 服务应该是网格计算顺理成章的选择。毕竟,它提供一种标准而容易的方法,以从一个系统到另一个系统获得信息,而不用求助于特定于平台或语言的方法,比如 CORBA、DCOM 或 Java-RMI。

但是,原来并不是这样的。早期的网格应用程序使用其他更加不可移植的方法。但是为什么呢?

也 许最贴切的是体系结构方面的原因。尽管网格应用程序可以在很多机器上实现,但它仍然是一个应用程序,因此很难与本质上是无状态的体系结构相协调。当使用数 据库客户机连接到一个数据库时,您就保持了连接,并且可以插入记录,然后再查看插入的结果。另一个客户查看表时不会看到该记录,除非您提交了事务,但是数 据库认识您的会话,并知道是您。

Web 服 务的工作方式不是这样的。利用 Web 服务,您发出请求(比如插入一条记录)并得到响应(比如插入成功),然后断开连接。没有正在进行的会话需要管理。例如 HTTP —— 在大多数情况下,Web 服务通过 HTTP 传输 —— 每个请求独立于前一个请求,Web 服务没有访问或使用任何不是当前输入消息一部分的信息。

WSRF 的目标是通过创建“状态”概念以及处理状态的方法来解决该问题。

l         有状态资源

那么到底什么是“状态”,什么又是“有状态”资源呢?

有状态资源是一些即使您不与之交互也存在的东西。例如数据库,即使在您不查询它的时候,它也存在。围绕行星的人造卫星即使在您不与之对话时也存在。甚至简单的计数器,在调用之间,或者每次调用它返回一个 1 时,都必须存在。

此 外,一定要明白,状态概念也包含属性的思想。当要求您把所借的东西以原状态返还时,涉及某些属性的值,比如清洁度、修理要求、油罐中的汽油量,等等。有状 态资源与此类似,具有定义其状态的属性,并且这些属性就是我们将与资源交互的方式,如 WS-Resource 的属性 中所示。

l         Web 服务 + 有状态资源 = WS-Resource

根据规范可知,WS-Resource 是 Web 服务与它在其上起作用的有状态资源的组合。但是这真正的含义是什么呢?

让我们从实际的角度来看这个问题。假设我们有一个系统,涉及到管理一组人造卫星。每个人造卫星是一个有状态资源,因为即使在我们不与之对话时它也存在。我们还有一个 Web 服务,它提供人造卫星功能,比如更改反向、检索信息,或者甚至调整姿势。

通 过将者二者组合起来,我们创建了一个 WS-Resource。注意,并不需要一对一的对应关系。例如,这个 Web 服务可以与几个不同的人造卫星交互,从而创建几个引用相同服务的不同 WS-Resources。另一方面,一个人造卫星可以与几个不同的服务(比如控制宇宙实验的服务和发射激光束的服务)交互,从而创建几个引用相同有状态 资源的不同 WS-Resources。

为了使用 WS-Resource,必须了解它的属性。

l         WS-Resource 的属性

正如 有状态资源 中所提到的,有状态资源(以及 WS-Resource)具有各种与之相关的属性。例如,人造卫星可能具有以下属性:

latitude

longitude

altitude

pitch

yaw

roll

focalLength

currentView

在 本例中,latitude、longitude 和 altitude 这前三个属性指定人造卫星的位置。其次,pitch、 yaw 和 roll 指定它的方位,或者说它看起来的方向。最后两个属性,focalLength 和 currentView,指定它离观测点的距离以及它在这一点所看到的东西。

这 些属性的值定义资源的状态。更改属性值,就更改了状态。事实上,我们就是这样来控制人造卫星的。要更改它的位置,我们就改变它的一个位置属性。要更改它的 方位,我们就改变它的一个方位属性。实际上,我们想要对该人造卫星做任何事情(在这个非常有限的实现中),我们都只要改变这些属性就可以了。

但是如何来做到 这一点?

l         进入 WSRF

好了,既然 WS-Resource 是有状态资源和 Web 服务的组合,并且我们通过请求和设置它的属性来操纵它,那么如何来做到这一点呢?

有很多方法来做到这一点,但是问题也正在于此。需要的是一种做出请求的标准方式,以获取和设置各个属性。

进 入 WSRF。WSRF 实际上是一系列规范,用于定义标准的“消息模式”或方法,以请求属性的值或者指定这些属性应该变更。实际上,WSRF 定义一些标准方法,以处理关于处理 WS-Resources 的各个方面,比如处理它们的属性,从而将它们成组在一起,以达到诸如这样的目的 —— 进行身份验证,确保它们被及时地销毁。

WSRF 定 义这些操作的方法是,指定它们应该如何出现在 Web 服务描述语言(Web Services Description Language,WSDL)文件中。WSDL 文件定义 Web 服务会话两端之间传输的消息,所以通过定义 WSDL 文件,WSRF 定义了发生的任何交互的形式。

当我们说到“WSRF”时,实际上是指几个不同的规范:

1.       WS-ResourceProperties (WSRF-RP)指定 ResourceProperties 在 WSDL 文件中被定义的形式。它还指定消息的形式,这些消息用于请求和接收属性的值,还解释了如何更改、添加和删除 WS-Resource 的属性。

2.       WS-ResourceLifetime (WSRF-RL)谈论这样一些状态,即 WS-Resource 需要过期了,或者在它不再需要了时应该被显式地销毁。

3.       WS-ServiceGroup (WSRF-SG)定义创建一组 Web 服务(比如可用服务的注册表)的方法。

4.       WS-Base Faults (WSRF-BF)定义一种标准的方法,用于指出基于 WSRF 的应用程序中的错误。

您将注意到,没有哪一个规范简单地描述了所有这一切应该如何一起工作。这项工作(几乎)是由 Modeling Stateful Resources with Web Services 白皮书完成的,该书解释了一般的概念,并将它们联系在一起。

本 教程除了介绍白皮书中的一些概念之外,还将讨论 WS-ResourceProperties 规范。本系列的以后各期将讨论其他的 WSRF 规范,以及 Web Services Notifications (WSN) 规范(整个 WSRF 中都引用了这些规范)。

l         什么是 WSDL,为什么我要关注它?

在正式开始在 WSDL 文件中创建 WS-Resources 之前,我们首先花点时间来看一下 WSDL 文件的目的和结构。这些描述就是在 WSDL 文件中。

Web 服 务 —— 或者至少是与 WS-Resources 相关的 Web 服务 —— 由 SOAP 消息组成。SOAP 消息具有一个标准的“信封”,其中包含一个“有效负载”。该有效负载是由服务器(在请求时)和客户机(在响应时)分析的数据。考虑下面这个 SOAP 消息:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">

<SOAP-ENV:Header/>

<SOAP-ENV:Body>

<SetAltitudeRequest xmlns="http://example.com/satellite.xsd">

<altitude>47700</altitude>

</SetAltitudeRequest>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

它包含标准信封和有效负载,前者在 http://schemas.xmlsoap.org/soap/envelope/ 名称空间(SOAP-ENV)中,后者在 http://example.com/satellite.xsd 名称空间中。

有 效负载可以是任何东西,因此存在这样一个问题:如何定义应用程序期望看到什么,以及返回什么?因而有了 WSDL 文件的用武之地。最终,我们将使用一个 WSDL 文件来定义 WS-Resource 所使用的“消息模式”,但是在本节,我们只来看 WSDL 文件的各部分是如何组合在一起的。

l         消息和类型

我们首先定义一条我们将会发送的实际消息:

<?xml version="1.0"?>

<definitions name="Satellite"

targetNamespace="http://example.com/satellite.wsdl"

xmlns:tns="http://example.com/satellite.wsdl"

xmlns:satTypes="http://example.com/satellite.xsd"

xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"

xmlns="http://schemas.xmlsoap.org/wsdl/">

<types>

<schema targetNamespace="http://example.com/satellite.xsd"

xmlns="http://www.w3.org/2000/10/XMLSchema">

<element name="SetAltitudeRequest">

<complexType>

<all>

<element name="altitude" type="float"/>

</all>

</complexType>

</element>

<element name="SetAltitudeResponse">

<complexType>

<all>

<element name="result" type="string"/>

</all>

</complexType>

</element>

</schema>

</types>

<message name="SetAltitudeInput">

<part name="body" element="satTypes:SetAltitudeRequest"/>

</message>

<message name="SetAltitudeOutput">

<part name="body" element="satTypes:SetAltitudeResponse"/>

</message>

</definitions>

从 底部开始,我们定义了两种类型的消息。第一种是 SetAltitudeInput,这是我们将发送给服务器作为输入的消息。它是您在什么是 WSDL,为什么我要关注它? 中看到的 SOAP 消息中的消息。第二种消息是 SetAltitudeOutput,这是服务器发送给客户机的响应。两种消息都指定一个元素,消息体将放在该元素中。

这些元素的实际定义位于文件顶部的模式(schema)中。例如,SetAltitudeInput 消息包含一个 SetAltitudeRequest 元素,该元素自己又包含一个 altitude 元素,后面这个元素的内容必须是一个 float。

接下来,我们将组合这些消息,以创建服务器执行的一个操作。

l         端口类型和操作

既然知道了我们将要发送的消息是什么,现在就需要指定它们将要完成的角色。要做到这一点,我们将创建一个 portType 及其相关的 operation:

...

<message name="SetAltitudeInput">

<part name="body" element="satTypes:SetAltitudeRequest"/>

</message>

<message name="SetAltitudeOutput">

<part name="body" element="satTypes:SetAltitudeResponse"/>

</message>

<portType name="AltitudePortType">

<operation name="SetAltitude">

<input message="tns:SetAltitudeInput"

wsa:Action="http://example.com/SetAltitude" />

<output message="tns:SetAltitudeOutput"

wsa:Action="http://example.com/SetAltitudeResponse" />

</operation>

</portType>

</definitions>

这 里,我们定义了一个 portType 叫做 AltitudePortType,以及它的一个 operation 叫做 SetAltitude。我们实际上可以在该 portType 中定义任意数量的操作,但是现在我们是为了保持简单。SetAltitude 操作指定一个 input 消息 SetAltitudeInput 和一个 output 消息 SetAltitudeOutput。(下一节我们将处理 wsa:Action 属性。此外,请注意名称空间信息。)

您也可以指定一个 fault 消息在有问题时发送,在本教程系列的后面将会介绍这一点,但是现在还是保持简单。

l         服务和绑定

至此,我们已经使用 portType 定义了可以做什么 事情,但是没有定义如何 做。要完成这个过程,我们需要创建一个描述如何做的 binding,并将它附加到实际的 service:

...

<portType name="AltitudePortType">

<operation name="SetAltitude">

<input message="tns:SetAltitudeInput"

wsa:Action="http://example.com/SetAltitude" />

<output message="tns:SetAltitudeOutput"

wsa:Action="http://example.com/SetAltitudeResponse" />

</operation>

</portType>

<binding name="AltitudeSoapBinding" type="tns:AltitudePortType">

<soap:binding style="document"

transport="http://schemas.xmlsoap.org/soap/http"/>

<operation name="SetAltitude">

<input>

<soap:body use="literal"/>

</input>

<output>

<soap:body use="literal"/>

</output>

</operation>

</binding>

<service name="SatelliteService">

<port name="AltitudePort" binding="tns:AltitudeSoapBinding">

<soap:address location="http://example.com/satellite"/>

</port>

</service>

</definitions>

我们还是从底部开始,先看 service 元素。一个 WSDL 文件可以定义多个服务。例如,您可能有用于不同目的的不同服务,或者在不同位置有具有相同目的的不同服务,或者具有不同绑定的不同服务,比如一个用于 SOAP 的服务和一个用于 SMTP 的服务。

在 本例中,我们将利用一个端口 AltitudePort 来定义一个服务 SatelliteService。但是我们知道关于该端口的哪些情况呢?哦,我们知道 SOAP 请求应该发送到 http://example.com/satellite。我们还知道,为了获得关于如何发送消息的更多信息,应该检查 AltitudeSoapBinding。

AltitudeSoapBinding 指定它是 AltitudePortType 的一个实现,所以我们知道发送什么消息。binding 本身指定每个操作中的消息是如何格式化的。在本例中,我们使用“document/literal”样式,这意味着我们只是将定义好的元素拖放到 Body 中。

我们知道了消息将发送到哪里,如何格式化这些消息,以及这些消息应该是什么。到 创建 WS-Resource 一节,我们将介绍如何创建 WSRF 定义的特定消息,但是首先我们需要了解一下 WS-Addressing。

l         什么是 WS-Addressing,为什么我要关注它?

以 前,很容易指定 Web 服务的地址。所有您真正需要的就是 URL,所有其他信息都包含在 SoapAction 头部或消息本身中。现在,Web 服务应用程序变得越来越复杂,并不总是那么简单。您若想要让应答发送到除最初的请求者之外的其他地方,或者需要其他信息(比如会话标识符)来定义实际的 “位置”,那该怎么办?

或者您只是需要附加到 Web 服务的一个特定实例,那该怎么办?我们在 WS-Resources 的情况中将会遇到这个问题,所以我们需要一种处理它的方式。

WS-Addressing 提 供一种方式来指定关于位置的信息,而不只是一个统一资源标识符(Universal Resource Identifier,URI)或 URL。实际上,在我们的例子中,它提供一种标准的方式,将大量的信息添加到 SOAP 消息。我们来构造一个 SOAP 消息,比如:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:wsa="http://www.w3.org/2005/02/addressing"

xmlns:sat="http://example.org/satelliteSystem">

<SOAP-ENV:Header>

<wsa:To SOAP-ENV:mustUnderstand="1">http://example.com/satellite</wsa:To>

<wsa:Action>http://example.com/SetAltitude</wsa:Action>

<sat:SatelliteId>SAT9928</sat:SatelliteId>

</SOAP-ENV:Header>

<SOAP-ENV:Body>

<SetAltitudeRequest xmlns="http://example.com/satellite.xsd">

<altitude>47700</altitude>

</SetAltitudeRequest>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

在实际的 SOAP 消息中具有该信息似乎并不重要,但是请记住,消息可能会传输通过多个系统,甚至需要多次传输才能到达最终目的地。

要指定该信息,我们需要创建一个 EndpointReference。

WS-Addressing 引入了 EndpointReference 概念。EndpointReference 是一种方式,用于指定让消息到达适当的位置并带有适当的相关信息所需的信息。例如,我们在前一屏中指定的消息的 EndpointReference 应该是:

<wsa:EndpointReference xmlns:wsa="http://www.w3.org/2005/02/addressing"

xmlns:sat="http://example.org/satelliteSystem">

<wsa:Address>http://example.com/satellite</wsa:Address>

<wsa:ReferenceProperties>

<sat:SatelliteId>SAT9928</sat:SatelliteId>

</wsa:ReferenceProperties>

</wsa:EndpointReference>

理 解 EndpointReference 和 SOAP 消息之间的关系很重要,因为 EndpointReference 就是我们指定特定 WS-Resource 的位置的方式。例如,当我们请求创建新的 WS-Resource 时,响应将包含一个指向它的 EndpointReference。

l         什么是 WS-Resource?

至此,您应该在概念上对什么是 WS-Resource 有了很好的理解,并且应该对 WSDL 和 WS-Addressing 有了很好的基本了解。现在开始实际地创建和使用 WS-Resources。

我们首先来定义 WS-Resource 到底真正是什么。在我们的人造卫星例子中,我们可以具有几种类型的 WS-Resources,比如:

一个服务,用于设置或检索特定人造卫星的高度。

一个服务,用于设置或检索特定人造卫星的位置或方位。

一个服务,用于提供对一个进程的访问,该进程计数特定人造卫星观测到的恒星。

关于该列表有两件事情一定要注意:即所有三个 WS-Resources 都可以引用相同的人造卫星,还有,WS-Resource 是由服务和有状态资源(在本例中是人造卫星)的组合定义的,而不是由它可以执行的操作数量定义的。

现 在,我们可以说 WS-Resource 是 Web 服务和有状态资源的组合,但是我们如何在应用程序中表示这个有状态资源呢?答案就在它的 ResouceProperties 中。正如 有状态资源 中提到的,对象的状态可以由它的各种属性的值来决定。因为我们真正感兴趣的就是对象的状态,所以我们可以把有状态资源表示为一个展示其属性的 XML 文档。该文档叫做资源属性文档。在我们的人造卫星例子中,它可能是具有以下代码行的文档:

<satProp:GenericSatelliteProperties  xmlns:satProp="http://example.com/satellite">

<satProp:latitude>30.3</satProp:latitude>

<satProp:longitude>223.2</satProp:latitude>

<satProp:altitude>47700</satProp:altitude>

<satProp:pitch>49</satProp:pitch>

<satProp:yaw>0</satProp:yaw>

<satProp:roll>32</satProp:roll>

<satProp:focalLength>21999992</satProp:focalLength>

<satProp:currentView>

http://example.com/satellite/2239992333.zip

</satProp:currentView>

</satProp:GenericSatelliteProperties>

状态的更改需要一个或多个这些属性的更改,反之亦然。

就像可以通过添加成员或方法来扩展类一样,我么可以通过添加属性来扩展 WS-Resource。例如,考虑这样一种情形,我们具有一个人造卫星,它也充当恒星计数器。除了有状态资源的一般属性之外,我们可能还有一个 currentCount 属性:

<satProp:GenericSatelliteProperties

xmlns:satProp="http://example.com/satellite"

xmlns:counterProp="http://example.com/satellite/CounterSatelliteProperties">

<satProp:latitude>30.3</satProp:latitude>

<satProp:longitude>223.2</satProp:latitude>

<satProp:altitude>47700</satProp:altitude>

<satProp:pitch>49</satProp:pitch>

<satProp:yaw>0</satProp:yaw>

<satProp:roll>32</satProp:roll>

<satProp:focalLength>21999992</satProp:focalLength>

<satProp:currentView>

http://example.com/satellite/2239992333.zip

</satProp:currentView>

<counterProp:currentCount>92828</counterProp:currentCount>

</satProp:GenericSatelliteProperties>

注意新信息是在一个独立的名称空间中。

l         合并 WS- 和 Resource:WSDL 文件

至此,我们已经创建了有状态资源(人造卫星)的表示,但是要真正地创建 WS-Resource,我们还必须使用 WSDL 文件将它绑定到服务。

我们首先来看一个基本的 WSDL 文件:

<?xml version="1.0" encoding="UTF-8"?>

<definitions name="Satellite"

targetNamespace="http://example.com/satellite"

xmlns="http://schemas.xmlsoap.org/wsdl/"

xmlns:tns="http://example.com/satellite"

xmlns:wsa="http://schemas.xmlsoap.org/ws/2004/03/addressing"

xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"

xmlns:wsrp=

"http://docs.oasis-open.org/wsrf/2004/06/wsrf-WS-ResourceProperties-1.2-draft-01.xsd"

xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/">

<wsdl:import namespace=

"http://docs.oasis-open.org/wsrf/2004/06/wsrf-WS-ResourceProperties-1.2-draft-01.wsdl"

location="WS-ResourceProperties.wsdl" />

<types>

<xsd:schema targetNamespace="http://example.com/satellite"

xmlns:xsd="http://www.w3.org/2001/XMLSchema">

<xsd:import namespace=

"http://schemas.xmlsoap.org/ws/2004/03/addressing"

schemaLocation="WS-Addressing.xsd" />

</xsd:schema>

</types>

</definitions>

该 文件现在还很空,但是请注意,为了能够工作,还需要导入两个文件。WS-ResourceProperties.wsdl 和 WS-Addressing.xsd 文件的典型版本可能会引用您还没创建在机器上的目录,所以为了简单起见,您可以从教程参考资料 下载简化的版本。

既然有了框架,现在我们就来填充它吧。

首先,我们将实际的有状态资源添加到文件,并将之与 Web 服务关联:

<?xml version="1.0" encoding="UTF-8"?>

<definitions name="Satellite"

targetNamespace="http://example.com/satellite"

xmlns="http://schemas.xmlsoap.org/wsdl/"

xmlns:tns="http://example.com/satellite"

xmlns:wsa="http://schemas.xmlsoap.org/ws/2004/03/addressing"

xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"

xmlns:wsrp=

"http://docs.oasis-open.org/wsrf/2004/06/wsrf-

WS-ResourceProperties-1.2-draft-01.xsd"

xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/">

<wsdl:import namespace=

"http://docs.oasis-open.org/wsrf/2004/06/wsrf-

WS-ResourceProperties-1.2-draft-01.wsdl"

location="WS-ResourceProperties.wsdl" />

<types>

<xsd:schema targetNamespace="http://example.com/satellite"

xmlns:xsd="http://www.w3.org/2001/XMLSchema">

<xsd:import namespace=

"http://schemas.xmlsoap.org/ws/2004/03/addressing"

schemaLocation="WS-Addressing.xsd" />

<xsd:element name="latitude" type="xsd:float" />

<xsd:element name="longitude" type="xsd:float" />

<xsd:element name="altitude" type="xsd:float" />

<xsd:element name="pitch" type="xsd:float" />

<xsd:element name="yaw" type="xsd:float" />

<xsd:element name="roll" type="xsd:float" />

<xsd:element name="focalLength" type="xsd:float" />

<xsd:element name="currentView" type="xsd:string" />

<xsd:element name="GenericSatelliteProperties">

<xsd:complexType>

<xsd:sequence>

<xsd:element ref="latitude" minOccurs="1"

maxOccurs="1"/>

<xsd:element ref="longitude" minOccurs="1"

maxOccurs="1"/>

<xsd:element ref="altitude" minOccurs="1"

maxOccurs="1"/>

<xsd:element ref="pitch" minOccurs="1"

maxOccurs="1"/>

<xsd:element ref="yaw" minOccurs="1"

maxOccurs="1"/>

<xsd:element ref="roll" minOccurs="1"

maxOccurs="1"/>

<xsd:element ref="focalLength" minOccurs="1"

maxOccurs="1"/>

<xsd:element ref="currentView" minOccurs="1"

maxOccurs="1"/>

</xsd:sequence>

</xsd:complexType>

</xsd:element>

</xsd:schema>

</types>

<portType name="SatellitePortType"

wsrp:ResourceProperties=

"tns:GenericSatelliteProperties">

</portType>

<binding name="SatelliteSoapBinding"

type="tns:SatellitePortType">

<soap:binding style="document"

transport="http://schemas.xmlsoap.org/soap/http"/>

</binding>

<service name="SatelliteService">

<port name="SatellitePort"

binding="tns:SatelliteSoapBinding">

<soap:address location=

"http://example.com/satellite"/>

</port>

</service>

</definitions>

我 们首先是添加 Web 服务的基础、实际的 service 元素和将之与 portType 关联的 binding。portType 本身还没有任何操作,但是重要的部分是 wsrp:ResourceProperties 属性。该属性指定,Web 服务执行的任何操作都是在一个特定类型的有状态资源上执行的,如 GenericSatelliteProperties 元素所定义的。GenericSatelliteProperties 元素定义在 schema 中。该有状态资源和该 Web 服务的组合就是 WS-Resource。

注意,规范中指出,在创建资源属性文档(比如本例中的 GenericSatelliteProperties)时,必须 使用这里展示的样式,即初始元素是定义和引用的,而不是内联地定义的。

现在我们向 WSDL 文件添加一些实际的操作,看它是如何工作的。

l         请求新的人造卫星

当然,该练习的整个目的是真正对 WS-Resource 做一些事情,所以我们要做的第一件事情是,创建对实际 WS-Resource 实例的一个引用:

...

<types>

<xsd:schema targetNamespace="http://example.com/satellite"

xmlns:xsd="http://www.w3.org/2001/XMLSchema">

<xsd:import namespace=

"http://schemas.xmlsoap.org/ws/2004/03/addressing"

schemaLocation="WS-Addressing.xsd" />

<xsd:element name="createSatellite">

<xsd:complexType/>

</xsd:element>

<xsd:element name="createSatelliteResponse">

<xsd:complexType>

<xsd:sequence>

<xsd:element ref="wsa:EndpointReference"/>

</xsd:sequence>

</xsd:complexType>

</xsd:element>

<xsd:element name="GenericSatelliteProperties">

...

</xsd:element>

</xsd:schema>

</types>

<message name="CreateSatelliteRequest">

<part name="request" element="tns:createSatellite"/>

</message>

<message name="CreateSatelliteResponse">

<part name="response" element=

"tns:createSatelliteResponse"/>

</message>

<portType name="SatellitePortType"

wsrp:ResourceProperties=

"tns:GenericSatelliteProperties">

<operation name="createSatellite">

<input message="tns:CreateSatelliteRequest"

wsa:Action=

"http://example.com/CreateSatellite" />

<output message="tns:CreateSatelliteResponse"

wsa:Action=

"http://example.com/CreateSatelliteResponse" />

</operation>

</portType>

<binding name="SatelliteSoapBinding" type=

"tns:SatellitePortType">

<soap:binding style="document" transport=

"http://schemas.xmlsoap.org/soap/http"/>

<operation name="createSatellite">

<input>

<soap:body use="literal"/>

</input>

<output>

<soap:body use="literal"/>

</output>

</operation>

</binding>

<service name="SatelliteService">

<port name="SatellitePort" binding=

"tns:SatelliteSoapBinding">

<soap:address location=

"http://example.com/satellite"/>

</port>

</service>

</definitions>

乍 一看,这与我们在 需要了解的 WSDL 知识 中创建的 WSDL 文件没有太大的区别。我们具有一个指向 binding 的 service,binding 解释如何实现 portType。portType 定义一个操作,即 createSatellite,该操作使用一个 input 和一个 output 消息。这两个消息定义在 schema 中。

这个文件有一点稍微与最初的文件不同:不是返回一个简单的值,服务是返回一个指向新创建的 WS-Resource 的 EndpointReference。我们来看这在 SOAP 消息中是如何实现的。

l         SOAP 请求

关于创建 WS-Resource 的实际 SOAP 请求是非常简单的:

<SOAP-ENV:Envelope  xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">

<SOAP-ENV:Header/>

<SOAP-ENV:Body>

<createSatellite xmlns="http://example.com/satellite"/>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

我们还没有实际的对象,所以该请求到达 WSDL 文件中列出的 URI,并且我们将该请求定义为一个简单的 createSatellite 元素。

响应要稍微有意思一些。

l         SOAP 响应

一旦您发送针对新人造卫星的请求,服务器就创建一个对新 WS-Resource 的引用,并以 EndpointReference 形式将它返回:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">

<SOAP-ENV:Header/>

<SOAP-ENV:Body>

<wsa:EndpointReference

xmlns:wsa="http://www.w3.org/2005/02/addressing"

xmlns:sat="http://example.org/satelliteSystem">

<wsa:Address>http://example.com/satellite</wsa:Address>

<wsa:ReferenceProperties>

<sat:SatelliteId>SAT9928</sat:SatelliteId>

</wsa:ReferenceProperties>

</wsa:EndpointReference>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

注意,EndpointReference 的 Address 元素指向我们在 WSDL 文件中列出的同一 URI,所以信息仍然到达相同的地方,只是量的增多。

现 在我们应该注意,这不是一个普通的端点引用。 ReferenceProperties 元素展示一个标识符,该标识符最终将用于识别 WS-Resource,所以这实际上是一个 WS-Resource 限定的端点引用。正如您马上就会看到的,我们可以使用该信息来对 WS-Resource 做出后续调用。

l         我们想要完成什么?

好的,已经创建了 WS-Resource,那么我们可以对它做什么呢?

实 际上,可以通过调整它的属性来做任何事情。例如,可以通过更改 altitude 属性来改变人造卫星轨道的大小。不,只是更改值并不能移动人造卫星;人造卫星的实际移动是由 Web 服务背后的应用程序决定的。但是这是 WS-Resources 所真正关心的:创建一种方式,以便通过更改属性来操纵对象。规范只是指出了如何将这些更改告诉 Web 服务。它不关心应用程序是如何真正操纵对象的,我们也不关心。

但 是在真正开始更改属性之前,我们先来看看属性。在本节中,首先来看我们在 创建 WS-Resource 中创建的人造卫星 WS-Resource 的 altitude 属性。然后将讲述一次性请求所有的 orientation 值。然后再介绍使用 XPath 来查询多个值。

l         请求属性

请求属性的值是构造适当 SOAP 消息过程中的一个简单过程。例如,假设我们想要请求 altitude 属性的值。基本的 SOAP 消息可能看起来像下面这样:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:wsrp=

"http://docs.oasis-open.org/wsrf/2004/06/wsrf-WS-

ResourceProperties-1.2-draft-01.xsd">

<SOAP-ENV:Header>...</SOAP-ENV:Header>

<SOAP-ENV:Body>

<wsrp:GetResourceProperty xmlns:satProp=

"http://example.com/satellite">

satProp:altitude

</wsrp:GetResourceProperty>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

wsrp:GetResourceProperty 元素是 WS-ResourceProperties 规范的一部分。我们甚至不必在 WSDL 文件中定义它。它给我们这样一个地方,可以指定我们想要获得值的属性。

但是,SOAP 消息还没有真正完成。是的,它是一个 SOAP 消息,但是如果我们像这样把它发送给 Web 服务,服务将不知道我们引用的是哪个 WS-Resource。接下来我们将关心这个问题。

l         完全的 SOAP 请求

在前一屏,即 请求属性 中,我们创建了一个 SOAP 消息,它指定了我们想要检索的属性,但是为哪个 WS-Resource 创建的呢?

当创建人造卫星时,Web 服务返回一个指向新创建的 WS-Resource 的端点引用。我们可以将该信息添加到 SOAP 消息的 Header,像下面这样:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:sat="http://example.org/satelliteSystem"

xmlns:wsa="http://www.w3.org/2005/02/addressing"

xmlns:wsrp="http://docs.oasis-open.org/wsrf/2004/06/wsrf-

WS-ResourceProperties-1.2-draft-01.xsd">

<SOAP-ENV:Header>

<wsa:Action>

http://docs.oasis-open.org/wsrf/2004/06/WS-ResourceProperties/GetResourceProperty

</wsa:Action>

<wsa:To SOAP-ENV:mustUnderstand="1">

http://example.com/satellite

</wsa:To>

<sat:SatelliteId>SAT9928</sat:SatelliteId>

</SOAP-ENV:Header>

<SOAP-ENV:Body>

<wsrp:GetResourceProperty

xmlns:satProp="http://example.com/satellite">

satProp:altitude

</wsrp:GetResourceProperty>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

wsa:Action 元 素不是初始端点引用的一部分;它随我们想要做的事情而变化。在本例中,我们使用 GetResourceProperty 操作。wsa:To 元素从端点引用中的 wsa:Address 获得值,而任何 wsa:ReferenceProperty 值都直接包含在 Header 中。

您 会注意到,我们没有讨论 SatelliteId 值。这是故意的。包含在端点引用中的任何用于识别特定 WS-Resource 的信息都必须被应用程序忽略,只是在发送消息时要传送它。根据规范,即使尝试去解释值也认为是不适当的。这意味着被传输为一个“黑盒”,导致一种未经检查 的生活。

l         接收 ResourceProperty

一旦请求属性,就需要获得返回值,并且 WS-ResourceProperties 规范也定义了这种消息的形式。在我们的例子中,我们将接收这样一个消息:

<SOAP-ENV:Envelope xmlns:SOAP-ENV=

"http://schemas.xmlsoap.org/soap/envelope/"

xmlns:sat="http://example.org/satelliteSystem"

xmlns:wsa="http://www.w3.org/2005/02/addressing"

xmlns:wsrp=

"http://docs.oasis-open.org/wsrf/2004/06/wsrf-WS-

ResourceProperties-1.2-draft-01.xsd">

<SOAP-ENV:Header>

<wsa:Action>

http://docs.oasis-open.org/wsrf/2004/06/WS-

ResourceProperties/GetResourcePropertyResponse

</wsa:Action>

<wsa:To SOAP-ENV:mustUnderstand="1">

http://example.com/myClient

</wsa:To>

</SOAP-ENV:Header>

<SOAP-ENV:Body>

<wsrp:GetResourcePropertyResponse

xmlns:satProp=

"http://example.com/satellite">

<satProp:altitude>

47700

</satProp:altitude>

</wsrp:GetResourcePropertyResponse>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

在 本例中,Header 信息并不引用服务,而是引用客户机; http://example.com/myClient 是应该接收响应的客户机的 URI。在大多数情况下,这与发出请求的客户机是相同的,但是您也可以使用 wsa:Reply-To 元素将响应发送到别的地方。

在实际的消息体中还有一个标准元素 wsrp:GetResourcePropertyResponse,但是在本例中,它包含请求的实际属性,以及它的当前值。

现在来看这在 WSDL 文件中是什么样的。

l         WSDL 文件

为了将这些功能添加到应用程序,我们需要将它们添加到 WSDL 文件,但是因为我们使用已经定义好的标准消息交换模式,所以我们只需要添加一个新操作,像下面这样:

<?xml version="1.0" encoding="UTF-8"?>

<definitions name="Satellite"

targetNamespace="http://example.com/satellite"

xmlns="http://schemas.xmlsoap.org/wsdl/"

xmlns:tns="http://example.com/satellite"

xmlns:wsa="http://schemas.xmlsoap.org/ws/2004/03/addressing"

xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"

xmlns:wsrp="http://docs.oasis-open.org/wsrf/2004/06/

wsrf-WS-ResourceProperties-1.2-draft-01.xsd"

xmlns:wsrpwsdl=

"http://docs.oasis-open.org/wsrf/2004/06/wsrf-WS-

ResourceProperties-1.2-draft-01.wsdl"

xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/">

<wsdl:import namespace=

"http://docs.oasis-open.org/wsrf/2004/06/wsrf-WS-ResourceProperties-1.2-draft-01.wsdl"

location="WS-ResourceProperties.wsdl" />

<types>

<xsd:schema targetNamespace="http://example.com/satellite"

xmlns:xsd="http://www.w3.org/2001/XMLSchema">

...

</xsd:schema>

</types>

<message name="CreateSatelliteRequest">

<part name="request" element="tns:createSatellite"/>

</message>

<message name="CreateSatelliteResponse">

<part name="response" element="tns:createSatelliteResponse"/>

</message>

<portType name="SatellitePortType"

wsrp:ResourceProperties="tns:GenericSatelliteProperties">

<operation name="createSatellite">

<input message="tns:CreateSatelliteRequest"

wsa:Action="http://example.com/CreateSatellite" />

<output message="tns:CreateSatelliteResponse"

wsa:Action="http://example.com/CreateSatelliteResponse" />

</operation>

<operation name="getAltitude">

<input message="wsrpwsdl:GetResourcePropertyRequest"

wsa:Action="http://docs.oasis-open.org/wsrf/2004/

06/WS-ResourceProperties/GetResourceProperty/>

<output message="wsrpwsdl:GetResourcePropertyResponse"

wsa:Action="http://docs.oasis-open.org/wsrf/2004/

06/WS-ResourceProperties/GetResourcePropertyResponse/>

</operation>

</portType>

<binding name="SatelliteSoapBinding" type="tns:SatellitePortType">

<soap:binding style="document"

transport="http://schemas.xmlsoap.org/soap/http"/>

<operation name="createSatellite">

<input>

<soap:body use="literal"/>

</input>

<output>

<soap:body use="literal"/>

</output>

</operation>

<operation name="getAltitude">

<input>

<soap:body use="literal"/>

</input>

<output>

<soap:body use="literal"/>

</output>

</operation>

</binding>

<service name="SatelliteService">

<port name="SatellitePort" binding=

"tns:SatelliteSoapBinding">

<soap:address location=

"http://example.com/satellite"/>

</port>

</service>

</definitions>

一 开始是 portType,我们创建一个叫做 getAltitude 的新操作。该操作具有一个 input 和一个 output 消息,但是两个消息都已经定义在我们以前导入的 WS-ReferenceProperties.wsdl 文件中,所以我们需要做的就是使用适当的名称空间别名来引用它们。

一旦创建了 operation,我们只要将它添加到 binding 就行了,而这一点我们已经很内行了。

l         请求多个属性

幸运的是,我们并不局限于检索单个属性值。我们也可以检索多个属性:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:sat="http://example.org/satelliteSystem"

xmlns:wsa="http://www.w3.org/2005/02/addressing"

xmlns:wsrp="http://docs.oasis-open.org/wsrf/2004/06/wsrf-WS-Resour

ceProperties-1.2-draft-01.xsd">

<SOAP-ENV:Header>

<wsa:Action>

http://docs.oasis-open.org/wsrf/2004/06/

WS-ResourceProperties/GetMultipleResourceProperties

</wsa:Action>

<wsa:To SOAP-ENV:mustUnderstand="1">

http://example.com/satellite

</wsa:To>

<sat:SatelliteId>SAT9928</sat:SatelliteId>

</SOAP-ENV:Header>

<SOAP-ENV:Body>

<wsrp:GetMultipleResourceProperties

xmlns:satProp="http://example.com/satellite">

<wsrp:ResourceProperty>

satProp:roll

</wsrp:ResourceProperty>

<wsrp:ResourceProperty>

satProp:pitch

</wsrp:ResourceProperty>

<wsrp:ResourceProperty>

satProp:yaw

</wsrp:ResourceProperty>

</wsrp:GetMultipleResourceProperties>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

同前面一样,Header 中的信息来自端点引用。

l         接收多个属性

响应消息类似于它的单个属性对应物:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:sat="http://example.org/satelliteSystem"

xmlns:wsa="http://www.w3.org/2005/02/addressing"

xmlns:wsrp="http://docs.oasis-open.org/wsrf/200

4/06/wsrf-WS-ResourceProperties-1.2-draft-01.xsd">

<SOAP-ENV:Header>

<wsa:Action>

http://docs.oasis-open.org/wsrf/2004/06/WS-Res

ourceProperties/GetMultipleResourcePropertiesResponse

</wsa:Action>

<wsa:To SOAP-ENV:mustUnderstand="1">

http://example.com/myClient

</wsa:To>

</SOAP-ENV:Header>

<SOAP-ENV:Body>

<wsrp:GetMultipleResourcePropertiesResponse

xmlns:satProp="http://example.com/satellite">

<satProp:roll>32</satProp:roll>

<satProp:pitch>49</satProp:pitch>

<satProp:yaw>0</satProp:yaw>

</wsrp:GetMultipleResourcePropertiesResponse>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

同样,我们要将它添加到 WSDL 文件。

l         WSDL 文件

同样,因为我们传递的实际消息已经定义在 WS-ResourceProperties.wsdl 文件中,把该功能添加到应用程序所要做的就是创建一个新 operation:

...

<message name="CreateSatelliteRequest">

<part name="request" element=

"tns:createSatellite"/>

</message>

<message name="CreateSatelliteResponse">

<part name="response" element=

"tns:createSatelliteResponse"/>

</message>

<portType name="SatellitePortType"

wsrp:ResourceProperties =

"tns:GenericSatelliteProperties">

<operation name="createSatellite">

<input message="tns:CreateSatelliteRequest"

wsa:Action=

"http://example.com/CreateSatellite" />

<output message="tns:CreateSatelliteResponse"

wsa:Action=

"http://example.com/CreateSatelliteResponse" />

</operation>

<operation name="getAltitude">

<input message=

"wsrpwsdl:GetResourcePropertyRequest"

wsa:Action="http://docs.oasis-open.org/ws

rf/2004/06/WS-ResourceProperties/GetResourceProperty"/>

<output message=

"wsrpwsdl:GetResourcePropertyResponse"

wsa:Action="http://docs.oasis-open.org/wsrf/2004/0

6/WS-ResourceProperties/GetResourcePropertyResponse"/>

</operation>

<operation name="getOrientation">

<input message="wsrpwsdl:

GetMultipleResourcePropertiesRequest"

wsa:Action="http://docs.oasis-open.org/wsrf/2004/0

6/WS-ResourceProperties/GetMultipleResourceProperties"/>

<output message=

"wsrpwsdl:GetMultipleResourcePropertiesResponse"

wsa:Action=

"http://docs.oasis-open.org/wsrf/2004/06/WS-ResourcePro

perties/GetMultipleResourcePropertiesResponse"/>

</operation>

</portType>

<binding name="SatelliteSoapBinding" type=

"tns:SatellitePortType">

<soap:binding style="document"

transport=

"http://schemas.xmlsoap.org/soap/http"/>

<operation name="createSatellite">

<input>

<soap:body use="literal"/>

</input>

<output>

<soap:body use="literal"/>

</output>

</operation>

<operation name="getAltitude">

<input>

<soap:body use="literal"/>

</input>

<output>

<soap:body use="literal"/>

</output>

</operation>

<operation name="getOrientation">

<input>

<soap:body use="literal"/>

</input>

<output>

<soap:body use="literal"/>

</output>

</operation>

</binding>

<service name="SatelliteService">

<port name="SatellitePort" binding="tns:SatelliteSoapBinding">

<soap:address location="http://example.com/satellite"/>

</port>

</service>

</definitions>

一旦我们将 getOrientation operation 添加到了 binding,它就可以由应用程序使用了。

我们也可以查询属性,正如您马上就会看到的。

l         使用 XPath 查询

尽 管请求所需的属性相当直观,但是也有需要使用其他方法的情景。不是简单地按名称请求资源属性,我们可以使用 XPath 中可用的查询。(有关 XPath 的更多信息,请参阅 参考资料。)例如,如果不能确定某个特定的属性是否存在,您可能想要在属性上使用 XPath 函数。

XPath 的 另一个有用功能是,能够请求多个相同命名的属性,或者甚至能够查询参数。我们将在“理解 WSRF(第 2 部分)”中做前一件事,而马上就会做后一件事。例如,我们可以与 boolean() 函数一起使用一个 XPath 表达式,来确定人造卫星是否指向正确的方向,而不用显式地分析数据:

<SOAP-ENV:Envelope xmlns:SOAP-ENV=

"http://schemas.xmlsoap.org/soap/envelope/"

xmlns:sat="http://example.org/satelliteSystem"

xmlns:wsa="http://www.w3.org/2005/02/addressing"

xmlns:wsrp="http://docs.oasis-open.org/wsrf/20

04/06/wsrf-WS-ResourceProperties-1.2-draft-01.xsd">

<SOAP-ENV:Header>

<wsa:Action>

http://docs.oasis-open.org/wsrf/2004/06/WS-ResourcePro

perties/QueryResourceProperties

</wsa:Action>

<wsa:To SOAP-ENV:mustUnderstand="1">

http://example.com/satellite

</wsa:To>

<sat:SatelliteId>SAT9928</sat:SatelliteId>

</SOAP-ENV:Header>

<SOAP-ENV:Body>

<wsrp:QueryResourceProperties>

<wsrp:QueryExpression Dialect=

"http://www.w3.org/TR/1999/REC-xpath-19991116">

boolean(/*/pitch=25 and /*/roll=0 and /*/yaw=10)

</wsrp:QueryExpression>

</wsrp:QueryResourceProperties>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

注 意 Dialect 属性的使用,以区分 XPath V1.0 (这里展示的)和 XPath V2.0(http://www.w3.org/TR/2003/WD-xpath20-20031112)。规范没有限制您可以支持的方言 (dialect),但是如果实现不认识 Dialect,它就会返回一个 fault 和错误。

l         查询结果

结果看起来非常像前面的两个响应:

<SOAP-ENV:Envelope xmlns:SOAP-ENV=

"http://schemas.xmlsoap.org/soap/envelope/"

xmlns:sat="http://example.org/satelliteSystem"

xmlns:wsa="http://www.w3.org/2005/02/addressing"

xmlns:wsrp="http://docs.oasis-open.org/wsrf/20

04/06/wsrf-WS-ResourceProperties-1.2-draft-01.xsd">

<SOAP-ENV:Header>

<wsa:Action>

http://docs.oasis-open.org/wsrf/2004/06/

WS-ResourceProperties/Quer

yResourcePropertiesResponse

</wsa:Action>

<wsa:To SOAP-ENV:mustUnderstand="1">

http://example.com/myClient

</wsa:To>

</SOAP-ENV:Header>

<SOAP-ENV:Body>

<wsrp:QueryResourcePropertiesResponse>

false

</wsrp:QueryResourcePropertiesResponse>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

在本例中,我们只是返回一个布尔值,但是您可以返回 XPath 可以返回的任何类型的值。

l         WSDL 文件

同样,我们向 WSDL 文件添加一个新 operation:

...

<portType name="SatellitePortType"

wsrp:ResourceProperties=

"tns:GenericSatelliteProperties">

...

<operation name="getOrientation">

<input message=

"wsrpwsdl:GetMultipleResourcePropertiesRequest"

wsa:Action="http://docs.oasis-open.org/wsrf/20

04/06/WS-ResourceProperties/GetMultipleResourceProperties"/>

<output message=

"wsrpwsdl:GetMultipleResourcePropertiesResponse"

wsa:Action="http://docs.oasis-open.org/wsrf/2004/06/W

S-ResourceProperties/GetMultipleResourcePropertiesResponse"/>

</operation>

<operation name="checkOrientation">

<input message=

"wsrpwsdl:QueryResourcePropertiesRequest"

wsa:Action="http://docs.oasis-open.org/wsrf/20

04/06/WS-ResourceProperties/QueryResourceProperties"/>

<output message=

"wsrpwsdl:QueryResourcePropertiesResponse"

wsa:Action="http://docs.oasis-open.org/wsrf/2004/06/W

S-ResourceProperties/QueryResourcePropertiesResponse"/>

</operation>

</portType>

<binding name="SatelliteSoapBinding" type=

"tns:SatellitePortType">

<soap:binding style="document"

transport="http://schemas.xmlsoap.org/soap/http"/>

...

<operation name="getOrientation">

<input>

<soap:body use="literal"/>

</input>

<output>

<soap:body use="literal"/>

</output>

</operation>

<operation name="checkOrientation">

<input>

<soap:body use="literal"/>

</input>

<output>

<soap:body use="literal"/>

</output>

</operation>

</binding>

<service name="SatelliteService">

<port name="SatellitePort" binding=

"tns:SatelliteSoapBinding">

<soap:address location=

"http://example.com/satellite"/>

</port>

</service>

</definitions>

这关注检索属性。现在来看设置属性的值。

l         我们想要完成什么

至此,我们创建了一个 WS-Resource,并且了解了一个或多个用于表示它的状态的属性。但是这与真正地操纵 WS-Resource 没有太大的关系。在本节中,我们来看添加、悬挂和删除 WS-Resource 的属性。

至 此,我们的人造卫星已经在天空中相对于地球的轨道中稳定了,而不是观测到某些特定的东西了。在本节中,我们要添加一个 ResourceProperty,它表示一个特定的目标。然后我们通过更新位置属性将人造卫星移向该目标,然后再删除所创建的目标属性。最后,通过将适 当的操作添加到 WSDL 文件,我们将把所有事情综合在一起。

l         添加属性

向 WS-Resource 添加属性涉及到使用 Insert 元素:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:sat="http://example.org/satelliteSystem"

xmlns:wsa="http://www.w3.org/2005/02/addressing"

xmlns:wsrp="http://docs.oasis-open.org/wsrf/

2004/06/wsrf-WS-ResourceProperties-1.2-draft-01.xsd">

<SOAP-ENV:Header>

<wsa:Action>

http://docs.oasis-open.org/wsrf/2004/06/W

S-ResourceProperties/SetResourceProperties

</wsa:Action>

<wsa:To SOAP-ENV:mustUnderstand="1">

http://example.com/satellite

</wsa:To>

<sat:SatelliteId>SAT9928</sat:SatelliteId>

</SOAP-ENV:Header>

<SOAP-ENV:Body>

<wsrp:SetResourceProperties

xmlns:satProp="http://example.com/satellite">

<wsrp:Insert>

<satProp:targetCoords>

36n11, 115w08

</satProp:targetCoords>

</wsrp:Insert>

</wsrp:SetResourceProperties>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

我们可以给这个新属性取任何好听的名字,但是我们必须允许该新元素在 Resource Properties 文档中。(当我们在 WSDL 文件 中调整 WSDL 文件时将来做这一件事。)

l         添加属性的结果

当成功添加、删除或更改属性之后,我们将会得到一个只是确认操作的响应消息:

<SOAP-ENV:Envelope xmlns:SOAP-ENV=

"http://schemas.xmlsoap.org/soap/envelope/"

xmlns:sat="http://example.org/satelliteSystem"

xmlns:wsa="http://www.w3.org/2005/02/addressing"

xmlns:wsrp="http://docs.oasis-open.org/wsrf/

2004/06/wsrf-WS-ResourceProperties-1.2-draft-01.xsd">

<SOAP-ENV:Header>

<wsa:Action>

http://docs.oasis-open.org/wsrf/2004/06/W

S-ResourceProperties/SetResourcePropertiesResponse

</wsa:Action>

<wsa:To SOAP-ENV:mustUnderstand="1">

http://example.com/myClient

</wsa:To>

</SOAP-ENV:Header>

<SOAP-ENV:Body>

<wsrp:SetResourcePropertiesResponse>

</wsrp:SetResourcePropertiesResponse>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

该响应与 Update 和 Delete 操作产生的响应是相同的。

l         更改属性值

在 添加属性 中,我们添加了一个新属性,但是我们也能更改现有属性的值。例如,我们可以告诉系统,通过使用 Update 元素更改人造卫星的位置属性来移动人造卫星:

<SOAP-ENV:Envelope xmlns:SOAP-ENV=

"http://schemas.xmlsoap.org/soap/envelope/"

xmlns:sat="http://example.org/satelliteSystem"

xmlns:wsa="http://www.w3.org/2005/02/addressing"

xmlns:wsrp="http://docs.oasis-open.org/wsrf/2004/0

6/wsrf-WS-ResourceProperties-1.2-draft-01.xsd">

<SOAP-ENV:Header>

<wsa:Action>

http://docs.oasis-open.org/wsrf/2004/06/WS-Re

sourceProperties/SetResourceProperties

</wsa:Action>

<wsa:To SOAP-ENV:mustUnderstand="1">

http://example.com/satellite

</wsa:To>

<sat:SatelliteId>SAT9928</sat:SatelliteId>

</SOAP-ENV:Header>

<SOAP-ENV:Body>

<wsrp:SetResourceProperties

xmlns:satProp="http://example.com/satellite">

<wsrp:Update>

<satProp:latitude>36.11</satProp:latitude>

</wsrp:Update>

<wsrp:Update>

<satProp:longitude>158.08</satProp:latitude>

</wsrp:Update>

</wsrp:SetResourceProperties>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

在本例中,我们使用了两个 Update 组件,但是我们实际上可以使用 Insert、Update 和 Delete 组件的任意组合。

l         删除属性

属性可以被完全删除。例如,如果我们决定不再观测某个特定的目标,就可以删除该属性:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:sat="http://example.org/satelliteSystem"

xmlns:wsa="http://www.w3.org/2005/02/addressing"

xmlns:wsrp="http://docs.oasis-open.org/wsrf/2004/06/wsrf-WS-Resour

ceProperties-1.2-draft-01.xsd">

<SOAP-ENV:Header>

<wsa:Action>

http://docs.oasis-open.org/wsrf/2004/06/WS-Resou

rceProperties/SetResourceProperties

</wsa:Action>

<wsa:To SOAP-ENV:mustUnderstand="1">

http://example.com/satellite

</wsa:To>

<sat:SatelliteId>SAT9928</sat:SatelliteId>

</SOAP-ENV:Header>

<SOAP-ENV:Body>

<wsrp:SetResourceProperties

xmlns:satProp="http://example.com/satellite">

<wsrp:Delete resourceProperty="targetCoords"/>

</wsrp:SetResourceProperties>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

同样,我们的资源属性文档的模式定义必须允许我们做这一更改。

l         WSDL 文件

同样,因为标准元素已经定义在 WS-ResourceProperties.wsdl 中,所以我们可以简单地添加新操作:

<?xml version="1.0" encoding="UTF-8"?>

<definitions name="Satellite"

targetNamespace="http://example.com/satellite"

xmlns="http://schemas.xmlsoap.org/wsdl/"

xmlns:tns="http://example.com/satellite"

xmlns:wsa="http://schemas.xmlsoap.org/ws/2004/03/addressing"

xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"

xmlns:wsrp="http://docs.oasis-open.org/wsrf/2004/06/

wsrf-WS-ResourceProperties-1.2-draft-01.xsd"

xmlns:wsrpwsdl="http://docs.oasis-open.org/wsrf/200

4/06/wsrf-WS-ResourceProperties-1.2-draft-01.wsdl"

xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/">

<wsdl:import namespace="http://docs.oasis-open.org/

wsrf/2004/06/wsrf-WS-ResourceProperties-1.2-draft-01.wsdl"

location="WS-ResourceProperties.wsdl" />

<types>

<xsd:schema

targetNamespace="http://example.com/satellite"

xmlns:xsd="http://www.w3.org/2001/XMLSchema">

<xsd:import namespace=

"http://schemas.xmlsoap.org/ws/2004/03/addressing"

schemaLocation="WS-Addressing.xsd" />

<xsd:element name="createSatellite">

<xsd:complexType/>

</xsd:element>

<xsd:element name="createSatelliteResponse">

<xsd:complexType>

<xsd:sequence>

<xsd:element ref=

"wsa:EndpointReference"/>

</xsd:sequence>

</xsd:complexType>

</xsd:element>

<xsd:element name="latitude" type="xsd:float" />

<xsd:element name="longitude" type="xsd:float" />

<xsd:element name="altitude" type="xsd:float" />

<xsd:element name="pitch" type="xsd:float" />

<xsd:element name="yaw" type="xsd:float" />

<xsd:element name="roll" type="xsd:float" />

<xsd:element name="focalLength" type="xsd:float" />

<xsd:element name="currentView" type="xsd:string" />

<xsd:element name="GenericSatelliteProperties">

<xsd:complexType>

<xsd:sequence>

<xsd:element ref="latitude" minOccurs="1"

maxOccurs="1"/>

<xsd:element ref="longitude" minOccurs="1"

maxOccurs="1"/>

<xsd:element ref="altitude" minOccurs="1"

maxOccurs="1"/>

<xsd:element ref="pitch" minOccurs="1"

maxOccurs="1"/>

<xsd:element ref="yaw" minOccurs="1"

maxOccurs="1"/>

<xsd:element ref="roll" minOccurs="1"

maxOccurs="1"/>

<xsd:element ref="focalLength"

minOccurs="1" maxOccurs="1"/>

<xsd:element ref="currentView"

minOccurs="1" maxOccurs="1"/>

<xsd:any/>

</xsd:sequence>

</xsd:complexType>

</xsd:element>

</xsd:schema>

</types>

<message name="CreateSatelliteRequest">

<part name="request" element="tns:createSatellite"/>

</message>

<message name="CreateSatelliteResponse">

<part name="response" element=

"tns:createSatelliteResponse"/>

</message>

<portType name="SatellitePortType"

wsrp:ResourceProperties=

"tns:GenericSatelliteProperties">

<operation name="createSatellite">

<input message="tns:CreateSatelliteRequest"

wsa:Action="http://example.com/CreateSatellite" />

<output message="tns:CreateSatelliteResponse"

wsa:Action=

"http://example.com/CreateSatelliteResponse" />

</operation>

<operation name="getAltitude">

<input message=

"wsrpwsdl:GetResourcePropertyRequest"

wsa:Action="http://docs.oasis-open.org/wsr

f/2004/06/WS-ResourceProperties/GetResourceProperty"/>

<output message=

"wsrpwsdl:GetResourcePropertyResponse"

wsa:Action="http://docs.oasis-open.org/wsrf/2004/0

6/WS-ResourceProperties/GetResourcePropertyResponse"/>

</operation>

<operation name="getOrientation">

<input message=

"wsrpwsdl:GetMultipleResourcePropertiesRequest"

wsa:Action="http://docs.oasis-open.org/wsrf/2004/0

6/WS-ResourceProperties/GetMultipleResourceProperties"/>

<output message=

"wsrpwsdl:GetMultipleResourcePropertiesResponse"

wsa:Action=

"http://docs.oasis-open.org/wsrf/2004/06/WS-ResourceProp

erties/GetMultipleResourcePropertiesResponse"/>

</operation>

<operation name="checkOrientation">

<input message=

"wsrpwsdl:QueryResourcePropertiesRequest"

wsa:Action="http://docs.oasis-open.org/wsr

f/2004/06/WS-ResourceProperties/QueryResourceProperties"/>

<output message=

"wsrpwsdl:QueryResourcePropertiesResponse"

wsa:Action="http://docs.oasis-open.org/wsrf/2004/0

6/WS-ResourceProperties/QueryResourcePropertiesResponse"/>

</operation>

<operation name="addTarget">

<input message=

"wsrpwsdl:SetResourcePropertiesRequest"

wsa:Action="http://docs.oasis-open.org/wsrf/2004/0

6/WS-ResourceProperties/SetResourceProperty"/>

<output message=

"wsrpwsdl:SetResourcePropertiesResponse"

wsa:Action="http://docs.oasis-open.org/wsrf/2004/0

6/WS-ResourceProperties/SetResourcePropertyResponse"/>

</operation>

<operation name="moveToTarget">

<input message=

"wsrpwsdl:SetResourcePropertiesRequest"

wsa:Action="http://docs.oasis-open.org/wsrf/2004/0

6/WS-ResourceProperties/SetResourceProperty"/>

<output message=

"wsrpwsdl:SetResourcePropertiesResponse"

wsa:Action="http://docs.oasis-open.org/wsrf/2004/0

6/WS-ResourceProperties/SetResourcePropertyResponse"/>

</operation>

<operation name="removeTarget">

<input message=

"wsrpwsdl:SetResourcePropertiesRequest"

wsa:Action="http://docs.oasis-open.org/ws

rf/2004/06/WS-ResourceProperties/SetResourceProperty"/>

<output message=

"wsrpwsdl:SetResourcePropertiesResponse"

wsa:Action="http://docs.oasis-open.org/wsrf/2004/0

6/WS-ResourceProperties/SetResourcePropertyResponse"/>

</operation>

</portType>

<binding name="SatelliteSoapBinding"

type="tns:SatellitePortType">

<soap:binding style="document" transport=

"http://schemas.xmlsoap.org/soap/http"/>

<operation name="createSatellite">

<input>

<soap:body use="literal"/>

</input>

<output>

<soap:body use="literal"/>

</output>

</operation>

<operation name="getAltitude">

<input>

<soap:body use="literal"/>

</input>

<output>

<soap:body use="literal"/>

</output>

</operation>

<operation name="getOrientation">

<input>

<soap:body use="literal"/>

</input>

<output>

<soap:body use="literal"/>

</output>

</operation>

<operation name="checkOrientation">

<input>

<soap:body use="literal"/>

</input>

<output>

<soap:body use="literal"/>

</output>

</operation>

<operation name="addTarget">

<input>

<soap:body use="literal"/>

</input>

<output>

<soap:body use="literal"/>

</output>

</operation>

<operation name="moveToTarget">

<input>

<soap:body use="literal"/>

</input>

<output>

<soap:body use="literal"/>

</output>

</operation>

<operation name="removeTarget">

<input>

<soap:body use="literal"/>

</input>

<output>

<soap:body use="literal"/>

</output>

</operation>

</binding>

<service name="SatelliteService">

<port name="SatellitePort"

binding="tns:SatelliteSoapBinding">

<soap:address location=

"http://example.com/satellite"/>

</port>

</service>

</definitions>

还请注意,我们可以添加任意元素到 GenericSatelliteProperties,所以我们可以容易地添加新属性,比如 targetCoords。

l         结束语

在本教程,也即 4 篇关于 WSRF 的系列文章中的第一篇文章中,我们一开始解释了 WSRF 背后的目的,以及为什么单有 Web 服务还不够。然后解释了 WS-Resource 是有状态资源(比如数据库或卫星)与 Web 服务的组合。

资源本身是由一系列属性来描述的,这些属性是与 WSDL 文件中的 Web 服务相关联的。我们还介绍了 WSDL 和 WS-Addressing 的基础,WSRF 使用 WS-Addressing 来指向一个特定的 WS-Resource 实例。

我们介绍了创建 WS-Resources,了解了它们的属性,以及调整这些属性,以便操纵资源。

在 本系列的以后部分中,我们将会介绍 WSRF 的一些更高级的用途,比如 ServiceGroups 和错误处理,以及 WS-Notifications。在本系列的最后一部分中,我们将把所有内容综合在一起,并编写一个应用程序,它使用类来实现本系列前两部分中讨论的每 个概念。

l         参考资料

Web 服务资源框架(Web Services Resource Framework,WSRF)涉及大量不同领域。下面是起步所需的一些参考资料:

单击 下载本教程中介绍的完整 WSDL 文件。

WSRF 和相关规范

WSRF 文档 的主要位置在 Globus Alliance Web 站点上,但是最新的规范可以在 Oasis 处找到。文档包括:

Web 服务资源框架(白皮书)

The WS-Resource Framework

WS-ResourceProperties (WSRF-RP)

WS-ResourceLifetime (WSRF-RL)

WS-ServiceGroup (WSRF-SG)

WS-Base Faults (WSRF-BF)

Web 服务和相关的规范

Author: orangelizq
email: orangelizq@163.com

[转]理解WSRF之一 使用WS-ResourceProperties (整理自IBM网站)的更多相关文章

  1. 转载网易博客:整理各大网站让网站变灰的css代码

    2013-07-21 15:06:47 北京时间2013年4月20日8时02分四川省雅安市芦山县(北纬30.3,东经103.0)发生7.0级地震.震源深度13公里.各大网站将其网站变灰,本人整理了下部 ...

  2. 深入理解javascript函数定义与函数作用域

    最近在学习javascript的函数,函数是javascript的一等对象,想要学好javascript,就必须深刻理解函数.本人把思路整理成文章,一是为了加深自己函数的理解,二是给读者提供学习的途径 ...

  3. 深入理解JavaWeb技术内幕(一)

    最近在看许令波的<深入理解JavaWeb技术内幕>.整理了一些笔记.想做一个系列,这篇是系列的第一篇,讲Web请求. B/S架构 最常见的架构方式. 优点: 1.客户端使用统一(此处的统一 ...

  4. 理解及操作环境变量(基于Mac操作)

    通过本文,简单的了解下环境变量及其操作,与便于遇到相关问题时能够准确快捷的解决. 什么是环境变量 An environment variable is a dynamic-named value th ...

  5. 全方位理解Android权限之底层实现概览

    0000 这个阶段搞了很多和Android文件权限相关的问题,虽然一知半解,但也算是对Android权限机制有一些自己的理解.遂将这些内容整理出来.因为权限这部分涉及到的内容很多,故将知识分为几块内容 ...

  6. 第4 章 : 理解 Pod 和容器设计模式

    理解Pod和容器设计模式 本文整理自 CNCF 和阿里巴巴联合举办的云原生技术公开课的课时 4:理解 Pod 和容器设计模式.本次课程中,阿阿里巴巴高级技术专家.CNCF 官方大使张磊为大家介绍了为什 ...

  7. 一篇RPO漏洞挖掘文章翻译加深理解。

    这是我第一次尝试翻译一篇漏洞挖掘文章,翻译它也是为了加深理解它.这是一篇很有意思的漏洞挖掘文章. 前几天在看fd的博客,偶然看到了这篇文章,虽然有点老了.但是思路真的牛皮.我决定花费时间和精力研究它们 ...

  8. 关于define('DISCUZ_ROOT', substr(dirname(__FILE__), 0, -7));的理解

    关于define('DISCUZ_ROOT', substr(dirname(__FILE__), 0, -7));的理解 define('DISCUZ_ROOT',  substr(dirname( ...

  9. 深入理解java:2.1. volatile的使用及其原理

    引言 在多线程并发编程中synchronized和Volatile都扮演着重要的角色,Volatile是轻量级的synchronized,它在多处理器开发中保证了共享变量的“可见性”. 可见性的意思是 ...

随机推荐

  1. python 打包与部署

    环境:win10.eclipse-jee-mars.python2.7 打包在linux上进行安装测试 1.1 打包 项目目录结构如下: 打包对象:utils.reg 在P1项目的顶级目录,也就是ut ...

  2. HTTP请求过程详解

    以请求新浪的首页为例,总结HTTP请求的流程: 步骤1:浏览器首先向服务器发送HTTP请求,请求包括: 方法:GET还是POST,GET仅请求资源,POST会附带用户数据: 路径:/full/url/ ...

  3. XML到底是什么

    http://www.w3school.com.cn/xml/xml_intro.asp w3school介绍 XML  XML 被设计用来传输和存储数据. HTML 被设计用来显示数据. 应该掌握的 ...

  4. js setTimeout 与 setInterval 以及 for 循环 刷新UI

    1. setTimeout() 方法用于在指定的毫秒数后调用函数或计算表达式:执行一次: 如果需要执行多次,自身再次调用 setTimeout(): 示例:无穷循环并带停止按钮的 <html&g ...

  5. Unity 5 中的全局光照技术详解(建议收藏)

    本文整理自Unity全球官方网站,原文:UNITY 5 - LIGHTING AND RENDERING (文章较长,请耐心阅读)简介全局光照,简称GI,是一个用来模拟光的互动和反弹等复杂行为的算法, ...

  6. 编译maxscale

    编译maxscale,需要依赖mariadb版本的MySQL.有自己的版本就是任性啊

  7. 设置DIV最小高度以及高度自适应随着内容的变化而变化

    <!--退租账单--> <div id="bilsli" onmouseover="showBill(this)"> #bilsli{ ...

  8. css3内容持续更新ing

    要做在手机里面.4s和5都有差别更加何况还有其他安卓手机,所以做好之后要缩小一点 用的是background.用的了background-size,如果是50%就是等比缩放,50% 50%就会变形,现 ...

  9. Android 反编译工具简介

    Android 反编译工具: 所需工具:1 apktool : 用于获取资源文件 2 dex2Jar : 用于将classes.dex转化成jar文件 2 jd-gui: 将jar文件转化成java文 ...

  10. 注解配置springMvc及向作用域中赋值

    1.在applicationContext.xml中配置包扫描器 <!-- 使用注解配置扫描器 --> <context:component-scan base-package=&q ...