com.pcbsys.nirvana.client.nChannel Class Reference

This class represents the standard Channel or Topic access to the UM server. More...

Inheritance diagram for com.pcbsys.nirvana.client.nChannel:
com.pcbsys.nirvana.client.nAbstractChannel

Public Member Functions

void addConnectionListener (nChannelConnectionListener listener) throws nIllegalArgumentException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException
 Adds a nChannelConnectionListener to this channel so that when new connections are made to this channel the listener is notified. More...
 
void addConnectionListener (nChannelConnectionListener listener, boolean isSync) throws nIllegalArgumentException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException
 Adds a nChannelConnectionListener to this channel so that when new connections are made to this channel the listener is notified. More...
 
void addSubscriber (nEventListener nel) throws nIllegalArgumentException, nSecurityException, nChannelNotFoundException, nChannelAlreadySubscribedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException
 Registers the specified nEventListener as a subscriber to this channel. More...
 
void addSubscriber (nEventListener nel, long eid) throws nIllegalArgumentException, nSecurityException, nChannelNotFoundException, nChannelAlreadySubscribedException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException
 Registers the specified nEventListener as a subscriber to this channel. More...
 
void addSubscriber (nEventListener nel, String selector) throws nSecurityException, nChannelNotFoundException, nChannelAlreadySubscribedException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nSelectorParserException, nIllegalArgumentException
 Registers the specified nEventListener as a subscriber to this channel. More...
 
void addSubscriber (nEventListener nel, String selector, long eid) throws nSecurityException, nChannelNotFoundException, nChannelAlreadySubscribedException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nSelectorParserException, nIllegalArgumentException
 Registers the specified nEventListener as a subscriber to this channel. More...
 
void addSubscriber (nEventListener nel, nDurable durable, String selector, boolean AutoAck) throws nSecurityException, nChannelNotFoundException, nChannelAlreadySubscribedException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nNameDoesNotExistException, nSelectorParserException, nIllegalArgumentException, nNameAlreadyBoundException
 Registers the specified nEventListener as a named subscriber to this channel. More...
 
void addSubscriber (nEventListener nel, nDurable durable) throws nSecurityException, nChannelNotFoundException, nChannelAlreadySubscribedException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nNameDoesNotExistException, nSelectorParserException, nIllegalArgumentException, nNameAlreadyBoundException
 Registers the specified nEventListener as a named subscriber to this channel. More...
 
void addSubscriber (nSignedEventListener nel, nDurable durable, String selector, nMessageValidator validator, boolean AutoAck) throws nIllegalArgumentException, nSecurityException, nChannelNotFoundException, nChannelAlreadySubscribedException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nNameAlreadyBoundException
 Registers the specified nSignedEventListener as a named subscriber to this channel. More...
 
void addSubscriber (nEventListener nel, nDurable durable, String selector, boolean AutoAck, nNamedPriorityListener listener) throws nSecurityException, nChannelNotFoundException, nChannelAlreadySubscribedException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nNameDoesNotExistException, nSelectorParserException, nIllegalArgumentException, nNameAlreadyBoundException
 Registers the specified nEventListener as a named subscriber to this channel. More...
 
void addSubscriber (nEventListener nel, nDurable durable, String selector, int windowSize) throws nSecurityException, nChannelNotFoundException, nChannelAlreadySubscribedException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nNameDoesNotExistException, nSelectorParserException, nIllegalArgumentException, nNameAlreadyBoundException
 Registers the specified nEventListener as a named subscriber to this channel. More...
 
void addSubscriber (nEventListener nel, nDurable durable, nNamedPriorityListener listener) throws nSecurityException, nChannelNotFoundException, nChannelAlreadySubscribedException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nNameDoesNotExistException, nSelectorParserException, nIllegalArgumentException, nNameAlreadyBoundException
 Registers the specified nEventListener as a named subscriber to this channel. More...
 
void addSubscriber (nSignedEventListener nel, nDurable durable, String selector, nMessageValidator validator, boolean AutoAck, nNamedPriorityListener listener) throws nIllegalArgumentException, nSecurityException, nChannelNotFoundException, nChannelAlreadySubscribedException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nNameAlreadyBoundException
 Registers the specified nSignedEventListener as a named subscriber to this channel. More...
 
void addSubscriber (nSignedEventListener nel, nDurable durable, String selector, nMessageValidator validator, int windowSize) throws nIllegalArgumentException, nSecurityException, nChannelNotFoundException, nChannelAlreadySubscribedException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nNameAlreadyBoundException
 Registers the specified nSignedEventListener as a named subscriber to this channel. More...
 
void addSubscriber (nSignedEventListener nel, nMessageValidator validator) throws nIllegalArgumentException, nSessionPausedException, nSecurityException, nChannelNotFoundException, nChannelAlreadySubscribedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException
 Registers the specified nSignedEventListener as a subscriber to this channel. More...
 
void addSubscriber (nSignedEventListener nel, long eid, nMessageValidator validator) throws nIllegalArgumentException, nSessionPausedException, nSecurityException, nChannelNotFoundException, nChannelAlreadySubscribedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException
 Registers the specified nSignedEventListener as a subscriber to this channel. More...
 
void addSubscriber (nSignedEventListener nel, String selector, nMessageValidator validator) throws nSecurityException, nSessionPausedException, nChannelNotFoundException, nChannelAlreadySubscribedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nSelectorParserException, nIllegalArgumentException
 Registers the specified nSignedEventListener as a subscriber to this channel. More...
 
void addSubscriber (nSignedEventListener nel, String selector, long eid, nMessageValidator validator) throws nSecurityException, nSessionPausedException, nChannelNotFoundException, nChannelAlreadySubscribedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nSelectorParserException, nIllegalArgumentException
 Registers the specified nSignedEventListener as a subscriber to this channel. More...
 
void addSubscriber (nEventListener nel, nNamedObject name, String selector, boolean AutoAck) throws nSecurityException, nChannelNotFoundException, nChannelAlreadySubscribedException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nNameDoesNotExistException, nSelectorParserException, nIllegalArgumentException, nNameAlreadyBoundException
 Registers the specified nEventListener as a named subscriber to this channel. More...
 
void addSubscriber (nEventListener nel, nNamedObject name) throws nSecurityException, nChannelNotFoundException, nChannelAlreadySubscribedException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nNameDoesNotExistException, nSelectorParserException, nIllegalArgumentException, nNameAlreadyBoundException
 Registers the specified nEventListener as a named subscriber to this channel. More...
 
void addSubscriber (nSignedEventListener nel, nNamedObject name, String selector, nMessageValidator validator, boolean AutoAck) throws nIllegalArgumentException, nSecurityException, nChannelNotFoundException, nChannelAlreadySubscribedException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nNameAlreadyBoundException
 Registers the specified nSignedEventListener as a named subscriber to this channel. More...
 
void addSubscriber (nEventListener nel, nNamedObject name, String selector, boolean AutoAck, nNamedPriorityListener listener) throws nSecurityException, nChannelNotFoundException, nChannelAlreadySubscribedException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nNameDoesNotExistException, nSelectorParserException, nIllegalArgumentException, nNameAlreadyBoundException
 Registers the specified nEventListener as a named subscriber to this channel. More...
 
void addSubscriber (nEventListener nel, nNamedObject name, String selector, int windowSize) throws nSecurityException, nChannelNotFoundException, nChannelAlreadySubscribedException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nNameDoesNotExistException, nSelectorParserException, nIllegalArgumentException, nNameAlreadyBoundException
 Registers the specified nEventListener as a named subscriber to this channel. More...
 
void addSubscriber (nEventListener nel, nNamedObject name, nNamedPriorityListener listener) throws nSecurityException, nChannelNotFoundException, nChannelAlreadySubscribedException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nNameDoesNotExistException, nSelectorParserException, nIllegalArgumentException, nNameAlreadyBoundException
 Registers the specified nEventListener as a named subscriber to this channel. More...
 
void addSubscriber (nSignedEventListener nel, nNamedObject name, String selector, nMessageValidator validator, boolean AutoAck, nNamedPriorityListener listener) throws nIllegalArgumentException, nSecurityException, nChannelNotFoundException, nChannelAlreadySubscribedException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nNameAlreadyBoundException
 Registers the specified nSignedEventListener as a named subscriber to this channel. More...
 
void addSubscriber (nSignedEventListener nel, nNamedObject name, String selector, nMessageValidator validator, int windowSize) throws nIllegalArgumentException, nSecurityException, nChannelNotFoundException, nChannelAlreadySubscribedException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nNameAlreadyBoundException
 Registers the specified nSignedEventListener as a named subscriber to this channel. More...
 
nChannelIterator createIterator ()
 Create a default channel iterator starting at the beginning of the channel. More...
 
nChannelIterator createIterator (String selector)
 Create a default channel iterator starting at the beginning of the channel with the events which match the selector being returned. More...
 
nChannelIterator createIterator (long startEID)
 Create a default channel iterator starting at the EID specified. More...
 
nChannelIterator createIterator (long startEID, boolean autoAck)
 Create a default channel iterator starting at the EID specified. More...
 
nChannelIterator createIterator (String selector, long startEID)
 Create a default channel iterator starting at the eid specified in the channel with the events which match the selector being returned. More...
 
nChannelIterator createIterator (String selector, long startEID, boolean autoAck)
 Create a default channel iterator starting at the eid specified in the channel with the events which match the selector being returned. More...
 
nChannelIterator createIterator (nDurable name) throws nIllegalArgumentException
 Create a default channel iterator starting at the eid specified in the channel with the events which match the selector being returned. More...
 
nChannelIterator createIterator (nDurable name, String selector) throws nIllegalArgumentException
 Create a default channel iterator starting at the eid specified in the channel with the events which match the selector being returned. More...
 
nChannelIterator createIterator (nDurable name, String selector, int windowSize) throws nIllegalArgumentException
 create a default channel iterator starting at the eid specified in the channel with the events which match the selector being returned More...
 
