Propriedade de Recurso e Operações Contínuas da Web Services Resource Framework (WSRF)

O WSRF (Web Services Resource Framework) contém especificações que descrevem as operações um WS-Resource (Web Services Resource) pode implementar para obter, configurar ou consultar o estado do recurso, operando no documento de propriedades de recursos.

Para obter uma descrição completa de todas as operações padrão de propriedades e tempo de vida definidas pelo WSRF (Web Services Resource Framework), consulte as especificações WS-ResourceProperties e WS-ResourceLifetime. As operações WSRF de origem que um WS-Resource (Web Services Resource) pode suportar estão descritas na tabela a seguir.

Tabela 1. Operações WSRF de Origem Suportadas pelos WS-Resources. A tabela lista as operações do WSRF de princípio e fornece uma descrição de cada uma delas, incluindo o formato de mensagem e de resposta.
Operação Description
GetResourcePropertyDocument Retorna todo o documento de propriedades de recursos do WS-Resource.
Formato da Mensagem
<wsrf-rp:GetResourcePropertyDocument/>
Formato da Resposta
<wsrf-rp:GetResourcePropertyDocumentResponse>
  {any} 
</wsrf-rp:GetResourcePropertyDocumentResponse>
em que {any} é o conteúdo do documento de propriedade de recurso.
PutResourcePropertyDocument Substitua todo o documento de propriedade de recurso para o WS-Resource com o documento especificado.
Formato da Mensagem
<wsrf-rp:PutResourcePropertyDocument>
  {any}
</wsrf-rp:PutResourcePropertyDocument>
onde {any} é o conteúdo do documento de propriedade de novo recurso.
Formato da Resposta
<wsrf-rp:PutResourcePropertyDocumentResponse>
  {any} ?
</wsrf-rp:PutResourcePropertyDocumentResponse>
onde {any} é o conteúdo do documento de propriedade de novo recurso. Se o conteúdo for idêntico ao conteúdo solicitado, o elemento {any} não deve estar presente.
GetResourceProperty Retorna o valor ou valores da propriedade de recurso especificada localizada dentro do documento de propriedade de recurso do WS-Resource.
Formato da Mensagem
<wsrf-rp:GetResourceProperty>
  QName
</wsrf-rp:GetResourceProperty>
Formato da Resposta
<wsrf-rp:GetResourcePropertyResponse>
  {any}*
</wsrf-rp:GetResourcePropertyResponse>
onde {any}* é uma seqüência de elementos que corresponde ao QName especificado no pedido.
GetMultipleResourceProperties Retorna o valor ou valores das propriedades de recursos especificadas localizados no documento de propriedades de recursos do WS-Resource.
Formato da Mensagem
<wsrf-rp:GetMultipleResourceProperties>
  <wsrf-rp:ResourceProperty>QName<wsrf-rp:ResourceProperty>+
</wsrf-rp:GetMultipleResourceProperties>
Formato da Resposta
<wsrf-rp:GetMultipleResourcePropertiesResponse>
  {any}*
</wsrf-rp:GetMultipleResourcePropertiesResponse>
onde {any}* é uma seqüência de elementos que corresponde ao QNames especificado no pedido.
InsertResourceProperties Insira os elementos das propriedades de recursos especificados para o documento de propriedades de recursos do WS-Resource.
Formato da Mensagem
<wsrf-rp:InsertResourceProperties>
  <wsrf-rp:Insert>
    {any}*
  </wsrf-rp:Insert> 
</wsrf-rp:InsertResourceProperties>
onde {any}* é uma seqüência de elementos com o mesmo QName.
Formato da Resposta
<wsrf-rp:InsertResourcePropertiesResponse/>
UpdateResourceProperties Atualiza os elementos das propriedades de recursos especificados no documento de propriedades de recursos do WS-Resource.
Formato da Mensagem
<wsrf-rp:UpateResourceProperties>
  <wsrf-rp:Upate>
    {any}*
  </wsrf-rp:Upate> 
