WSRF研究--WS-ResourceLifetime协议

WS-ResourceLifetime协议

WS-ResourceLifetime协议定义了WS-Resource的资源销毁机制，其中包括资源的立即销毁和资源的调度销毁。立即销毁使得客户可以显示地要求对特定的WS-Resource进行销毁，从而释放该WS-Resource占用的系统资源。调度销毁则允许客户通过设定某个WS-Resource的预定销毁时间(Termination Time)，由引擎负责在其生命周期结束时对其进行销毁。在每一种情况都要明白，只有 WS-Resource — 有状态资源和 Web 服务的关联—被销毁。资源本身和 Web 服务都没有受到影响。

另外值得注意的是此协议并没有定义WS-Resource的创建方式。

1.1.1.1 创建WS-Resource

我们可以发送“create”消息：

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

<SOAP-ENV:Header/>

<SOAP-ENV:Body>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

结果是一个 SOAP 消息，其中包含对操作创建的 WS-Resource 的端点引用：

<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>

该端点引用惟一地识别正在谈论的 WS-Resource，所以我们可以使用它来销毁该 WS-Resource。

1.1.1.2 立即销毁WS-Resource

当我们准备销毁 WS-Resource 时，可以使用它的端点引用来创建 SOAP 请求：

<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:wsrl="http://docs.oasis-open.org/wsrf/2004/06/wsrf-WS-ResourceLifetime-1.2-draft-01.xsd">

<SOAP-ENV:Header>

<wsa:Action>

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

</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>

<wsrl:Destroy />

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

假设一切正常，我们会收到确认消息：

<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:wsrl="http://docs.oasis-open.org/wsrf/2004/06/wsrf-WS-ResourceLifetime-1.2-draft-01.xsd">

<SOAP-ENV:Header>

<wsa:Action>

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

</wsa:Action>

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

http://example.com/myClient

</wsa:To>

</SOAP-ENV:Header>

<SOAP-ENV:Body>

<wsrl:DestroyResponse />

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

这似乎不怎么像确认消息，但是只要收到它，就可以知道一切正常。如果不是一切正常，就会得到 WSRF 故障：WS-ResourceLifetime 中所讨论的一条 fault 消息。如果在 WS-Resource 销毁后还试图访问它，也会得到故障消息。

我们也可以安排 WS-Resource 在以后销毁。

1.1.1.3 调度销毁WS-Resource

我们并不总是想要当场销毁 WS-Resource。在有些情况下，我们只是想要保持 WS-Resource 活跃一段特定的时间，然后再让它销毁。为了做到这一点，我们需要给 WS-Resource 附加一个 TerminationTime 属性，这意味着将它添加到资源属性文档。对于我们的人造卫星，意味着类似下面的这些东西：

<satProp:GenericSatelliteProperties

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

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

xmlns:wsrl="http://docs.oasis-open.org/wsrf/2004/06/wsrf-WS-ResourceLifetime-1.2-draft-01.xsd">

<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>

<wsrl:TerminationTime>

2005-12-31T12:00:00

</wsrl:TerminationTime>

<wsrl:CurrentTime>2005-2-15T03:24:57</CurrentTime>

</satProp:GenericSatelliteProperties>

如果像本例中一样，没有指定时区，就会假设是格林威治标准时间。

注意，除了 TerminationTime，我们还添加了 CurrentTime。该属性使我们不必同步时钟，下面您就会看到。

获得 CurrentTime 和 TerminationTime

由于不同系统上的客户机，因而潜在地存在时钟同步的严重问题。例如，假设我们想要指定刚才创建的人造卫星 WS-Resource 应该在 4 小时后终止。选择一个相对于客户机的时间将会成为问题，因为在预定销毁情况下，实际上是由服务器销毁引用的。

幸运的是，WS-Resource 带有自己的“当前时间”。因为它是资源属性文档的一部分，所以我们可以像请求任何其他属性一样请求它：

<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"

xmlns:wsrl="http://docs.oasis-open.org/wsrf/2004/06/wsrf-WS-ResourceLifetime-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>

<wsrp:ResourceProperty>wsrl:CurrentTime</wsrp:ResourceProperty>

<wsrp:ResourceProperty>wsrl:TerminationTime</wsrp:ResourceProperty>