nChannelIterator createIterator (nDurable name, String selector, int windowSize, boolean autoAck) throws nIllegalArgumentException
 create a default channel iterator starting at the eid specified in the channel with the events which match the selector being returned More...
 
nChannelIterator createIterator (nNamedObject name)
 Create a default channel iterator starting at the eid specified in the channel with the events which match the selector being returned. More...
 
nChannelIterator createIterator (nNamedObject name, String selector)
 Create a default channel iterator starting at the eid specified in the channel with the events which match the selector being returned. More...
 
nChannelIterator createIterator (nNamedObject name, String selector, int windowSize) throws nIllegalArgumentException
 create a default channel iterator starting at the eid specified in the channel with the events which match the selector being returned More...
 
nNamedObject createNamedObject (String name) throws nIllegalArgumentException, nSessionPausedException, nSecurityException, nChannelNotFoundException, nSessionNotConnectedException, nNameAlreadyBoundException, nRequestTimedOutException, nUnexpectedResponseException, nSelectorParserException
 Creates a named object on the channel with the given name. More...
 
nNamedObject createNamedObject (String name, long startEID) throws nIllegalArgumentException, nSessionPausedException, nSecurityException, nChannelNotFoundException, nSessionNotConnectedException, nNameAlreadyBoundException, nRequestTimedOutException, nUnexpectedResponseException, nSelectorParserException
 Creates a named object on the channel with the given name. More...
 
nNamedObject createNamedObject (String name, long startEID, boolean persistent) throws nIllegalArgumentException, nSessionPausedException, nSecurityException, nChannelNotFoundException, nSessionNotConnectedException, nNameAlreadyBoundException, nRequestTimedOutException, nUnexpectedResponseException, nSelectorParserException
 Creates a named object on the channel with the given name and depending on the persistent flag informs the server to store the name and value to disk or not. More...
 
nNamedObject createNamedObject (String name, boolean persistent) throws nIllegalArgumentException, nSessionPausedException, nSecurityException, nChannelNotFoundException, nSessionNotConnectedException, nNameAlreadyBoundException, nRequestTimedOutException, nUnexpectedResponseException, nSelectorParserException
 Creates a named object on the channel with the given name and depending on the persistent flag informs the server to store the name and value to disk or not. More...
 
nNamedObject createNamedObject (String name, boolean persistent, boolean clusterWide) throws nIllegalArgumentException, nSessionPausedException, nSecurityException, nChannelNotFoundException, nSessionNotConnectedException, nNameAlreadyBoundException, nRequestTimedOutException, nUnexpectedResponseException, nSelectorParserException
 Creates a named object on the channel with the given name and depending on the persistent flag informs the server to store the name and value to disk or not. More...
 
nNamedObject createNamedObject (String name, long startEID, boolean persistent, boolean clusterWide) throws nIllegalArgumentException, nSessionPausedException, nSecurityException, nChannelNotFoundException, nSessionNotConnectedException, nNameAlreadyBoundException, nRequestTimedOutException, nUnexpectedResponseException, nSelectorParserException
 Creates a named object on the channel with the given name and depending on the persistent flag informs the server to store the name and value to disk or not. More...
 
nNamedObject createNamedObject (String name, long startEID, boolean persistent, boolean clusterWide, boolean enablePriority) throws nIllegalArgumentException, nSessionPausedException, nSecurityException, nChannelNotFoundException, nSessionNotConnectedException, nNameAlreadyBoundException, nRequestTimedOutException, nUnexpectedResponseException, nSelectorParserException
 Creates a named object on the channel with the given name and depending on the persistent flag informs the server to store the name and value to disk or not. More...
 
nRegisteredEvent createRegisteredEvent (Object keyValue) throws nIllegalArgumentException
 Creates a new nRegisteredEvent bound to this channel using the keyValue as its unique id. More...
 
nRegisteredEvent createRegisteredEvent (Object keyValue, boolean isTransactional) throws nIllegalArgumentException
 Creates a new nRegisteredEvent bound to this channel using the keyValue as its unique id. More...
 
nNamedObject createSharedNamedObject (String name, boolean persistent, boolean clusterWide, long startEID) throws nIllegalArgumentException, nSessionPausedException, nSecurityException, nChannelNotFoundException, nSessionNotConnectedException, nNameAlreadyBoundException, nRequestTimedOutException, nUnexpectedResponseException, nSelectorParserException
 Creates a named object on the channel with the given name. More...
 
void deleteJoin (nChannel destination) throws nSecurityException, nChannelNotFoundException, nSessionNotConnectedException, nRealmNotFoundException, nSessionPausedException, nRequestTimedOutException, nUnexpectedResponseException, nIllegalArgumentException
 Deletes a join between this channel and the channel referenced in the destination parameter. More...
 
void deleteJoin (nQueue destination) throws nSecurityException, nChannelNotFoundException, nSessionNotConnectedException, nRealmNotFoundException, nSessionPausedException, nRequestTimedOutException, nUnexpectedResponseException, nIllegalArgumentException
 Deletes a join between this channel and the queue referenced in the destination parameter. More...
 
void delNamedObject (String name) throws nIllegalArgumentException, nSecurityException, nSessionPausedException, nChannelNotFoundException, nSessionNotConnectedException, nNameDoesNotExistException, nRequestTimedOutException, nUnexpectedResponseException
 Removes all references for this name on the realm Server. More...
 
void delNamedObject (nNamedObject name) throws nIllegalArgumentException, nSecurityException, nChannelNotFoundException, nSessionNotConnectedException, nSessionPausedException, nNameDoesNotExistException, nRequestTimedOutException, nUnexpectedResponseException
 Removes all references for this name on the realm Server. More...
 
nChannelAttributes getChannelAttributes ()
 Gets the channels local attributes. More...
 
nDurableManager getDurableManager ()
 Gets durable manager. More...
 
long getEventCount () throws nChannelNotFoundException, nSecurityException, nSessionNotConnectedException, nRequestTimedOutException, nSessionPausedException, nUnexpectedResponseException
 Gets the number of events on this channel. More...
 
nJoinInformation[] getJoinInformation () throws nSecurityException, nChannelNotFoundException, nSessionPausedException, nSessionNotConnectedException, nRealmNotFoundException, nRequestTimedOutException, nUnexpectedResponseException
 Returns an array of nJoinInformation objects which describe the links this channel has configured for it. More...
 
long getLastEID () throws nSecurityException, nChannelNotFoundException, nSessionNotConnectedException, nSessionPausedException, nRequestTimedOutException, nUnexpectedResponseException
 Gets the last event id of this channel. More...
 
long getLastStoredEID () throws nSecurityException, nChannelNotFoundException, nSessionNotConnectedException, nSessionPausedException, nRequestTimedOutException, nUnexpectedResponseException
 Gets the last event id of this channel. More...
 
String getName ()
 Gets the name of this channel. More...
 
nNamedObject getNamedObject (String name) throws nIllegalArgumentException, nSessionPausedException, nSecurityException, nChannelNotFoundException, nSessionNotConnectedException, nNameDoesNotExistException, nRequestTimedOutException, nUnexpectedResponseException
 Returns an instance of the nNamedObject referenced by the parameter. More...
 
nNamedObject[] getNamedObjects () throws nSecurityException, nSessionPausedException, nChannelNotFoundException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException
 Returns an array of all known nNamedObjects registered with this channel. More...
 
nNamedObject getSharedNamedObject (String name) throws nIllegalArgumentException, nSessionPausedException, nSecurityException, nChannelNotFoundException, nSessionNotConnectedException, nNameDoesNotExistException, nRequestTimedOutException, nUnexpectedResponseException
 Returns an instance of the nExclusiveDurableImpl referenced by the parameter if and only if it is a nExclusiveDurableImpl. More...
 
int getType ()
 Gets the type of this channel Currently supported types are: More...
 
boolean isSubscribed ()
 Determines whether the underlying channel is currently being subscribed to. More...
 
void joinChannel (nChannel dest, String selector) throws nSecurityException, nChannelNotFoundException, nSessionPausedException, nSessionNotConnectedException, nRealmNotFoundException, nRequestTimedOutException, nUnexpectedResponseException, nSelectorParserException, nDuplicateJoinException, nIllegalArgumentException
 Sets a server based link between this channel and the channel defined within the provided nChannel. More...
 
void joinChannel (nChannel dest) throws nSecurityException, nChannelNotFoundException, nSessionPausedException, nSessionNotConnectedException, nRealmNotFoundException, nRequestTimedOutException, nUnexpectedResponseException, nDuplicateJoinException, nIllegalArgumentException
 Sets a server based link between this channel and the channel defined within the provided nChannel. More...
 
void joinChannel (nChannel dest, boolean isRouted, int hopCount, String selector) throws nSecurityException, nChannelNotFoundException, nSessionPausedException, nSessionNotConnectedException, nRealmNotFoundException, nRequestTimedOutException, nUnexpectedResponseException, nSelectorParserException, nDuplicateJoinException, nIllegalArgumentException
 Sets a server based link between this channel and the channel defined within the provided nChannel. More...
 
void joinChannel (nChannel dest, boolean isRouted, int hopCount, String selector, boolean allowPurge) throws nSecurityException, nChannelNotFoundException, nSessionPausedException, nSessionNotConnectedException, nRealmNotFoundException, nRequestTimedOutException, nUnexpectedResponseException, nSelectorParserException, nDuplicateJoinException, nIllegalArgumentException
 Sets a server based link between this channel and the channel defined within the provided nChannel. More...
 
void joinChannel (nQueue dest, String selector) throws nSecurityException, nChannelNotFoundException, nSessionNotConnectedException, nRealmNotFoundException, nSessionPausedException, nRequestTimedOutException, nUnexpectedResponseException, nSelectorParserException, nDuplicateJoinException, nIllegalArgumentException
 Sets a server based link between this channel and the queue defined by the dest parameter. More...
 
void joinChannel (nQueue dest) throws nSecurityException, nChannelNotFoundException, nSessionNotConnectedException, nRealmNotFoundException, nSessionPausedException, nRequestTimedOutException, nUnexpectedResponseException, nDuplicateJoinException, nIllegalArgumentException
 Sets a server based link between this channel and the queue defined within the provided nQueue. More...
 
