com.pcbsys.nirvana.client.nChannelIterator Class Reference

This class iterates synchronously over a Nirvana Realm channel. More...

Public Member Functions

void ack (long eid) throws nSecurityException, nChannelNotFoundException, nSessionNotConnectedException, nSessionPausedException, nRequestTimedOutException, nRealmNotFoundException, nUnexpectedResponseException, nSelectorParserException
 Acknowledge an event id consumed by this iterator when not using auto ack. More...
 
synchronized void close ()
 This method will initiate a close to the server for this Iterator. More...
 
nConsumeEvent getFirst () throws nSecurityException, nChannelNotFoundException, nSessionNotConnectedException, nSessionPausedException, nRequestTimedOutException, nRealmNotFoundException, nUnexpectedResponseException, nSelectorParserException
 This returns the first event in the channel or null if there are no events in the channel. More...
 
nConsumeEvent getLast () throws nSecurityException, nChannelNotFoundException, nSessionNotConnectedException, nSessionPausedException, nRequestTimedOutException, nRealmNotFoundException, nUnexpectedResponseException, nSelectorParserException
 This returns the last event in the channel or null if there are no events in the channel. More...
 
nConsumeEvent getNext () throws nSecurityException, nChannelNotFoundException, nSessionNotConnectedException, nSessionPausedException, nRealmNotFoundException, nUnexpectedResponseException, nSelectorParserException
 Returns the next event in the channel, or will block until an event is published. More...
 
nConsumeEvent getNext (long timeout) throws nSecurityException, nChannelNotFoundException, nSessionNotConnectedException, nSessionPausedException, nRequestTimedOutException, nRealmNotFoundException, nUnexpectedResponseException, nSelectorParserException
 Returns the next event in the channel, or if none will block for the time in milliseconds for the next event to be published onto the channel. More...
 
nConsumeEvent getPrev () throws nSecurityException, nChannelNotFoundException, nSessionNotConnectedException, nSessionPausedException, nRequestTimedOutException, nRealmNotFoundException, nUnexpectedResponseException, nSelectorParserException
 Gets the previous event in the channel or null if there are no more previous events. More...
 
boolean isAutoAck ()
 Whether this iterator is set to auto acknowledge. More...
 
void rollback () throws nRequestTimedOutException, nSessionPausedException, nSessionNotConnectedException
 If this is a shared named object, this method can be used to push any consumed messages back onto the resource on the server, ready for re-consumption. More...
 

Detailed Description

This class iterates synchronously over a Nirvana Realm channel.

By using the methods the channel can be traversed forwards/backwards

Member Function Documentation

synchronized void com.pcbsys.nirvana.client.nChannelIterator.close ( )

This method will initiate a close to the server for this Iterator.

Since
4.0

This returns the first event in the channel or null if there are no events in the channel.

Returns
a nConsumeEvent or null
Exceptions
nSecurityExceptionIf the client does not have the ability to subscribe to the channel
nChannelNotFoundExceptionThe channel is no longer valid
nSessionNotConnectedExceptionThe session has been disconnected
nRequestTimedOutExceptionif the time out for the event to be published is exceeded
nUnexpectedResponseExceptionUnknown response from server. Please contact support
nSessionPausedExceptionThe session is currently paused, please resume
nSelectorParserExceptionInvalid selector specified
nRealmNotFoundExceptionThe remote realm could not be found

This returns the last event in the channel or null if there are no events in the channel.

Returns
a nConsumeEvent or null
Exceptions
nSecurityExceptionIf the client does not have the ability to subscribe to the channel
nChannelNotFoundExceptionThe channel is no longer valid
nSessionNotConnectedExceptionThe session has been disconnected
nRequestTimedOutExceptionif the time out for the event to be published is exceeded
nUnexpectedResponseExceptionUnknown response from server. Please contact support
nSessionPausedExceptionThe session is currently paused, please resume
nSelectorParserExceptionInvalid selector specified
nRealmNotFoundExceptionThe remote realm could not be found

Returns the next event in the channel, or will block until an event is published.

Returns
a nConsumeEvent
Exceptions
nSecurityExceptionIf the client does not have the ability to subscribe to the channel
nChannelNotFoundExceptionThe channel is no longer valid
nSessionNotConnectedExceptionThe session has been disconnected
nUnexpectedResponseExceptionUnknown response from server. Please contact support
nSessionPausedExceptionThe session is currently paused, please resume
nSelectorParserExceptionInvalid selector specified
nRealmNotFoundExceptionThe remote realm could not be found

Returns the next event in the channel, or if none will block for the time in milliseconds for the next event to be published onto the channel.

Parameters
timeouttime in milliseconds to wait for the event
Returns
a nConsumeEvent
Exceptions
nSecurityExceptionIf the client does not have the ability to subscribe to the channel
nChannelNotFoundExceptionThe channel is no longer valid
nSessionNotConnectedExceptionThe session has been disconnected
nRequestTimedOutExceptionif the time out for the event to be published is exceeded
nUnexpectedResponseExceptionUnknown response from server. Please contact support
nSessionPausedExceptionThe session is currently paused, please resume
nSelectorParserExceptionInvalid selector specified
nRealmNotFoundExceptionThe remote realm could not be found

Gets the previous event in the channel or null if there are no more previous events.

Returns
a nConsumeEvent or null
Exceptions
nSecurityExceptionIf the client does not have the ability to subscribe to the channel
nChannelNotFoundExceptionThe channel is no longer valid
nSessionNotConnectedExceptionThe session has been disconnected
nRequestTimedOutExceptionif the time out for the event to be published is exceeded
nUnexpectedResponseExceptionUnknown response from server. Please contact support
nSessionPausedExceptionThe session is currently paused, please resume
nSelectorParserExceptionInvalid selector specified
nRealmNotFoundExceptionThe remote realm could not be found
boolean com.pcbsys.nirvana.client.nChannelIterator.isAutoAck ( )

Whether this iterator is set to auto acknowledge.

Returns
true if auto acknowledge
void com.pcbsys.nirvana.client.nChannelIterator.rollback ( ) throws nRequestTimedOutException, nSessionPausedException, nSessionNotConnectedException

If this is a shared named object, this method can be used to push any consumed messages back onto the resource on the server, ready for re-consumption.

Exceptions
nRequestTimedOutException
nSessionPausedException
nSessionNotConnectedException