Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Insert: wherein a new resource property element is inserted into the resource properties document; before of that the property was null and therefore wasn't part of the resource property document;
  • Update: wherein existing resource property element(s) are udpated; that is, the property was already part of the resource property document;
    Note

    In order to be fully WSRF compliant, there should be a third type of change : Delete. It will be implemented sooner but keep in mind that at the moment is not supported.

Request

Code Block
xml
xml
01.	<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
02.		<soap:Header>
03.			<wsa:To xmlns:wsa="http://www.w3.org/2005/08/addressing">
04.				http://localhost:8080/qman/services/QManWsResource
05.			</wsa:To>
06.     	        <wsa:Action xmlns:wsa="http://www.w3.org/2005/08/addressing">
07.				http://docs.oasis-open.org/wsrf/rpw-2/SetResourceProperties/SetResourcePropertiesRequest
08.			</wsa:Action>
09.     	        <wsa:MessageID xmlns:wsa="http://www.w3.org/2005/08/addressing">
10.				uuid:0cdb5112-09e0-ac39-06ba-393843f06e42
11.			</wsa:MessageID>
12.			<wsa:From xmlns:wsa="http://www.w3.org/2005/08/addressing">
13.     		        <wsa:Address>
14.					http://www.w3.org/2005/08/addressing/role/anonymous
15.				</wsa:Address>
16.			</wsa:From>
17.			<qman:ResourceId
				xmlns:wsa="http://www.w3.org/2005/08/addressing"
				wsa:IsReferenceParameter="true"
				xmlns:qman="http://amqp.apache.org/qpid/management/qman">
18.				781f4ad7-4c96-4caa-b69d-291461cdb1fc
19.			</qman:ResourceId>
		</soap:Header>
		<soap:Body xmlns:qman="http://amqp.apache.org/qpid/management/qman">
21.			<wsrf-rp:SetResourceProperties xmlns:wsrf-rp="http://docs.oasis-open.org/wsrf/rp-2">
22.				<wsrf-rp:Insert>
					<qman:Type>
						This is a value for a string property.
					</qman:Type>
23.				</wsrf-rp:Insert>
24.				<wsrf-rp:Update>
					<qman:MgmtPubInterval>
						12
					</qman:MgmtPubInterval>
25.				</wsrf-rp:Update>
			</wsrf-rp:SetResourceProperties>
		</soap:Body>
	</soap:Envelope>

...

Line(s)

Description

01 - 03

Convey the recipient of the response message. Note that this time we are talking about the service requestor; The address matches the <wsa:From> previously found in the corresponding request.

04 - 06

Indicate this is a SetResourceProperties response. This is done as usual using a wsa:Action that is part of WS-Addressing specification.

07 - 09

Convey a unique identifier associated with the current response message.

10 - 12

This element provides the identifier of the correlated (request) message.

13

The <wsa:From> element (part of WS-Addressing specs too) identifies the source endpoint, the originator of this response message.

14 - 16

This is the address of the source service endpoint. As said for lines 01-03 this time this is referred to service provider (the message originator).

17 - 20

As part of wsa:From element, this contains (specifically on line 18) additional information needed for identifying the originator of this message.

21 - 25

This is the SetResourceProperties response element.

Faults

  • ResourceUnknownFault : There's no resource on QMan associated with the given reference information (soap address and identifier).
  • ResourceUnavailableFault : The requested resource is unavailable. This fault should indicate a transient condition. That means a requester might resend the message.
  • InvalidResourcePropertyQNameFault : The name (QName) in the request message doesn't correspond to a property element of the target WS-Resource.
  • SetResourcePropertyRequestFailedFault : Service provider was unable to satisfy the SetResourceProperties request.
  • InvalidModificationFault : The content of the SetResourceProperties request cause the resource properties document to no longer be able to validate.
  • UnableToModifyResourcePropertyFault : One or more properties contained in the SetResourceProperties request are read-only.

...