void joinChannel (nQueue dest, boolean isRouted, int hopCount, String selector) throws nSecurityException, nChannelNotFoundException, nSessionPausedException, nSessionNotConnectedException, nRealmNotFoundException, nRequestTimedOutException, nUnexpectedResponseException, nSelectorParserException, nDuplicateJoinException, nIllegalArgumentException
 Sets a server based link between this channel and the queue defined within the provided nQueue. More...
 
void joinChannelToArchive (nQueue dest) throws nSecurityException, nChannelNotFoundException, nSessionNotConnectedException, nRealmNotFoundException, nSessionPausedException, nRequestTimedOutException, nUnexpectedResponseException, nDuplicateJoinException, nIllegalArgumentException
 Sets a server based link between this channel and the queue defined within the provided nQueue. More...
 
void joinChannelToArchive (nQueue dest, String selector) throws nSecurityException, nChannelNotFoundException, nSessionNotConnectedException, nRealmNotFoundException, nSessionPausedException, nRequestTimedOutException, nUnexpectedResponseException, nDuplicateJoinException, nIllegalArgumentException
 Sets a server based link between this channel and the queue defined within the provided nQueue. More...
 
void publish (String tag, Document adom) throws nSessionNotConnectedException, nSessionPausedException, nIllegalArgumentException, nSecurityException, nMaxBufferSizeExceededException
 Publishes the specified XML DOM document to this channel with the specified tag. More...
 
void publish (nConsumeEvent e) throws nSessionNotConnectedException, nSessionPausedException, nIllegalArgumentException, nSecurityException, nMaxBufferSizeExceededException
 Publishes the specified nConsumeEvent to this channel. More...
 
void publish (String tag, Document adom, nMessageSigner signer) throws nSessionNotConnectedException, nSessionPausedException, nIllegalArgumentException, nSecurityException, nMaxBufferSizeExceededException
 Publishes the specified XML DOM document to this channel with the specified tag. More...
 
void publish (nConsumeEvent e, nMessageSigner signer) throws nSessionNotConnectedException, nSessionPausedException, nIllegalArgumentException, nSecurityException, nMaxBufferSizeExceededException
 Publishes the specified nConsumeEvent to this channel. More...
 
void purgeEvent (long eidval) throws nSecurityException, nChannelNotFoundException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nIllegalArgumentException
 Purges a single event from this channel. More...
 
void purgeEvent (long eidval, boolean purgeJoins) throws nSecurityException, nChannelNotFoundException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nIllegalArgumentException
 Purges a single event from this channel. More...
 
void purgeEventAsync (long eidval) throws nSecurityException, nChannelNotFoundException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nIllegalArgumentException
 Purges a single event from this channel and does not wait for the response from the server. More...
 
void purgeEventAsync (long eidval, boolean purgeJoins) throws nSecurityException, nChannelNotFoundException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nIllegalArgumentException
 Purges a single event from this channel and does not wait for the response from the server. More...
 
void purgeEvents (long startEID, long endEID, boolean purgeJoins) throws nSecurityException, nChannelNotFoundException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nIllegalArgumentException
 Purges a range of events (first to last, all inclusive) from this channel. More...
 
void purgeEvents (long startEID, long endEID) throws nSecurityException, nChannelNotFoundException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nIllegalArgumentException
 Purges a range of events from this channel. More...
 
void purgeEvents (long startEID, long endEID, String selector) throws nSecurityException, nChannelNotFoundException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nIllegalArgumentException
 Purges a range of events from this channel. More...
 
void purgeEvents (long startEID, long endEID, String selector, boolean purgeJoins) throws nSecurityException, nChannelNotFoundException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nIllegalArgumentException
 Purges a range of events from this channel. More...
 
void purgeEventsAsync (long startEID, long endEID) throws nSecurityException, nChannelNotFoundException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nIllegalArgumentException
 Purges a range of events from this channel and does not wait for the response from the server. More...
 
void purgeEventsAsync (long startEID, long endEID, boolean purgeJoins) throws nSecurityException, nChannelNotFoundException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nIllegalArgumentException
 Purges a range of events from this channel and does not wait for the response from the server. More...
 
void purgeEventsAsync (long startEID, long endEID, String selector) throws nSecurityException, nChannelNotFoundException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nIllegalArgumentException
 Purges a range of events from this channel and does not wait for the response from the server. More...
 
void purgeEventsAsync (long startEID, long endEID, String selector, boolean purgeJoins) throws nSecurityException, nChannelNotFoundException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nIllegalArgumentException
 Purges a range of events from this channel and does not wait for the response from the server. More...
 
void removeConnectionListener () throws nSessionNotConnectedException, nSessionPausedException, nRequestTimedOutException, nUnexpectedResponseException
 Removes the connection listener to this channel. More...
 
void removeConnectionListener (nChannelConnectionListener listener) throws nSessionNotConnectedException, nSessionPausedException, nRequestTimedOutException, nUnexpectedResponseException
 Removes the connection listener to this channel. More...
 
void removeSubscriber (nEventListener nel) throws nIllegalArgumentException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException
 Unregisters the specified nEventListener as a subscriber from this channel. More...
 
void removeSubscriber (nEventListener nel, boolean wait) throws nIllegalArgumentException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException
 Unregisters the specified nEventListener as a subscriber from this channel. More...
 
void reSubscribe (String selector) throws nIllegalArgumentException, nSecurityException, nChannelNotFoundException, nChannelAlreadySubscribedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException
 Removes the current subscriber and re-registers the nEventListener as a subscriber to this channel. More...
 
void reSubscribe (long eid) throws nSecurityException, nChannelNotFoundException, nChannelAlreadySubscribedException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nSelectorParserException, nIllegalArgumentException
 Removes the current subscriber and registers the specified nEventListener as a subscriber to this channel. More...
 
void reSubscribe (String selector, long eid) throws nSecurityException, nChannelNotFoundException, nChannelAlreadySubscribedException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nSelectorParserException, nIllegalArgumentException
 Removes the current subscriber and re-registers the nEventListener as a subscriber to this channel. More...
 
void reSubscribe (nDurable durable, String selector) throws nSecurityException, nChannelNotFoundException, nChannelAlreadySubscribedException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nNameDoesNotExistException, nSelectorParserException, nIllegalArgumentException, nNameAlreadyBoundException
 Removes the current subscriber and registers the specified nEventListener as a named subscriber to this channel. More...
 
void reSubscribe (nNamedObject name, String selector) throws nSecurityException, nChannelNotFoundException, nChannelAlreadySubscribedException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nNameDoesNotExistException, nSelectorParserException, nIllegalArgumentException, nNameAlreadyBoundException
 Removes the current subscriber and registers the specified nEventListener as a named subscriber to this channel. More...
 
void unbindNamedObject (String name) throws nIllegalArgumentException, nSecurityException, nSessionPausedException, nChannelNotFoundException, nSessionNotConnectedException, nNameDoesNotExistException, nRequestTimedOutException, nUnexpectedResponseException
 Unbinds the named object from the current connection. More...
 
void unbindNamedObject (nNamedObject name) throws nIllegalArgumentException, nSecurityException, nChannelNotFoundException, nSessionNotConnectedException, nSessionPausedException, nNameDoesNotExistException, nRequestTimedOutException, nUnexpectedResponseException
 Unbinds the named object from the current connection. More...
 
- Public Member Functions inherited from com.pcbsys.nirvana.client.nAbstractChannel
int getQueueSize ()
 Returns the size of the underlying event queue waiting for delivery via the go method. More...
 
nSession getSession ()
 Returns the nSession used to create/find this channel. More...
 
nChannelAttributes getStoreAttributes ()
 The attributes about this channel and how it is configured. More...
 
boolean isStoreObjectInvalid ()
 When a store is removed (or modified which entails a remove and create) then these logical representations can become invalid Once they are invalid you must perform a findChannel again on the nSession to acquire the latest object. More...
 
void updateProtobufDefinitions (byte[][] descriptors) throws nIllegalArgumentException, nSessionNotConnectedException, nRequestTimedOutException, nSessionPausedException
 Update the Protocol Buffer definition for the store. More...
 

Protected Member Functions

void addSubscriber (nSignedEventListener nel, nNamedObject name, String selector, nMessageValidator validator, boolean AutoAck, int windowSize, nNamedPriorityListener listener) throws nIllegalArgumentException, nSecurityException, nChannelNotFoundException, nChannelAlreadySubscribedException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nNameAlreadyBoundException
 Add subscriber. More...
 
nClientChannelList getChannelList ()
 Gets channel list. More...
 
 nChannel (nChannel channel)
 Specifically for AdminApi wrappers. More...
 

Detailed Description

This class represents the standard Channel or Topic access to the UM server.

Constructor & Destructor Documentation

com.pcbsys.nirvana.client.nChannel.nChannel ( nChannel  channel)
protected

Specifically for AdminApi wrappers.

Parameters
channelthe channel to wrap

Member Function Documentation

Adds a nChannelConnectionListener to this channel so that when new connections are made to this channel the listener is notified.

Parameters
listenerto add
Exceptions
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server., or has already been set.
nSessionPausedExceptionThe session is currently paused, please resume
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
void com.pcbsys.nirvana.client.nChannel.addConnectionListener ( nChannelConnectionListener  listener,
boolean  isSync 
) throws nIllegalArgumentException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException

Adds a nChannelConnectionListener to this channel so that when new connections are made to this channel the listener is notified.

Parameters
listenerto add
isSyncthe call is synchronous
Exceptions
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server., or has already been set.
nSessionPausedExceptionThe session is currently paused, please resume
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information

Registers the specified nEventListener as a subscriber to this channel.

The subscriber will receive all events contained in this channel.

Parameters
nelthe nEventListener object to be registered as a subscriber
Exceptions
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nChannelAlreadySubscribedExceptionA subscriber is already registered with this channel on this session
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information

Registers the specified nEventListener as a subscriber to this channel.

The subscriber will receive all events with event id greater than or equal to the one specified.

