apache > ws.apache

## Apache Muse - WS-ResourceProperties - QueryResourceProperties Capability

Spec name and port type: WS-ResourceProperties v1.2, QueryResourceProperties (WSDL)

Capability URI: http://docs.oasis-open.org/wsrf/rpw-2/Query

Description: This capability exposes to remote clients the WSRP QueryResourceProperties operation, which allows them to execute queries against the resource's WSRP document. All implementations must support XPath 1.0 as a query dialect, but other query languages are allowed. The results of QueryResourceProperties may be any XML fragment - they are not necessarily the top-level elements that are returned from the WSRP "Get" operations.

Java interface: org.apache.muse.ws.resource.properties.query.QueryCapability

> JAR file: muse-wsrf-api.jar

Default Java implementation: org.apache.muse.ws.resource.properties.query.impl.SimpleQueryCapability

> JAR file: muse-wsrf-impl.jar

Action on initialize(): The default implementation creates a QueryExpressionFactory that that will be used to construct executable QueryExpressions from the query and dialect strings passed to the QueryResourceProperties operation.

Action on initializeCompleted(): None.

Action on prepareShutdown(): None.

Action on shutdown(): None.

Non-Core Dependencies:

- http://docs.oasis-open.org/wsrf/rpw-2/Get
- org.apache.muse.ws.resource.properties.query.QueryExpression
- org.apache.muse.ws.resource.properties.query.QueryExpressionFactory
- Apache Xalan

Behavior and Limitations: The default QueryExpressionFactory used by the implementation is an instance of XPathQueryExpressionFactory - it supports query strings that are XPath 1.0 compliant. Only the XPath 1.0 namespace URI should be used for the dialect URI.
The factory instance is created at initialization time using a protected method named createQueryExpressionFactory(). Users can sub-class and override this method in order to provide an alternate factory implementation that supports other dialects.
There is no query-like method on the ResourcePropertyCollection interface. This implementation works by calling GetResourcePropertyDocument and then evaluating the query string against the resulting XML document.

Initialization parameters: None.