com.pcbsys.nirvana.client.nDurableManager Class Reference

A Manager for the Durable Subscriptions on a channel. More...

Public Member Functions

nDurable add (nDurableAttributes attributes) 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...
 
void delete (nDurable name) throws nIllegalArgumentException, nSecurityException, nChannelNotFoundException, nSessionNotConnectedException, nSessionPausedException, nNameDoesNotExistException, nRequestTimedOutException, nUnexpectedResponseException
 Removes all references for this name on the realm Server. More...
 
nDurable get (String name) throws nIllegalArgumentException, nSessionPausedException, nSecurityException, nChannelNotFoundException, nSessionNotConnectedException, nNameDoesNotExistException, nRequestTimedOutException, nUnexpectedResponseException
 Returns an instance nDurable Object called by the string Name. More...
 
nDurable[] getAll () throws nIllegalArgumentException, nSessionPausedException, nSecurityException, nChannelNotFoundException, nSessionNotConnectedException, nNameDoesNotExistException, nRequestTimedOutException, nUnexpectedResponseException
 Returns all known nDurable objects known on this channel. More...
 
void unbind (nDurable name) throws nIllegalArgumentException, nSecurityException, nChannelNotFoundException, nSessionNotConnectedException, nSessionPausedException, nNameDoesNotExistException, nRequestTimedOutException, nUnexpectedResponseException
 Unbinds the named object from the current connection. More...
 

Detailed Description

A Manager for the Durable Subscriptions on a channel.

Member Function Documentation

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.

Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nRequestTimedOutExceptionif the request exceeded the timeout value
nSessionNotConnectedExceptionThe session is not currently connected to the server
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.
nSessionPausedExceptionThe session is currently paused, please resume

Removes all references for this name on the realm Server.

Parameters
namethe name to be removed from the server
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nRequestTimedOutExceptionif the request exceeded the timeout value
nSessionNotConnectedExceptionThe session is not currently connected to the server
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.
nNameDoesNotExistExceptionThe name specified does not exist on the server
nSessionPausedExceptionThe session is currently paused, please resume
Since
9.12

Returns an instance nDurable Object called by the string Name.

Parameters
nameof the nNamedObject
Returns
nDurable
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nRequestTimedOutExceptionif the request exceeded the timeout value
nSessionNotConnectedExceptionThe session is not currently connected to the server
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.
nNameDoesNotExistExceptionThe name specified does not exist on the server or if the name is referring to a non shared Named Object
nSessionPausedExceptionThe session is currently paused, please resume

Returns all known nDurable objects known on this channel.

Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nRequestTimedOutExceptionif the request exceeded the timeout value
nSessionNotConnectedExceptionThe session is not currently connected to the server
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.
nNameDoesNotExistExceptionThe name specified does not exist on the server or if the name is referring to a non shared Named Object
nSessionPausedExceptionThe session is currently paused, please resume

Unbinds the named object from the current connection.

Parameters
namethe named object to be unbound
Exceptions
nSecurityExceptionis thrown if the caller has insufficient permissions
nChannelNotFoundExceptionif the channel no longer exists
nRequestTimedOutExceptionif the request exceeded the timeout value
nSessionNotConnectedExceptionThe session is not currently connected to the server
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.
nNameDoesNotExistExceptionThe name specified does not exist on the server
nSessionPausedExceptionThe session is currently paused, please resume