Parameters
nelthe nEventListener object to be registered as a subscriber
eida long specifying the subscription's start eid
Exceptions
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nChannelAlreadySubscribedExceptionA subscriber is already registered with this channel on this session
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information

Registers the specified nEventListener as a subscriber to this channel.

The subscriber will receive all events contained in this channel, apart from the ones restricted by the specified filter.

Parameters
nelthe nEventListener object to be registered as a subscriber
selectora string specifying a filter to this subscription request
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nChannelAlreadySubscribedExceptionA subscriber is already registered with this channel on this session
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nSelectorParserExceptionThe selector has syntax errors
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.

Registers the specified nEventListener as a subscriber to this channel.

The subscriber will receive all events with event id greater than or equeal to the one specified, apart from the ones restricted by the specified filter.

Parameters
nelthe nEventListener object to be registered as a subscriber
selectora string specifying a filter to this subscription request
eida long specifying the subscription's start eid
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nChannelAlreadySubscribedExceptionA subscriber is already registered with this channel on this session
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nSelectorParserExceptionThe selector has syntax errors
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.

Registers the specified nEventListener as a named subscriber to this channel.

The subscriber will receive all events from the last acknowledged event for the name supplied If the name is new it will start from the END of the channel.

Parameters
nelthe nEventListener object to be registered as a subscriber
durablean nDurable specifying a name for this subscription
selectora string specifying a filter to this subscription request
AutoAcka boolean used to control whether the nirvana client will automatically ack events or if the user will ack events later
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nChannelAlreadySubscribedExceptionA subscriber is already registered with this channel on this session
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nNameDoesNotExistExceptionif the server does not know about the named object
nSelectorParserExceptionThe selector has syntax errors
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nNameAlreadyBoundExceptionThe name is already bound and used by another client
Since
9.12

Registers the specified nEventListener as a named subscriber to this channel.

The subscriber will receive all events from the last acknowledged event for the name supplied If the name is new it will start from the END of the channel.

Parameters
nelthe nEventListener object to be registered as a subscriber
durablea nDurable specifying a name for this subscription
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nChannelAlreadySubscribedExceptionA subscriber is already registered with this channel on this session
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nNameDoesNotExistExceptionif the server does not know about the named object
nSelectorParserExceptionThe selector has syntax errors
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nNameAlreadyBoundExceptionThe name is already bound and used by another client
Since
9.12

Registers the specified nSignedEventListener as a named subscriber to this channel.

The subscriber will receive all events from the last acknowledged event for the name supplied If the name is new it will start from the END of the channel.

Parameters
nelthe nSignedEventListener object to be registered as a subscriber
durablean nDurable specifying a name for this subscription
selectora string specifying a filter to this subscription request
validatorused to check the validity of the event being delivered
AutoAcka boolean used to control whether the nirvana client will automatically ack events or if the user will ack events later
Exceptions
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nChannelAlreadySubscribedExceptionA subscriber is already registered with this channel on this session
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nNameAlreadyBoundExceptionThe name is already bound and used by another client
Since
9.12

Registers the specified nEventListener as a named subscriber to this channel.

The subscriber will receive all events from the last acknowledged event for the name supplied If the name is new it will start from the END of the channel.

Parameters
nelthe nEventListener object to be registered as a subscriber
durablean nDurable specifying a name for this subscription
selectora string specifying a filter to this subscription request
AutoAcka boolean used to control whether the nirvana client will automatically ack events or if the user will ack events later
listenera nNamedPriorityListener which is called back when this subscription reaches the top of the queue and is now the top priority to receive events
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nChannelAlreadySubscribedExceptionA subscriber is already registered with this channel on this session
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nNameDoesNotExistExceptionif the server does not know about the named object
nSelectorParserExceptionThe selector has syntax errors
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nNameAlreadyBoundExceptionThe name is already bound and used by another client
Since
9.12

Registers the specified nEventListener as a named subscriber to this channel.

The subscriber will receive all events from the last acknowledged event for the name supplied If the name is new it will start from the END of the channel.

Parameters
nelthe nEventListener object to be registered as a subscriber
durablean nDurable specifying a name for this subscription
selectora string specifying a filter to this subscription request
windowSizethe amount of events that the user is allowed to receive before a commit or rollback is required, this property is only valid for shared named objects
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nChannelAlreadySubscribedExceptionA subscriber is already registered with this channel on this session
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nNameDoesNotExistExceptionif the server does not know about the named object
nSelectorParserExceptionThe selector has syntax errors
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nNameAlreadyBoundExceptionThe name is already bound and used by another client
Since
9.12

Registers the specified nEventListener as a named subscriber to this channel.

The subscriber will receive all events from the last acknowledged event for the name supplied If the name is new it will start from the END of the channel.

Parameters
nelthe nEventListener object to be registered as a subscriber
durablea nDurable specifying a name for this subscription
listenera nNamedPriorityListener which is called back when this subscription reaches the top of the queue and is now the top priority to receive events
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nChannelAlreadySubscribedExceptionA subscriber is already registered with this channel on this session
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nNameDoesNotExistExceptionif the server does not know about the named object
nSelectorParserExceptionThe selector has syntax errors
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nNameAlreadyBoundExceptionThe name is already bound and used by another client
Since
9.12

Registers the specified nSignedEventListener as a named subscriber to this channel.

The subscriber will receive all events from the last acknowledged event for the name supplied If the name is new it will start from the END of the channel.

Parameters
nelthe nSignedEventListener object to be registered as a subscriber
durablean nNamedObject specifying a name for this subscription
selectora string specifying a filter to this subscription request
validatorused to check the validity of the event being delivered
AutoAcka boolean used to control whether the nirvana client will automatically ack events or if the user will ack events later
listenera nNamedPriorityListener which is called back when this subscription reaches the top of the queue and is now the top priority to receive events
Exceptions
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nChannelAlreadySubscribedExceptionA subscriber is already registered with this channel on this session
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nNameAlreadyBoundExceptionThe name is already bound and used by another client
Since
9.12

Registers the specified nSignedEventListener as a named subscriber to this channel.

The subscriber will receive all events from the last acknowledged event for the name supplied If the name is new it will start from the END of the channel.

Parameters
nelthe nSignedEventListener object to be registered as a subscriber
durablean nNamedObject specifying a name for this subscription
selectora string specifying a filter to this subscription request
validatorused to check the validity of the event being delivered
windowSizethe amount of events that the user is allowed to receive before a commit or rollback is required, this property is only valid for shared named objects
Exceptions
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nChannelAlreadySubscribedExceptionA subscriber is already registered with this channel on this session
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nNameAlreadyBoundExceptionThe name is already bound and used by another client
Since
9.12

Registers the specified nSignedEventListener as a subscriber to this channel.

The subscriber will receive all events contained in this channel.

Parameters
nelthe nSignedEventListener object to be registered as a subscriber
validatorMessage Validator object used to check the events signature
Exceptions
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nSessionPausedExceptionThe session is currently paused, please resume
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nChannelAlreadySubscribedExceptionA subscriber is already registered with this channel on this session
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information

Registers the specified nSignedEventListener as a subscriber to this channel.

The subscriber will receive all events with event id greater than or equal to the one specified.

Parameters
nelthe nSignedEventListener object to be registered as a subscriber
eida long specifying the subscription's start eid
validatorMessage Validator object used to check the events signature
Exceptions
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nSessionPausedExceptionThe session is currently paused, please resume
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nChannelAlreadySubscribedExceptionA subscriber is already registered with this channel on this session
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information

Registers the specified nSignedEventListener as a subscriber to this channel.

The subscriber will receive all events contained in this channel, apart from the ones restricted by the specified filter.

Parameters
nelthe nSignedEventListener object to be registered as a subscriber
selectora string specifying a filter to this subscription request
validatorMessage Validator object used to check the events signature
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nSessionPausedExceptionThe session is currently paused, please resume
nChannelNotFoundExceptionif the channel no longer exists
nChannelAlreadySubscribedExceptionA subscriber is already registered with this channel on this session
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nSelectorParserExceptionThe selector has syntax errors
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.

Registers the specified nSignedEventListener as a subscriber to this channel.

The subscriber will receive all events with event id greater than or equal to the one specified, apart from the ones restricted by the specified filter.

Parameters
nelthe nSignedEventListener object to be registered as a subscriber
selectora string specifying a filter to this subscription request
eida long specifying the subscription's start eid
validatorMessage Validator object used to check the events signature
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nSessionPausedExceptionThe session is currently paused, please resume
nChannelNotFoundExceptionif the channel no longer exists
nChannelAlreadySubscribedExceptionA subscriber is already registered with this channel on this session
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nSelectorParserExceptionThe selector has syntax errors
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.

Add subscriber.

Parameters
nelthe nel
namethe name
selectorthe selector
validatorthe validator
AutoAckthe auto ack
windowSizethe window size
listenerthe listener
Exceptions
nIllegalArgumentExceptionthe n illegal argument exception
nSecurityExceptionthe n security exception
nChannelNotFoundExceptionthe n channel not found exception
nChannelAlreadySubscribedExceptionthe n channel already subscribed exception
nSessionPausedExceptionthe n session paused exception
nSessionNotConnectedExceptionthe n session not connected exception
nRequestTimedOutExceptionthe n request timed out exception
nUnexpectedResponseExceptionthe n unexpected response exception
nNameAlreadyBoundExceptionthe n name already bound exception

Registers the specified nEventListener as a named subscriber to this channel.

The subscriber will receive all events from the last acknowledged event for the name supplied If the name is new it will start from the END of the channel.

Parameters
nelthe nEventListener object to be registered as a subscriber
namean nNamedObject specifying a name for this subscription
selectora string specifying a filter to this subscription request
AutoAcka boolean used to control whether the nirvana client will automatically ack events or if the user will ack events later
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nChannelAlreadySubscribedExceptionA subscriber is already registered with this channel on this session
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nNameDoesNotExistExceptionif the server does not know about the named object
nSelectorParserExceptionThe selector has syntax errors
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nNameAlreadyBoundExceptionThe name is already bound and used by another client
Deprecated:
9.12, Use the addSubscriber(nEventListener, nDurable);

