GetResourceMembers
Description
This interface allows a requestor to retrieve the catalogue of all managed resources.
Note that there's no a "GetResourceMembers" request on WSRF specification. That request is actually a GetResourceProperty for wsrf-sg:Entry adapter property.
For each managed resource a dedicated entry will be returned on the corresponding response.
Request
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/adapter 05. </wsa:To> 06. <wsa:Action xmlns:wsa="http://www.w3.org/2005/08/addressing"> 07. http://docs.oasis-open.org/wsrf/rpw-2/GetResourceProperty/GetResourcePropertyRequest 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> </soap:Header> <soap:Body> 17. <wsrf-rp:GetResourceProperty xmlns:wsrf-rp="http://docs.oasis-open.org/wsrf/rp-2" xmlns:wsrf-sg="http://docs.oasis-open.org/wsrf/sg-2"> 18. wsrf-sg:Entry 19. </wsrf-rp:GetResourceProperty> </soap:Body> </soap:Envelope>
Line(s) |
Description |
---|---|
01 |
The SOAP <Envelope> is the root element in every SOAP message, and contains two child elements, <Header> and <Body>. |
02 |
The SOAP Header will contain all metadata used for identifying the conversation participants (requestor and provider). |
03 - 05 |
Convey the target endpoint also known (in the request phase) as service provider. |
06 - 08 |
Indicate this is a GetResourceProperty request. In fact, the GetResourceMember is a GetResourceProperty request where a requestor ask to the adapter resource the value of wsrf-sg:Entry property value. |
09 - 11 |
Convey a unique identifier associated with the current message. This will be used for request / response messages correlation. |
12 - 15 |
Provide the address of the source endpoint also known (in the request phase) as service requestor. |
17 - 19 |
The GetResourceProperty request. Subsequent child specifies requested property name. |
18 |
This adapeter property is basically the list of all managed resources that are currently under QMan management domain. |
Response
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope"> <soap:Header> 01. <wsa:To xmlns:wsa="http://www.w3.org/2005/08/addressing"> 02. http://www.w3.org/2005/08/addressing/role/anonymous 03. </wsa:To> 04. <wsa:Action xmlns:wsa="http://www.w3.org/2005/08/addressing"> 05. http://docs.oasis-open.org/wsrf/rpw-2/GetResourceProperty/GetResourcePropertyResponse 06. </wsa:Action> 07. <wsa:MessageID xmlns:wsa="http://www.w3.org/2005/08/addressing"> 08. uuid:980617c8-e3a0-ebf1-8f5a-2b43d3d6d416 09. </wsa:MessageID> 10. <wsa:RelatesTo RelationshipType="wsa:Reply" xmlns:wsa="http://www.w3.org/2005/08/addressing"> 11. uuid:0cdb5112-09e0-ac39-06ba-393843f06e42 12. </wsa:RelatesTo> 13. <wsa:From xmlns:wsa="http://www.w3.org/2005/08/addressing"> 14. <wsa:Address> 15. http://localhost:8080/qman/services/adapter 16. </wsa:Address> </wsa:From> </soap:Header> <soap:Body> 17. <wsrf-sg:Entry xmlns:wsrf-sg="http://docs.oasis-open.org/wsrf/sg-2"> 18. <wsrf-sg:ServiceGroupEntryEPR> 19. <wsa:Address xmlns:wsa="http://www.w3.org/2005/08/addressing"> 20. http://localhost:8080/qman/services/ServiceGroupEntry </wsa:Address> <wsa:ReferenceParameters xmlns:wsa="http://www.w3.org/2005/08/addressing"> <qman:ResourceId xmlns:qman="http://amqp.apache.org/qpid/management/qman"> 21. 1d01b4ee-7d23-3a30-342e-62fc49984fe6 </qman:ResourceId> 22. </wsa:ReferenceParameters> 23. </wsrf-sg:ServiceGroupEntryEPR> 24. <wsrf-sg:MemberServiceEPR> <wsa:Address xmlns:wsa="http://www.w3.org/2005/08/addressing"> 25. http://localhost:8080/qman/services/QManWsResource </wsa:Address> <wsa:ReferenceParameters xmlns:wsa="http://www.w3.org/2005/08/addressing"> 26. <qman:ResourceId xmlns:qman="http://amqp.apache.org/qpid/management/qman"> a3759467-bede-476d-8dde-169f1a652191 27. </qman:ResourceId> </wsa:ReferenceParameters> 28. </wsrf-sg:MemberServiceEPR> 29. <wsrf-sg:Content/> </wsrf-sg:Entry> 33. <wsrf-sg:Entry xmlns:wsrf-sg="http://docs.oasis-open.org/wsrf/sg-2"> ... </wsrf-sg:Entry> <wsrf-sg:Entry xmlns:wsrf-sg="http://docs.oasis-open.org/wsrf/sg-2"> ... 34. </wsrf-sg:Entry> </wsrf-rp:GetResourcePropertyResponse> </soapBody> </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 GetResourceProperty 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 |
This element represent a single resource as part of QMan management domain. |
18 - 22 |
The "group" membership information for a specific resource are detailed using a SericeGroupEntry which is separated from the WS-Resource itself. |
24 - 28 |
The resource member that is part of QMan management group. This element contains all what is needed for identifying and addressing the WS-Resource. |
25 |
This is the resource soap:address (as declared on its WSDL) |
26 - 27 |
The WS-Resource identifier. This is the most important information about resource. Subsequent requests directed to resource will contain this identifier. |
29 |
Additional (optional) management group information. |
33 - 34 |
Those are two additional entry summaries. Note that for each resource there's a dedicated wsrf-sg:Entry. |
Faults
No specific fault are thrown by this operation. A general Soap fault could be returned if, for example, the adapter is not running or is not working.
Quick links
Web Services Service Group specification
Web Services Resource
Web Services Resource Properties