org.globus.ogsa.utils
Class SubscriptionHelper

java.lang.Object
  org.globus.ogsa.utils.SubscriptionHelper

public class SubscriptionHelper

extends java.lang.Object

Helper class to construct OGSI compliant subscription expressions. It is intended to be used with the subscribe operation.

Constructor Summary

SubscriptionHelper()

Method Summary

static ExtensibilityType	getNameExpression(javax.xml.namespace.QName name) Creates an OGSI subscribeByName expression
static ExtensibilityType	getNameExpression(javax.xml.namespace.QName[] names) Creates an OGSI subscribeByName expression
static ExtensibilityType	getNameExpression(SubscribeByNameType name) Creates an OGSI subscribeByName expression
static ExtensibilityType	getXPathExpression(javax.xml.namespace.QName qname, java.lang.String XPathExpr, java.lang.String[] namespaces) Same as {#link #getXPathExpression(String name, String XPathExpr, String[] namespaces) getXPathExpression} but allows you to specify the fully qualified name of the service data name to serve as basis for the query.
static ExtensibilityType	getXPathExpression(java.lang.String name, java.lang.String XPathExpr, java.lang.String[] namespaces) Creates a globus subscribeByXPath expression

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SubscriptionHelper

public SubscriptionHelper()

Method Detail

getNameExpression

public static ExtensibilityType getNameExpression(javax.xml.namespace.QName name)
                                           throws GridServiceException

Creates an OGSI subscribeByName expression

Parameters:

name - name of service data element to subscribe to

Returns:

subscription expression

Throws:

GridServiceException

getNameExpression

public static ExtensibilityType getNameExpression(javax.xml.namespace.QName[] names)
                                           throws GridServiceException

Creates an OGSI subscribeByName expression

Parameters:

names - names of service data elements to subscribe to

Returns:

subscription expression

Throws:

GridServiceException

getNameExpression

public static ExtensibilityType getNameExpression(SubscribeByNameType name)
                                           throws GridServiceException

Creates an OGSI subscribeByName expression

Parameters:

name - SubscribeByNameType type

Returns:

subscription expression

Throws:

GridServiceException

getXPathExpression

public static ExtensibilityType getXPathExpression(java.lang.String name,
                                                   java.lang.String XPathExpr,
                                                   java.lang.String[] namespaces)
                                            throws GridServiceException

Creates a globus subscribeByXPath expression

Parameters:

name - name of service data to use as basis for search

XPathExpr - XPath expresstion to apply to service data

namespaces - XPath requires that the client provides a namespace mapping for every node in the query scope that has a corresponding namespace attribute. In the current implementation, this is provided via an array of Strings of the form "xmlns:=". For example: xmlns:gsdl=http://www.gridforum.org/namespaces/2003/03/OGSI

Returns:

subscription expression

Throws:

GridServiceException

getXPathExpression

public static ExtensibilityType getXPathExpression(javax.xml.namespace.QName qname,
                                                   java.lang.String XPathExpr,
                                                   java.lang.String[] namespaces)
                                            throws GridServiceException

Same as {#link #getXPathExpression(String name, String XPathExpr, String[] namespaces) getXPathExpression} but allows you to specify the fully qualified name of the service data name to serve as basis for the query.

Throws:

GridServiceException