Registers the specified nEventListener as a named subscriber to this channel.

The subscriber will receive all events from the last acknowledged event for the name supplied If the name is new it will start from the END of the channel.

Parameters
nelthe nEventListener object to be registered as a subscriber
namea nNamedObject specifying a name for this subscription
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nChannelAlreadySubscribedExceptionA subscriber is already registered with this channel on this session
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nNameDoesNotExistExceptionif the server does not know about the named object
nSelectorParserExceptionThe selector has syntax errors
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nNameAlreadyBoundExceptionThe name is already bound and used by another client
Deprecated:
9.12, Use the addSubscriber(nEventListener, nDurable);

Registers the specified nSignedEventListener as a named subscriber to this channel.

The subscriber will receive all events from the last acknowledged event for the name supplied If the name is new it will start from the END of the channel.

Parameters
nelthe nSignedEventListener object to be registered as a subscriber
namean nNamedObject specifying a name for this subscription
selectora string specifying a filter to this subscription request
validatorused to check the validity of the event being delivered
AutoAcka boolean used to control whether the nirvana client will automatically ack events or if the user will ack events later
Exceptions
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nChannelAlreadySubscribedExceptionA subscriber is already registered with this channel on this session
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nNameAlreadyBoundExceptionThe name is already bound and used by another client
Deprecated:
9.12, Use the addSubscriber(nEventListener, nDurable, String, boolean);

Registers the specified nEventListener as a named subscriber to this channel.

The subscriber will receive all events from the last acknowledged event for the name supplied If the name is new it will start from the END of the channel.

Parameters
nelthe nEventListener object to be registered as a subscriber
namean nNamedObject specifying a name for this subscription
selectora string specifying a filter to this subscription request
AutoAcka boolean used to control whether the nirvana client will automatically ack events or if the user will ack events later
listenera nNamedPriorityListener which is called back when this subscription reaches the top of the queue and is now the top priority to receive events
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nChannelAlreadySubscribedExceptionA subscriber is already registered with this channel on this session
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nNameDoesNotExistExceptionif the server does not know about the named object
nSelectorParserExceptionThe selector has syntax errors
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nNameAlreadyBoundExceptionThe name is already bound and used by another client
Deprecated:
9.12, Use the addSubscriber(nEventListener, nDurable, String, boolean, nNamedPriorityListener);

Registers the specified nEventListener as a named subscriber to this channel.

The subscriber will receive all events from the last acknowledged event for the name supplied If the name is new it will start from the END of the channel.

Parameters
nelthe nEventListener object to be registered as a subscriber
namean nNamedObject specifying a name for this subscription
selectora string specifying a filter to this subscription request
windowSizethe amount of events that the user is allowed to receive before a commit or rollback is required, this property is only valid for shared named objects
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nChannelAlreadySubscribedExceptionA subscriber is already registered with this channel on this session
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nNameDoesNotExistExceptionif the server does not know about the named object
nSelectorParserExceptionThe selector has syntax errors
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nNameAlreadyBoundExceptionThe name is already bound and used by another client
Deprecated:
9.12

Registers the specified nEventListener as a named subscriber to this channel.

The subscriber will receive all events from the last acknowledged event for the name supplied If the name is new it will start from the END of the channel.

Parameters
nelthe nEventListener object to be registered as a subscriber
namea nNamedObject specifying a name for this subscription
listenera nNamedPriorityListener which is called back when this subscription reaches the top of the queue and is now the top priority to receive events
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nChannelAlreadySubscribedExceptionA subscriber is already registered with this channel on this session
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nNameDoesNotExistExceptionif the server does not know about the named object
nSelectorParserExceptionThe selector has syntax errors
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nNameAlreadyBoundExceptionThe name is already bound and used by another client
Deprecated:
9.12

Registers the specified nSignedEventListener as a named subscriber to this channel.

The subscriber will receive all events from the last acknowledged event for the name supplied If the name is new it will start from the END of the channel.

Parameters
nelthe nSignedEventListener object to be registered as a subscriber
namean nNamedObject specifying a name for this subscription
selectora string specifying a filter to this subscription request
validatorused to check the validity of the event being delivered
AutoAcka boolean used to control whether the nirvana client will automatically ack events or if the user will ack events later
listenera nNamedPriorityListener which is called back when this subscription reaches the top of the queue and is now the top priority to receive events
Exceptions
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nChannelAlreadySubscribedExceptionA subscriber is already registered with this channel on this session
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nNameAlreadyBoundExceptionThe name is already bound and used by another client
Deprecated:
9.12

Registers the specified nSignedEventListener as a named subscriber to this channel.

The subscriber will receive all events from the last acknowledged event for the name supplied If the name is new it will start from the END of the channel.

Parameters
nelthe nSignedEventListener object to be registered as a subscriber
namean nNamedObject specifying a name for this subscription
selectora string specifying a filter to this subscription request
validatorused to check the validity of the event being delivered
windowSizethe amount of events that the user is allowed to receive before a commit or rollback is required, this property is only valid for shared named objects
Exceptions
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nChannelAlreadySubscribedExceptionA subscriber is already registered with this channel on this session
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nNameAlreadyBoundExceptionThe name is already bound and used by another client
Deprecated:
9.12
nChannelIterator com.pcbsys.nirvana.client.nChannel.createIterator ( )

Create a default channel iterator starting at the beginning of the channel.

Returns
nChannelIterator for the current channel
nChannelIterator com.pcbsys.nirvana.client.nChannel.createIterator ( String  selector)

Create a default channel iterator starting at the beginning of the channel with the events which match the selector being returned.

Parameters
selectorUsed to specify a sub set of the current channel events
Returns
nChannelIterator for the current channel
nChannelIterator com.pcbsys.nirvana.client.nChannel.createIterator ( long  startEID)

Create a default channel iterator starting at the EID specified.

Parameters
startEIDThe event to start iterating the channel from
Returns
nChannelIterator for the current channel
nChannelIterator com.pcbsys.nirvana.client.nChannel.createIterator ( long  startEID,
boolean  autoAck 
)

Create a default channel iterator starting at the EID specified.

Parameters
startEIDThe event to start iterating the channel from
autoAckSpecifies whether the channel iterator requires acknowledgment - default is auto ack true
Returns
nChannelIterator for the current channel
nChannelIterator com.pcbsys.nirvana.client.nChannel.createIterator ( String  selector,
long  startEID 
)

Create a default channel iterator starting at the eid specified in the channel with the events which match the selector being returned.

Parameters
selectorUsed to specify a sub set of the current channel events
startEIDThe event to start iterating the channel from
Returns
nChannelIterator for the current channel
nChannelIterator com.pcbsys.nirvana.client.nChannel.createIterator ( String  selector,
long  startEID,
boolean  autoAck 
)

Create a default channel iterator starting at the eid specified in the channel with the events which match the selector being returned.

Parameters
selectorUsed to specify a sub set of the current channel events
startEIDThe event to start iterating the channel from
autoAckSpecifies whether the channel iterator requires acknowledgment - default is auto ack true
Returns
nChannelIterator for the current channel
nChannelIterator com.pcbsys.nirvana.client.nChannel.createIterator ( nDurable  name) throws nIllegalArgumentException

Create a default channel iterator starting at the eid specified in the channel with the events which match the selector being returned.

Parameters
nameNamed Object reference to use for this iterator
Returns
nChannelIterator for the current channel
Exceptions
nIllegalArgumentExceptionnIllegalArgumentException.
Since
9.12
nChannelIterator com.pcbsys.nirvana.client.nChannel.createIterator ( nDurable  name,
String  selector 
) throws nIllegalArgumentException

Create a default channel iterator starting at the eid specified in the channel with the events which match the selector being returned.

Parameters
nameNamed Object reference to use for this iterator
selectorUsed to specify a sub set of the current channel events
Returns
nChannelIterator for the current channel
Exceptions
nIllegalArgumentExceptionthe nIllegalArgumentException
Since
9.12
nChannelIterator com.pcbsys.nirvana.client.nChannel.createIterator ( nDurable  name,
String  selector,
int  windowSize 
) throws nIllegalArgumentException

create a default channel iterator starting at the eid specified in the channel with the events which match the selector being returned

Parameters
namenamed object reference to use for this iterator
selectorused to specify a sub set of the current channel events
windowSizespecifies the amount of events that the user is allowed to receive before a commit or rollback is required this property is only valid for shared named objects. Infinite window size can be specified using nChannelIterator.infinite_window.
Returns
nChannelIterator for the current channel
Exceptions
nIllegalArgumentExceptionthrown in case an illegal argument is passed- when window size is specified for not shared named objects or if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
Since
9.12
nChannelIterator com.pcbsys.nirvana.client.nChannel.createIterator ( nDurable  name,
String  selector,
int  windowSize,
boolean  autoAck 
) throws nIllegalArgumentException

create a default channel iterator starting at the eid specified in the channel with the events which match the selector being returned

Parameters
namenamed object reference to use for this iterator
selectorused to specify a sub set of the current channel events
windowSizespecifies the amount of events that the user is allowed to receive before a commit or rollback is required this property is only valid for shared or queued durable objects. infinite window size can be specified using nChannelIterator.infinite_window.
autoAckIf true then the server and client will assume any event delivered is acked, else the client will manually need to ack the events
Returns
nChannelIterator for the current channel
Exceptions
nIllegalArgumentExceptionthrown in case an illegal argument is passed- when window size is specified for not shared named objects or if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
Since
9.12
nChannelIterator com.pcbsys.nirvana.client.nChannel.createIterator ( nNamedObject  name)

Create a default channel iterator starting at the eid specified in the channel with the events which match the selector being returned.

Parameters
nameNamed Object reference to use for this iterator
Returns
nChannelIterator for the current channel
Deprecated:
since 9.12
See Also
nDurable
nChannelIterator com.pcbsys.nirvana.client.nChannel.createIterator ( nNamedObject  name,
String  selector 
)