</wsrf-rp:UpateResourceProperties>
onde {any}* é uma seqüência de elementos com o mesmo QName.
Formato da Resposta
<wsrf-rp:UpateResourcePropertiesResponse/>
DeleteResourceProperties Exclui os elementos das propriedades de recursos especificados a partir do documento de propriedades de recursos do WS-Resource.
Formato da Mensagem
<wsrf-rp:DeleteResourceProperties>
  <wsrf-rp:Delete ResourceProperty="QName"/>
</wsrf-rp:DeleteResourceProperties>
em que QName é o QName da propriedade de recurso a ser excluída.
Formato da Resposta
<wsrf-rp:DeleteResourcePropertiesResponse/>
QueryResourceProperties Consulta o documento de propriedades do recurso usando uma expressão de consulta, como XPath.
Formato da Mensagem
<wsrf-rp:QueryResourceProperties>
  <wsrf-rp:QueryExpression 
           Dialect="http://www.w3.org/TR/1999/REC-xpath-19991116">
    xsd:any
  </wsrf-rp:QueryExpression>
</wsrf-rp:QueryResourceProperties>
onde xsd:any é a expressão de consulta XPath a ser aplicada ao documento de propriedade de recurso.
Formato da Resposta
<wsrf-rp:QueryResourcePropertiesResponse>
  {any}
</wsrf-rp:QueryResourcePropertiesResponse>
onde {any} é o resultado de análise da expressão de consulta em relação ao documento de propriedades de recursos.
Destruir Destrói o WS-Resource.
Formato da Mensagem
<wsrf-rl:Destroy/>
Formato da Resposta
<wsrf-rl:DestroyResponse/>
Essa resposta indica a destruição bem-sucedida do WS-Resource.
SetTerminationTime Os WS-Resources que suportam a finalização planejada pode implementar essa operação para permitir que um solicitante altere o tempo no qual o WS-Resource destrói a si mesmo.
Formato da Mensagem
<wsrf-rl:SetTerminationTime>
  [<wsrf-rl:RequestedTerminationTime>
    xsd:dateTime 
  </wsrf-rl:RequestedTerminationTime>] 
    | 
  [<wsrf-rl:RequestedLifetimeDuration> 
    xsd:duration
  </wsrf-rl:RequestedLifetimeDuration>]
</wsrf-rl:SetTerminationTime>
onde o tempo de finalização é uma tempo absoluto ou uma duração relativa.
Formato da Resposta
<wsrf-rl:SetTerminationTimeResponse>
  <wsrf-rl:NewTerminationTime>
    xsd:dateTime 
  </wsrf-rl:NewTerminationTime>
  <wsrf-rl:CurrentTime>
    xsd:dateTime 
  </wsrf-rl:CurrentTime>
<wsrf-rl:SetTerminationTimeResponse>
Essa resposta contém o tempo, da perspectiva do WS-Resource, em que o WS-Resource destrói a si mesmo. A resposta também contém o valor de tempo atual do WS-Resource.

Há uma variedade de modos nos quais um WS-Resource pode implementar a destruição planejada. Por exemplo, um WS-Resource implementado como um enterprise bean pode utilizar o serviço de cronômetro do contêiner do enterprise bean, implementando o método de retorno de chamada ejbTimeout da interface javax.ejb.TimedObject, e criando um objeto Timer que expira no tempo de destruição planejado e induz esse método de retorno de chamada. Os objetos Timer do serviço de cronômetro EJB ficam retidos após o reinício do servidor e, portanto, são um meio simples de gerenciar o ciclo de vida de WS-Resources que possuem um ciclo de vida finito e requerem um mecanismo de destruição baseado em tempo.


Ícone que indica o tipo de tópico Tópico de Conceito



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=cwbs_wsrf_ops
Nome do arquivo: cwbs_wsrf_ops.html