com.intel.gpe.clients.api
Interface WSNClient

All Superinterfaces:

ServiceClient, WSRFClient, WSRPClient

public interface WSNClient
extends WSRPClient

The client interface to the WS-NotificationProducer resource.

Version:

$Id: WSNClient.java,v 1.6 2006/02/18 18:42:29 nbmalysh Exp $

Author:

Dmitry Petrov

Method Summary

SubscriptionClient

subscribe(javax.xml.namespace.QName simpleTopic, WSRFClient consumer) Subscribe to notifications.

Methods inherited from interface com.intel.gpe.clients.api.WSRPClient

getMultipleResourceProperties, getResourceProperty, getResourcePropertyDocument, queryXPath10Properties

Method Detail

subscribe

SubscriptionClient subscribe(javax.xml.namespace.QName simpleTopic,
                             WSRFClient consumer)
                             throws GPEResourceUnknownException,
                                    GPETopicDialectUnknownException,
                                    GPEInvalidTopicExpressionException,
                                    GPETopicNotSupportedException,
                                    GPESubscribeCreationFailedException,
                                    GPESecurityException,
                                    GPEMiddlewareRemoteException,
                                    GPEMiddlewareServiceException

Subscribe to notifications.

Parameters:

simpleTopic - The topic name (corresponds to SimpleTopic expression)

consumer - The notification consumer

Returns:

The client class for managing the created subscription

Throws:

GPEResourceUnknownException - If WSRF-HE fails to find a resource with corresponding identifier

GPETopicDialectUnknownException - If notification producer does not support corresponding topic expression dialect

GPETopicNotSupportedException - If notification producer does not support corresponding topic

GPEInvalidTopicExpressionException - If topic expression is malformed

GPESecurityException - If client fails to setup security

GPESubscribeCreationFailedException

GPEMiddlewareRemoteException

GPEMiddlewareServiceException