Create a default channel iterator starting at the eid specified in the channel with the events which match the selector being returned.

Parameters
nameNamed Object reference to use for this iterator
selectorUsed to specify a sub set of the current channel events
Returns
nChannelIterator for the current channel
Deprecated:
since 9.12
See Also
nDurable
nChannelIterator com.pcbsys.nirvana.client.nChannel.createIterator ( nNamedObject  name,
String  selector,
int  windowSize 
) throws nIllegalArgumentException

create a default channel iterator starting at the eid specified in the channel with the events which match the selector being returned

Parameters
namenamed object reference to use for this iterator
selectorused to specify a sub set of the current channel events
windowSizespecifies the amount of events that the user is allowed to receive before a commit or rollback is required this property is only valid for shared named objects. Infinite window size can be specified using nChannelIterator.infinite_window.
Returns
nChannelIterator for the current channel
Exceptions
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
Since
9.10
Deprecated:
since 9.12
See Also
nDurable

Creates a named object on the channel with the given name.

Parameters
nameto create
Returns
the nNamedObject created
Exceptions
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nSessionPausedExceptionThe session is currently paused, please resume
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nSessionNotConnectedExceptionThe session is not currently connected to the server
nNameAlreadyBoundExceptionIf the name is already in use
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
Deprecated:
9.12 use nDurableManager.add(nDurableAttributes attr);

Creates a named object on the channel with the given name.

Parameters
nameto create
startEIDevent EID to start the named object from
Returns
the nNamedObject created
Exceptions
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nSessionPausedExceptionThe session is currently paused, please resume
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nSessionNotConnectedExceptionThe session is not currently connected to the server
nNameAlreadyBoundExceptionIf the name is already in use
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
Deprecated:
9.12 use nDurableManager.add(nDurableAttributes attr);

Creates a named object on the channel with the given name and depending on the persistent flag informs the server to store the name and value to disk or not.

Parameters
nameto create
startEIDevent EID to start the named object from
persistentflag to indicate to the server where to store it
Returns
the nNamedObject created
Exceptions
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nSessionPausedExceptionThe session is currently paused, please resume
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nSessionNotConnectedExceptionThe session is not currently connected to the server
nNameAlreadyBoundExceptionIf the name is already in use
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
Deprecated:
9.12 use nDurableManager.add(nDurableAttributes attr);

Creates a named object on the channel with the given name and depending on the persistent flag informs the server to store the name and value to disk or not.

Parameters
nameto create
persistentflag to indicate to the server where to store it
Returns
the nNamedObject created
Exceptions
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nSessionPausedExceptionThe session is currently paused, please resume
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nSessionNotConnectedExceptionThe session is not currently connected to the server
nNameAlreadyBoundExceptionIf the name is already in use
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
Deprecated:
9.12 use nDurableManager.add(nDurableAttributes attr);

Creates a named object on the channel with the given name and depending on the persistent flag informs the server to store the name and value to disk or not.

Parameters
nameto create
persistentflag to indicate to the server where to store it
clusterWideflag to indicate if this named object is valid in the entire cluster
Returns
the nNamedObject created
Exceptions
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nSessionPausedExceptionThe session is currently paused, please resume
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nSessionNotConnectedExceptionThe session is not currently connected to the server
nNameAlreadyBoundExceptionIf the name is already in use
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
Deprecated:
9.12 use nDurableManager.add(nDurableAttributes attr);
nNamedObject com.pcbsys.nirvana.client.nChannel.createNamedObject ( String  name,
long  startEID,
boolean  persistent,
boolean  clusterWide 
) throws nIllegalArgumentException, nSessionPausedException, nSecurityException, nChannelNotFoundException, nSessionNotConnectedException, nNameAlreadyBoundException, nRequestTimedOutException, nUnexpectedResponseException, nSelectorParserException

Creates a named object on the channel with the given name and depending on the persistent flag informs the server to store the name and value to disk or not.

Parameters
nameto create
startEIDevent EID to start the named object from
persistentflag to indicate to the server where to store it
clusterWideflag to indicate if this named object is valid in the entire cluster
Returns
the nNamedObject created
Exceptions
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nSessionPausedExceptionThe session is currently paused, please resume
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nSessionNotConnectedExceptionThe session is not currently connected to the server
nNameAlreadyBoundExceptionIf the name is already in use
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
Deprecated:
9.12 use nDurableManager.add(nDurableAttributes attr);
nNamedObject com.pcbsys.nirvana.client.nChannel.createNamedObject ( String  name,
long  startEID,
boolean  persistent,
boolean  clusterWide,
boolean  enablePriority 
) throws nIllegalArgumentException, nSessionPausedException, nSecurityException, nChannelNotFoundException, nSessionNotConnectedException, nNameAlreadyBoundException, nRequestTimedOutException, nUnexpectedResponseException, nSelectorParserException

Creates a named object on the channel with the given name and depending on the persistent flag informs the server to store the name and value to disk or not.

Parameters
nameto create
startEIDevent EID to start the named object from
persistentflag to indicate to the server where to store it
clusterWideflag to indicate if this named object is valid in the entire cluster
enablePriorityflag to indicate if multiple subscriptions will be prioritized on this object
Returns
the nNamedObject created
Exceptions
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nSessionPausedExceptionThe session is currently paused, please resume
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nSessionNotConnectedExceptionThe session is not currently connected to the server
nNameAlreadyBoundExceptionIf the name is already in use
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
Deprecated:
9.12
See Also
nDurableManager.add(nDurableAttributes attr)
nRegisteredEvent com.pcbsys.nirvana.client.nChannel.createRegisteredEvent ( Object  keyValue) throws nIllegalArgumentException

Creates a new nRegisteredEvent bound to this channel using the keyValue as its unique id.

Parameters
keyValueUnique Id to use for the nRegisteredEvent
Returns
nRegisteredEvent nRegisteredEvent
Exceptions
nIllegalArgumentExceptionif unable to create the nRegisteredEvent object, one condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server
nRegisteredEvent com.pcbsys.nirvana.client.nChannel.createRegisteredEvent ( Object  keyValue,
boolean  isTransactional 
) throws nIllegalArgumentException

Creates a new nRegisteredEvent bound to this channel using the keyValue as its unique id.

Parameters
keyValueUnique Id to use for the nRegisteredEvent
isTransactionalIndicates that all commits on the nRegisteredEvent should use transactional semantics
Returns
nRegisteredEvent nRegisteredEvent
Exceptions
nIllegalArgumentExceptionif unable to create the nRegisteredEvent object, one condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server
nNamedObject com.pcbsys.nirvana.client.nChannel.createSharedNamedObject ( String  name,
boolean  persistent,
boolean  clusterWide,
long  startEID 
) throws nIllegalArgumentException, nSessionPausedException, nSecurityException, nChannelNotFoundException, nSessionNotConnectedException, nNameAlreadyBoundException, nRequestTimedOutException, nUnexpectedResponseException, nSelectorParserException

Creates a named object on the channel with the given name.

Parameters
nameto create
persistentif true then the named object will be backed up on disk
clusterWideflag to indicate if this named object is valid in the entire cluster
startEIDevent EID to start the named object from
Returns
the nNamedObject created
Exceptions
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nSessionPausedExceptionThe session is currently paused, please resume
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nSessionNotConnectedExceptionThe session is not currently connected to the server
nNameAlreadyBoundExceptionIf the name is already in use
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
Deprecated:
9.12 use nDurableManager.add(nDurableAttributes attr);

Deletes a join between this channel and the channel referenced in the destination parameter.

Parameters
destinationThis is an nChannel object referencing the destination channel
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRealmNotFoundExceptionThe remote realm could not be found
nSessionPausedExceptionThe session is currently paused
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.

Deletes a join between this channel and the queue referenced in the destination parameter.

Parameters
destinationThis is an nQueue object referencing the destination queue
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the queue no longer exists
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRealmNotFoundExceptionThe remote realm could not be found
nSessionPausedExceptionThe session is currently paused
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.

Removes all references for this name on the realm Server.

Parameters
namethe name to be removed from the server
Exceptions
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nSecurityExceptionis thrown if the caller has insufficient permissions
nSessionPausedExceptionThe session is currently paused, please resume
nChannelNotFoundExceptionif the channel no longer exists
nSessionNotConnectedExceptionThe session is not currently connected to the server
nNameDoesNotExistExceptionThe name specified does not exist on the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
Deprecated:
9.12 use nDurableManager.delete(nDurable name);

Removes all references for this name on the realm Server.

Parameters
namethe name to be removed from the server
Exceptions
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nSessionNotConnectedExceptionThe session is not currently connected to the server
nSessionPausedExceptionThe session is currently paused, please resume
nNameDoesNotExistExceptionThe name specified does not exist on the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
Deprecated:
since 9.12
See Also
nDurable
nChannelAttributes com.pcbsys.nirvana.client.nChannel.getChannelAttributes ( )

Gets the channels local attributes.

Returns
The associated nChannelAttributes object specifying the channel attributes
nClientChannelList com.pcbsys.nirvana.client.nChannel.getChannelList ( )
protected

Gets channel list.

Returns
the channel list
nDurableManager com.pcbsys.nirvana.client.nChannel.getDurableManager ( )

Gets durable manager.

Returns
the durable manager for channel.

Gets the number of events on this channel.

Returns
a long specifying the number of events on this channel
Exceptions
nChannelNotFoundExceptionthe n channel not found exception
nSecurityExceptionthe n security exception
nSessionNotConnectedExceptionthe n session not connected exception
nRequestTimedOutExceptionthe n request timed out exception
nSessionPausedExceptionthe n session paused exception
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.

Returns an array of nJoinInformation objects which describe the links this channel has configured for it.

Returns
array of nJoinInformation objects
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRealmNotFoundExceptionThe remote realm could not be found
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.

Gets the last event id of this channel.

Returns
a long specifying the last event id of this channel
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nSessionNotConnectedExceptionThe session is not currently connected to the server
nSessionPausedExceptionThe session is currently paused
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.

Gets the last event id of this channel.

