+

Search Tips   |   Advanced Search

Web Services Resource Framework support


The Web Services Resource Framework (WSRF) support in WAS provides the environment for Web service applications that follow the OASIS WSRF specifications.

 

WSRF overview

Web service interfaces often need to provide stateful interactions with the clients of the service. For example, a Web service interface such as a shopping cart, where the result of one operation influences the carrying out of the succeeding operations. The OASIS Web Services Resource Framework (WSRF) defines a generic framework for modelling stateful resources using Web services, so that the definition and implementation of a service and the integration and management of multiple services is easier.

WSRF introduces the concept of an XML document description, called the resource properties document schema, which is referenced by the WSDL description of a Web service and which explicitly describes a view of the state of the resource with which the client interacts. A service described in this way is called a WS-Resource. A WS-Resource is defined as the combination of a resource and a Web service through which the resource is accessed.

The following figure illustrates a Web service, at http://www.example.com/service, and three resources, A, B, and C, which are accessed through the Web service. Three WS-Resources are therefore illustrated in the figure:

A WS-Resource is referenced by a WS-Addressing endpoint reference that uniquely identifies the WS-Resource, typically by containing an identifier of the resource component of the WS-Resource inside the EndpointReference ReferenceParameter element. In the previous example, WS-Resource-C is the combination of the Web service and the resource that is identified by C, and a reference to WS-Resource-C might be as follows:

<wsa:EndpointReference>
    <wsa:Address>
        http://www.example.com/service
    </wsa:Address>
    <wsa:ReferenceParameters>
        <tns:SomeDisambiguatorElement>C</tns:SomeDisambiguatorElement>
    </wsa:ReferenceParameters>
    ...
</wsa:EndpointReference>

Each such WS-Resource has a resource property document (an XML instance document) that describes a view of the state of the resource. The WSDL for a WS-Resource identifies the XML schema that describes the type of the resource property document through a ResourceProperties attribute of the wsdl:PortType element. By specifying this standard WSDL extension for the resource properties document schema, WSRF enables the definition of simple, generic messages that interact with the WS-Resource. For example, consider a Printer WS-Resource that has the following resource properties document schema:

<?xml version="1.0"?>
<xsd:schema ...
   
    xmlns:pr="http://example.org/printer.xsd" 
   targetNamespace="http://example.org/printer.xsd" >
 <xsd:element name="printer_properties">
   <xsd:complexType>
     <xsd:sequence>
        <xsd:element ref="pr:printer_name" />
        <xsd:element ref="pr:queued_job_count" />
     </xsd:sequence>
   </xsd:complexType>
 </xsd:element>
 ...
</schema>

The WSDL PortType element for such a WS-Resource declares the Resource Properties Document type as follows:

<wsdl:portType 
    xmlns:pr="http://example.org/printer.xsd"  
               
    xmlns:wsrf-rp="http://docs.oasis-open.org/wsrf/rp-2"
               name="Printer" wsrf-rp:ResourceProperties="pr:printer_properties">

Each WS-Resource has a unique, logical resource properties document instance that is a view of the state of the resource. The WS-ResourceProperties specification describes the interoperable protocol messages that a WS-Resource can implement to get, set, or query the state of the resource by operating on the resource properties document. Some of these operations affect the resource properties document as a whole, and some of them operate on one or more elements within the document (the individual resource properties, for example pr:printer_name). Each WS-Resource can have a finite lifecycle and can be created and destroyed; the WS-ResourceLifetime spec describes the interoperable protocol messages that a WS-Resource can implement to destroy itself or to alter its termination time.

See about WSRF, refer to the WSRF Primer document published by the OASIS Technical Committee.

 

WSRF Programming Model

The WSRF specifications define only the protocol messages and the semantic behavior that is expected of a WS-Resource when it processes these messages; the specifications do not prescribe the means to implement WS-Resource objects. WSRF is primarily an application-level protocol and the tools for implementing WS-Resources are the same tools that are used for implementing any other type of Web service. WSRF uses WS-Addressing endpoint references and the model for WS-Resources is similar to the model for any Web service that uses WS-Addressing; this model is described in Web Services Addressing application model. WSRF extends the WAS WS-Addressing model in two ways, which differentiate a WS-Resource from a generic resource that is accessed through a Web service using WS-Addressing:





Subtopics


Web Services Resource Framework base faults

 

Related concepts


Web Services Addressing support

 

Related tasks


Create stateful Web services using the Web Services Resource Framework

 

Related information


WSRF specification OASIS WSRF primer