Propriété de ressource WSRF et opérations de cycle de vie

WSRF (Web Services Resource Framework) contient des spécifications qui décrivent les opérations qu'une ressource de services Web (ressource WS) peut implémenter afin d'obtenir, de définir ou d'interroger l'état de la ressource en agissant sur le document de propriétés de ressource.

Pour obtenir une description complète de toutes les opérations de propriétés standard et de durée de vie qui sont définies par la Web Services Resource Framework (WSRF), reportez-vous aux spécifications WS-ResourceProperties et WS-ResourceLifetime. Les principales opérations WSR prises en charge par une ressource de services Web (WS-Resource) sont décrites dans le tableau suivant.

Tableau 1. Principales opérations prises en charge par WS-Resources. Le tableau répertorie les opérations WSRF de principal accompagnées de leur description et de leur format de message et de réponse.
Opération Description
GetResourcePropertyDocument Renvoie l'ensemble du document de propriétés de ressource de la ressource WS.
Format de message
<wsrf-rp:GetResourcePropertyDocument/>
Format de réponse
<wsrf-rp:GetResourcePropertyDocumentResponse>
  {any} 
</wsrf-rp:GetResourcePropertyDocumentResponse>
{tout} est le contenu du document de propriétés de ressource.
PutResourcePropertyDocument Remplace l'ensemble du document de propriétés de la ressource WS par le document spécifié.
Format de message
<wsrf-rp:PutResourcePropertyDocument>
  {any}
</wsrf-rp:PutResourcePropertyDocument>
{any} est le contenu du nouveau document de propriétés de ressource.
Format de réponse
<wsrf-rp:PutResourcePropertyDocumentResponse>
  {any} ?
</wsrf-rp:PutResourcePropertyDocumentResponse>
{any} est le contenu du nouveau document de propriétés de ressource. Si le contenu est identique au contenu demandé, l'élément {expression} ne doit pas être présent.
GetResourceProperty Renvoie la ou les valeurs de la propriété de ressource spécifiée trouvée dans le document de propriétés de la ressource WS.
Format de message
<wsrf-rp:GetResourceProperty>
  QName
</wsrf-rp:GetResourceProperty>
Format de réponse
<wsrf-rp:GetResourcePropertyResponse>
  {any}*
</wsrf-rp:GetResourcePropertyResponse>
{expression}* est une séquence d'éléments qui correspond au QName spécifié dans la demande.
GetMultipleResourceProperties Renvoie la ou les valeurs des propriétés de ressource spécifiées trouvées dans le document de propriétés de la ressource WS.
Format de message
<wsrf-rp:GetMultipleResourceProperties>
  <wsrf-rp:ResourceProperty>QName<wsrf-rp:ResourceProperty>+
</wsrf-rp:GetMultipleResourceProperties>
Format de réponse
<wsrf-rp:GetMultipleResourcePropertiesResponse>
  {any}*
</wsrf-rp:GetMultipleResourcePropertiesResponse>
{expression}* est une séquence d'éléments qui correspond aux QNames spécifiés dans la demande.
InsertResourceProperties Insère les éléments de propriétés de ressource spécifiés dans le document de propriétés de ressource de la ressource WS.
Format de message
<wsrf-rp:InsertResourceProperties>
  <wsrf-rp:Insert>
    {any}*
  </wsrf-rp:Insert> 
</wsrf-rp:InsertResourceProperties>
{expression}* est une séquence d'éléments partageant le même QName.
Format de réponse
<wsrf-rp:InsertResourcePropertiesResponse/>
UpdateResourceProperties Met à jour les éléments de propriété de ressource spécifiés dans le document de propriétés de la ressource WS.
Format de message
<wsrf-rp:UpateResourceProperties>
  <wsrf-rp:Upate>
    {any}*
  </wsrf-rp:Upate> 
</wsrf-rp:UpateResourceProperties>
{expression}* est une séquence d'éléments partageant le même QName.
Format de réponse
<wsrf-rp:UpateResourcePropertiesResponse/>
DeleteResourceProperties Supprime les éléments de propriété de ressource spécifiés du document de propriétés de la ressource WS.
Format de message
<wsrf-rp:DeleteResourceProperties>
  <wsrf-rp:Delete ResourceProperty="QName"/>
</wsrf-rp:DeleteResourceProperties>
QName est le QName de la propriété de ressource à supprimer.
Format de réponse
<wsrf-rp:DeleteResourcePropertiesResponse/>
QueryResourceProperties Interroge le document de propriétés de la ressource à l'aide d'une expression de requête telle que XPath.
Format de message
<wsrf-rp:QueryResourceProperties>
  <wsrf-rp:QueryExpression 
           Dialect="http://www.w3.org/TR/1999/REC-xpath-19991116">
    xsd:any
  </wsrf-rp:QueryExpression>
</wsrf-rp:QueryResourceProperties>
xsd:any est l'expression de requête XPath à appliquer au document de propriétés de ressource.
Format de réponse
<wsrf-rp:QueryResourcePropertiesResponse>
  {any}
</wsrf-rp:QueryResourcePropertiesResponse>
{expression} est le résultat de l'évaluation de l'expression de requête sur la base du document de propriétés de ressource.
Destroy Détruit la ressource WS.
Format de message
<wsrf-rl:Destroy/>
Format de réponse
<wsrf-rl:DestroyResponse/>
Cette réponse indique que la ressource WS a bien été supprimée.
SetTerminationTime Les ressources WS qui prennent en charge l'arrêt planifié peuvent implémenter cette opération de sorte à permettre à un demandeur de modifier l'heure à laquelle elles doivent s'autodétruire.
Format de message
<wsrf-rl:SetTerminationTime>
  [<wsrf-rl:RequestedTerminationTime>
    xsd:dateTime 
  </wsrf-rl:RequestedTerminationTime>] 
    | 
  [<wsrf-rl:RequestedLifetimeDuration> 
    xsd:duration
  </wsrf-rl:RequestedLifetimeDuration>]
</wsrf-rl:SetTerminationTime>
où l'heure de fin est une heure précise ou une durée relative.
Format de réponse
<wsrf-rl:SetTerminationTimeResponse>
  <wsrf-rl:NewTerminationTime>
    xsd:dateTime 
  </wsrf-rl:NewTerminationTime>
  <wsrf-rl:CurrentTime>
    xsd:dateTime 
  </wsrf-rl:CurrentTime>
<wsrf-rl:SetTerminationTimeResponse>
Cette réponse contient l'heure (basée sur la WS-Resource) à laquelle la WS-Resource se détruit elle-même. Elle contient également la valeur de l'heure actuelle de la ressource.

Une WS-Resource peut procéder à des suppressions planifiées de diverses façons. Par exemple, une WS-Resource implémentée en tant que bean enterprise peut utiliser le service de minutage du conteneur bean enterprise en mettant en oeuvre la méthode de rappel ejbTimeout de l'interface javax.ejb.TimedObject, et en créant un objet Timer qui expire à l'heure de suppression planifiée et exécute la méthode de rappel. Les objets Timer du service de temporisateur EJB sont conservés après le redémarrage du serveur. Dès lors, ils ne sont qu'un simple moyen de gérer le cycle de vie limité des ressources WS et requièrent un mécanisme de destruction temporel.


Icône indiquant le type de rubrique Rubrique de concept



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=cwbs_wsrf_ops
Nom du fichier : cwbs_wsrf_ops.html