</wsrp:GetMultipleResourceProperties>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

在本例中，我们请求了 CurrentTime 和 TerminationTime，所以响应中包含了它们俩：

<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"

xmlns:wsrl="http://docs.oasis-open.org/wsrf/2004/06/wsrf-WS-ResourceLifetime-1.2-draft-01.xsd">

<SOAP-ENV:Header>

<wsa:Action> http://docs.oasis-open.org/wsrf/2004/06/WS-Resour

ceProperties/GetMutlipleResourcePropertiesResponse

</wsa:Action>

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

http://example.com/myClient

</wsa:To>

</SOAP-ENV:Header>

<SOAP-ENV:Body>

<wsrp:GetMultipleResourcePropertiesResponse>

<wsrl:CurrentTime>2005-2-15T03:24:57</wsrl:CurrentTime>

<wsrl:TerminationTime>2005-2-15T03:30:00</wsrl:TerminationTime>

</wsrp:GetMultipleResourcePropertiesResponse>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

在应用程序中，然后我们可以使用 CurrentTime 来确定和设置新的 TerminationTime。

注意，尽管我们可以像请求任何其他资源属性一样请求 CurrentTime 和 TerminationTime，但是不能像设置任何其他资源属性一样设置它们。CurrentTime 是只读的，而 TerminationTime 必须使用我们下面将会看到的消息来设置。

设置新的 TerminationTime

一旦为 TerminationTime 确定了适当的值，我们就可以发送 SetTerminationTime 消息了：

<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"

xmlns:wsrl="http://docs.oasis-open.org/wsrf/2004/06/wsrf-WS-ResourceLifetime-1.2-draft-01.xsd">

<SOAP-ENV:Header>

<wsa:Action>

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

</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>

<wsrl:SetTerminationTime>

<wsrl:RequestedTerminationTime>

2005-2-15T07:24:00

</wsrl:RequestedTerminationTime>

</wsrl:SetTerminationTime>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

注意，我们不是通过直接操纵 TerminationTime 属性来设置时间的。这是因为我们需要系统实施它自己的任何一个时间相关规则，比如，不缩短资源的生存期，或者不扩展它超过某个特定的点。

响应消息包含新的 TerminationTime 和 CurrentTime：

<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"

xmlns:wsrl="http://docs.oasis-open.org/wsrf/2004/06/wsrf-WS-ResourceLifetime-1.2-draft-01.xsd">

<SOAP-ENV:Header>

<wsa:Action>

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

</wsa:Action>

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

http://example.com/myClient

</wsa:To>

</SOAP-ENV:Header>

<SOAP-ENV:Body>

<wsrl:SetTerminationTimeResponse>

<wsrl:NewTerminationTime>2005-2-15T07:24:00</wsrl:NewTerminationTime>

<wsrl:CurrentTime>2005-2-15T03:25:08</wsrl:CurrentTime>

</wsrl:SetTerminationTimeResponse>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

除非应用程序本身具有设置时间的特定规则，否则没有任何特殊的约束。您甚至可以将 TerminationTime 设置为过去的值，这与发送 Destroy 消息的效果是一样的。

Author: orangelizq
email: orangelizq@163.com

欢迎大家访问我的个人网站萌萌的IT人

posted on 2009-07-19 15:45 桔子汁阅读(320) 评论(0) 编辑收藏所属分类: Web Service

1.1.1.1 创建WS-Resource

1.1.1.2 立即销毁WS-Resource

1.1.1.3 调度销毁WS-Resource

常用链接

留言簿(9)

随笔分类(124)

随笔档案(127)

文章分类(5)

文章档案(5)

Good Blog

技术网站

搜索

积分与排名

最新评论

阅读排行榜


只有注册用户登录后才能发表评论。




网站导航: 博客园 IT新闻知识库 C++博客博问管理
相关文章: [转]XML解析技术研究--冯进-国防科技大学 WSRF研究--WS-N协议族 WSRF研究--WS-ServiceGroup协议 WSRF研究--WS-BaseFault协议 WSRF研究--WS-ResourceLifetime协议 WSRF研究--WS-ResourceProperties协议 WSRF研究-WS-Resource协议 WSRF研究-WSRF历史 XML解析技术研究(二) XML解析技术研究(一)