Returns
a long specifying the last event id stored on this channel
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nSessionNotConnectedExceptionThe session is not currently connected to the server
nSessionPausedExceptionThe session is currently paused
nRequestTimedOutExceptionif the request exceeded the timeout value
String com.pcbsys.nirvana.client.nChannel.getName ( )

Gets the name of this channel.

Returns
a string specifying the name of this channel

Returns an instance of the nNamedObject referenced by the parameter.

Parameters
nameof the nNamedObject
Returns
nNamedObject named object
Exceptions
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nSessionPausedExceptionThe session is currently paused, please resume
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nSessionNotConnectedExceptionThe session is not currently connected to the server
nNameDoesNotExistExceptionThe name specified does not exist on the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
Deprecated:
9.12 use nDurableManager.get(String name);

Returns an array of all known nNamedObjects registered with this channel.

Returns
nNamedObject[] named objects
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nSessionPausedExceptionThe session is currently paused, please resume
nChannelNotFoundExceptionif the channel no longer exists
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
Deprecated:
9.12 use nDurableManager.getAll()

Returns an instance of the nExclusiveDurableImpl referenced by the parameter if and only if it is a nExclusiveDurableImpl.

Parameters
nameof the nNamedObject
Returns
nNamedObject shared named object
Exceptions
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nSessionPausedExceptionThe session is currently paused, please resume
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nSessionNotConnectedExceptionThe session is not currently connected to the server
nNameDoesNotExistExceptionThe name specified does not exist on the server or if the name is referring to a non shared Named Object
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
Deprecated:
9.12 use nDurableManager.get(String name);
int com.pcbsys.nirvana.client.nChannel.getType ( )

Gets the type of this channel Currently supported types are:

nChanneAttributes.MIXED_TYPE
nChanneAttributes.SIMPLE_TYPE
nChanneAttributes.PERSISTENT_TYPE
nChanneAttributes.RELIABLE_TYPE
nChanneAttributes.TRANSIENT_TYPE
nChanneAttributes.OFF_HEAP_TYPE
nChanneAttributes.PAGED_TYPE

Returns
an int specifying the channel's type, which will be equal to one of : nChanneAttributes.MIXED_TYPE, nChanneAttributes.SIMPLE_TYPE, nChanneAttributes.PERSISTENT_TYPE, nChanneAttributes.RELIABLE_TYPE, nChanneAttributes.TRANSIENT_TYPE, nChanneAttributes.OFF_HEAP_TYPE, nChanneAttributes.PAGED_TYPE
See Also
nChannelAttributes
boolean com.pcbsys.nirvana.client.nChannel.isSubscribed ( )

Determines whether the underlying channel is currently being subscribed to.

Returns
true if the channel object is currently subscribed to

Sets a server based link between this channel and the channel defined within the provided nChannel.

The link has a filter applied to it, defined by the provided selector string

Parameters
desta nChannel object defining the channel to be joined (linked) to this channel
selectorA string defining a filter that will be applied in the join (link) of these 2 channels
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRealmNotFoundExceptionThe remote realm could not be found
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nSelectorParserExceptionThe selector has syntax errors
nDuplicateJoinExceptionThe join already exists on the server
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.

Sets a server based link between this channel and the channel defined within the provided nChannel.

Parameters
desta nChannel object defining the channel to be joined (linked) to this channel
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRealmNotFoundExceptionThe remote realm could not be found
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nDuplicateJoinExceptionThe join already exists on the server
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.

Sets a server based link between this channel and the channel defined within the provided nChannel.

Additional parameters specify whether the event is routable or not, the maximum number of hops the event can pass through and the filter applied to the join (link).

Parameters
desta nChannel object defining the channel to be joined (linked) to this channel
isRouteda boolean flag specifying whether the event will be routed or not
hopCountan int specifying the maximum number of hops the event can pass through
selectorA string defining a filter that will be applied in the join (link) of these 2 channels
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRealmNotFoundExceptionThe remote realm could not be found
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nSelectorParserExceptionThe selector has syntax errors
nDuplicateJoinExceptionThe join already exists on the server
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
void com.pcbsys.nirvana.client.nChannel.joinChannel ( nChannel  dest,
boolean  isRouted,
int  hopCount,
String  selector,
boolean  allowPurge 
) throws nSecurityException, nChannelNotFoundException, nSessionPausedException, nSessionNotConnectedException, nRealmNotFoundException, nRequestTimedOutException, nUnexpectedResponseException, nSelectorParserException, nDuplicateJoinException, nIllegalArgumentException

Sets a server based link between this channel and the channel defined within the provided nChannel.

Additional parameters specify whether the event is routable or not, the maximum number of hops the event can pass through and the filter applied to the join (link).

Parameters
desta nChannel object defining the channel to be joined (linked) to this channel
isRouteda boolean flag specifying whether the event will be routed or not
hopCountan int specifying the maximum number of hops the event can pass through
selectorA string defining a filter that will be applied in the join (link) of these 2 channels
allowPurgeif allow purge is true then when the source channel is purged events source from it will also be purged
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRealmNotFoundExceptionThe remote realm could not be found
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nSelectorParserExceptionThe selector has syntax errors
nDuplicateJoinExceptionThe join already exists on the server
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.

Sets a server based link between this channel and the queue defined by the dest parameter.

Additional parameter specifies the filter applied to the join (link).

Parameters
desta nQueue object defining the queue to be joined (linked) to this channel
selectorA string defining a filter that will be applied in the join (link) from the source channel
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRealmNotFoundExceptionThe remote realm could not be found
nSessionPausedExceptionThe session is currently paused
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nSelectorParserExceptionThe selector has syntax errors
nDuplicateJoinExceptionThe join already exists on the server
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.

Sets a server based link between this channel and the queue defined within the provided nQueue.

The link has a filter applied to it, defined by the provided selector string

Parameters
desta nQueue object defining the queue to be joined (linked) to this channel
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRealmNotFoundExceptionThe remote realm could not be found
nSessionPausedExceptionThe session is currently paused
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nDuplicateJoinExceptionThe join already exists on the server
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.

Sets a server based link between this channel and the queue defined within the provided nQueue.

Additional parameters specify whether the event is routable or not, the maximum number of hops the event can pass through and the filter applied to the join (link).

Parameters
desta nQueue object defining the queue to be joined (linked) to this channel
isRouteda boolean flag specifying whether the event will be routed or not
hopCountan int specifying the maximum number of hops the event can pass through
selectorA string defining a filter that will be applied in the join (link) from the source channel
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRealmNotFoundExceptionThe remote realm could not be found
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nSelectorParserExceptionThe selector has syntax errors
nDuplicateJoinExceptionThe join already exists on the server
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.

Sets a server based link between this channel and the queue defined within the provided nQueue.

Events will NOT be checked for duplicates since this is an archive join, any events that are published to the source will appear in the destination queue. This may result in duplicate events in the queue if the queue has multiple sources. This is by design.

Parameters
desta nQueue object defining the queue to be joined (linked) to this channel
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRealmNotFoundExceptionThe remote realm could not be found
nSessionPausedExceptionThe session is currently paused
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nDuplicateJoinExceptionThe join already exists on the server
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.

Sets a server based link between this channel and the queue defined within the provided nQueue.

The link has a filter applied to it, defined by the provided selector string.Events will NOT be checked for duplicates since this is an archive join, any events that are published to the source will appear in the destination queue. This may result in duplicate events in the queue if the queue has multiple sources. This is by design.

Parameters
desta nQueue object defining the queue to be joined (linked) to this channel
selectorA string defining a filter that will be applied in the join (link) from the source channel
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRealmNotFoundExceptionThe remote realm could not be found
nSessionPausedExceptionThe session is currently paused
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nDuplicateJoinExceptionThe join already exists on the server
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
void com.pcbsys.nirvana.client.nChannel.publish ( String  tag,
Document  adom 
) throws nSessionNotConnectedException, nSessionPausedException, nIllegalArgumentException, nSecurityException, nMaxBufferSizeExceededException

Publishes the specified XML DOM document to this channel with the specified tag.

Parameters
taga string specifying the event tag to be used
adoman XML DOM document object specifying the XML document to be published to this channel
Exceptions
nSessionNotConnectedExceptionThe session is not currently connected to the server
nSessionPausedExceptionThe session is currently paused
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nSecurityExceptionis thrown if the caller has insufficient permissions
nMaxBufferSizeExceededExceptionis thrown when elements of the document being sent exceed the connection's max buffer size
Deprecated:
XML based documents are deprecated as of version 10.2
void com.pcbsys.nirvana.client.nChannel.publish ( nConsumeEvent  e) throws nSessionNotConnectedException, nSessionPausedException, nIllegalArgumentException, nSecurityException, nMaxBufferSizeExceededException

Publishes the specified nConsumeEvent to this channel.

Parameters
ethe nConsumeEvent object to be published to this channel
Exceptions
nSessionNotConnectedExceptionThe session is not currently connected to the server
nSessionPausedExceptionThe session is currently paused
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nSecurityExceptionis thrown if the caller has insufficient permissions
nMaxBufferSizeExceededExceptionis thrown when elements of the event being sent exceed the connection's max buffer size
void com.pcbsys.nirvana.client.nChannel.publish ( String  tag,
Document  adom,
nMessageSigner  signer 
) throws nSessionNotConnectedException, nSessionPausedException, nIllegalArgumentException, nSecurityException, nMaxBufferSizeExceededException

Publishes the specified XML DOM document to this channel with the specified tag.

Parameters
taga string specifying the event tag to be used
adoman XML DOM document object specifying the XML document to be published to this channel
signerEvent Signer class to use to sign the event
Exceptions
nSessionNotConnectedExceptionThe session is not currently connected to the server
nSessionPausedExceptionThe session is currently paused
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nSecurityExceptionis thrown if the caller has insufficient permissions
nMaxBufferSizeExceededExceptionis thrown when elements of the document being sent exceed the connection's max buffer size
Deprecated:
XML based documents are deprecated as of version 10.2
void com.pcbsys.nirvana.client.nChannel.publish ( nConsumeEvent  e,
nMessageSigner  signer 
) throws nSessionNotConnectedException, nSessionPausedException, nIllegalArgumentException, nSecurityException, nMaxBufferSizeExceededException

Publishes the specified nConsumeEvent to this channel.

Parameters
ethe nConsumeEvent object to be published to this channel
signerEvent Signer class to use to sign the event
Exceptions
nSessionNotConnectedExceptionThe session is not currently connected to the server
nSessionPausedExceptionThe session is currently paused
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nSecurityExceptionis thrown if the caller has insufficient permissions
nMaxBufferSizeExceededExceptionis thrown when elements of the event being sent exceed the connection's max buffer size

Purges a single event from this channel.

Parameters
eidvala long specifying the event id of the event to be purged from the channel
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.

Purges a single event from this channel.

Parameters
eidvala long specifying the event id of the event to be purged from the channel
purgeJoinsa boolean specifying if the event will be removed from all subsequent joins
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.

Purges a single event from this channel and does not wait for the response from the server.

Parameters
eidvala long specifying the event id of the event to be purged from the channel
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
void com.pcbsys.nirvana.client.nChannel.purgeEventAsync ( long  eidval,
boolean  purgeJoins 
) throws nSecurityException, nChannelNotFoundException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nIllegalArgumentException

Purges a single event from this channel and does not wait for the response from the server.

Parameters
eidvala long specifying the event id of the event to be purged from the channel
purgeJoinsa boolean specifying if the event will be removed from all subsequent joins
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
void com.pcbsys.nirvana.client.nChannel.purgeEvents ( long  startEID,
long  endEID,
boolean  purgeJoins 
) throws nSecurityException, nChannelNotFoundException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nIllegalArgumentException

Purges a range of events (first to last, all inclusive) from this channel.

Parameters
startEIDa long specifying the event id of the first event to be purged from the channel
endEIDa long specifying the event id of the last event to be purged from the channel
purgeJoinsa boolean specifying if the events will be removed from all subsequent joins
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.

Purges a range of events from this channel.

Parameters
startEIDa long specifying the start event id of the range of events to be purged from the channel
endEIDa long specifying the end event id of the range of events to be purged from the channel
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
void com.pcbsys.nirvana.client.nChannel.purgeEvents ( long  startEID,
long  endEID,
String  selector 
) throws nSecurityException, nChannelNotFoundException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nIllegalArgumentException

Purges a range of events from this channel.

Parameters
startEIDa long specifying the start event id of the range of events to be purged from the channel
endEIDa long specifying the end event id of the range of events to be purged from the channel
selectorA messages selector which will be used to filter out only the events which match this criteria
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
void com.pcbsys.nirvana.client.nChannel.purgeEvents ( long  startEID,
long  endEID,
String  selector,
boolean  purgeJoins 
) throws nSecurityException, nChannelNotFoundException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nIllegalArgumentException

Purges a range of events from this channel.

Parameters
startEIDa long specifying the start event id of the range of events to be purged from the channel
endEIDa long specifying the end event id of the range of events to be purged from the channel
selectorA messages selector which will be used to filter out only the events which match this criteria
purgeJoinsa boolean specifying if the events will be removed from all subsequent joins
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.

Purges a range of events from this channel and does not wait for the response from the server.

Parameters
startEIDa long specifying the start event id of the range of events to be purged from the channel
endEIDa long specifying the end event id of the range of events to be purged from the channel
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
void com.pcbsys.nirvana.client.nChannel.purgeEventsAsync ( long  startEID,
long  endEID,
boolean  purgeJoins 
) throws nSecurityException, nChannelNotFoundException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nIllegalArgumentException

Purges a range of events from this channel and does not wait for the response from the server.

Parameters
startEIDa long specifying the start event id of the range of events to be purged from the channel
endEIDa long specifying the end event id of the range of events to be purged from the channel
purgeJoinsa boolean specifying if the events will be removed from all subsequent joins
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
void com.pcbsys.nirvana.client.nChannel.purgeEventsAsync ( long  startEID,
long  endEID,
String  selector 
) throws nSecurityException, nChannelNotFoundException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nIllegalArgumentException

Purges a range of events from this channel and does not wait for the response from the server.

Parameters
startEIDa long specifying the start event id of the range of events to be purged from the channel
endEIDa long specifying the end event id of the range of events to be purged from the channel
selectorA messages selector which will be used to filter out only the events which match this criteria
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
void com.pcbsys.nirvana.client.nChannel.purgeEventsAsync ( long  startEID,
long  endEID,
String  selector,
boolean  purgeJoins 
) throws nSecurityException, nChannelNotFoundException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException, nIllegalArgumentException

Purges a range of events from this channel and does not wait for the response from the server.

Parameters
startEIDa long specifying the start event id of the range of events to be purged from the channel
endEIDa long specifying the end event id of the range of events to be purged from the channel
selectorA messages selector which will be used to filter out only the events which match this criteria
purgeJoinsa boolean specifying if the event will be removed from all subsequent joins
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
void com.pcbsys.nirvana.client.nChannel.removeConnectionListener ( ) throws nSessionNotConnectedException, nSessionPausedException, nRequestTimedOutException, nUnexpectedResponseException

Removes the connection listener to this channel.

Exceptions
nSessionNotConnectedExceptionThe session is not currently connected to the server
nSessionPausedExceptionThe session is currently paused, please resume
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
void com.pcbsys.nirvana.client.nChannel.removeConnectionListener ( nChannelConnectionListener  listener) throws nSessionNotConnectedException, nSessionPausedException, nRequestTimedOutException, nUnexpectedResponseException

Removes the connection listener to this channel.

Parameters
listenerremove the listener
Exceptions
nSessionNotConnectedExceptionThe session is not currently connected to the server
nSessionPausedExceptionThe session is currently paused, please resume
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information

Unregisters the specified nEventListener as a subscriber from this channel.

The subscriber will not receive any more events.

Parameters
nelthe nEventListener object to be registered as a subscriber
Exceptions
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nSessionPausedExceptionThe session is currently paused, please resume
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
void com.pcbsys.nirvana.client.nChannel.removeSubscriber ( nEventListener  nel,
boolean  wait 
) throws nIllegalArgumentException, nSessionPausedException, nSessionNotConnectedException, nRequestTimedOutException, nUnexpectedResponseException

Unregisters the specified nEventListener as a subscriber from this channel.

The subscriber will not receive any more events.

Parameters
nelthe nEventListener object to be registered as a subscriber
waitwhether to perform the remove synchronously
Exceptions
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nSessionPausedExceptionThe session is currently paused, please resume
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information

Removes the current subscriber and re-registers the nEventListener as a subscriber to this channel.

The subscriber will receive all events on the channel apart from the ones restricted by the specified filter.

Parameters
selectora string specifying a filter to this subscription request
Exceptions
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nChannelAlreadySubscribedExceptionA subscriber is already registered with this channel on this session
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information

Removes the current subscriber and registers the specified nEventListener as a subscriber to this channel.

The subscriber will receive all events with event id greater than or equal to the one specified

Parameters
eida long specifying the subscription's start eid
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nChannelAlreadySubscribedExceptionA subscriber is already registered with this channel on this session
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nSelectorParserExceptionThe selector has syntax errors
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.

Removes the current subscriber and re-registers the nEventListener as a subscriber to this channel.

The subscriber will receive all events with event id greater than or equal to the one specified, apart from the ones restricted by the specified filter.

Parameters
selectora string specifying a filter to this subscription request
eida long specifying the subscription's start eid
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nChannelAlreadySubscribedExceptionA subscriber is already registered with this channel on this session
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nSelectorParserExceptionThe selector has syntax errors
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.

Removes the current subscriber and registers the specified nEventListener as a named subscriber to this channel.

The subscriber will receive all events from the last acknowledged event for the name supplied If the name is new it will start from the END of the channel.

Parameters
durablea named object for this subscription
selectora string specifying a filter to this subscription request
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nChannelAlreadySubscribedExceptionA subscriber is already registered with this channel on this session
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nNameDoesNotExistExceptionif the server does not know about the named object
nSelectorParserExceptionThe selector has syntax errors
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nNameAlreadyBoundExceptionThe name is already bound and used by another client
Since
9.12

Removes the current subscriber and registers the specified nEventListener as a named subscriber to this channel.

The subscriber will receive all events from the last acknowledged event for the name supplied If the name is new it will start from the END of the channel.

Parameters
namea named object for this subscription
selectora string specifying a filter to this subscription request
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nChannelAlreadySubscribedExceptionA subscriber is already registered with this channel on this session
nSessionPausedExceptionThe session is currently paused
nSessionNotConnectedExceptionThe session is not currently connected to the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
nNameDoesNotExistExceptionif the server does not know about the named object
nSelectorParserExceptionThe selector has syntax errors
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nNameAlreadyBoundExceptionThe name is already bound and used by another client
Deprecated:
9.12 Use the reSubscribe(nDurable, String)

Unbinds the named object from the current connection.

Parameters
namethe name to be unbound
Exceptions
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nSecurityExceptionis thrown if the caller has insufficient permissions
nSessionPausedExceptionThe session is currently paused, please resume
nChannelNotFoundExceptionif the channel no longer exists
nSessionNotConnectedExceptionThe session is not currently connected to the server
nNameDoesNotExistExceptionThe name specified does not exist on the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
Deprecated:
9.12 use nDurableManager.unbind(nDurable name);

Unbinds the named object from the current connection.

Parameters
namethe named object to be unbound
Exceptions
nIllegalArgumentExceptionThis exception is raised if there is any issues with any of the arguments used by this method. One condition of this is if this object has been invalidated and no longer can be utilised, this can occur if a delete request has been issued to the connected server.
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nSessionNotConnectedExceptionThe session is not currently connected to the server
nSessionPausedExceptionThe session is currently paused, please resume
nNameDoesNotExistExceptionThe name specified does not exist on the server
nRequestTimedOutExceptionif the request exceeded the timeout value
nUnexpectedResponseExceptionReceived a response from the server for which we can not deal with, see the message for further information
Deprecated:
since 9.12
See Also
nDurable