com.solacesystems.jcsmpx.impl

Class TopicConsumerImpl

java.lang.Object

com.solacesystems.jcsmpx.impl.TopicConsumerImpl

All Implemented Interfaces:

Consumer, DestinationConsumer

public class TopicConsumerImpl
extends Object
implements DestinationConsumer

Constructor Summary

Constructors

Constructor and Description
TopicConsumerImpl(XMLMessageConsumer messageConsumer)

Method Summary

Modifier and Type	Method and Description
void	close() Closes the message consumer, rendering it unusable.
void	closeSync()
void	closeSync(boolean linger)
DestinationListener	getMessageDestinationListener() Gets the message consumer's message listener.
BytesXMLMessage	receive() Receives the next available message, waiting until one is available.
BytesXMLMessage	receive(int timeoutInMillis) Receives the next available message.
BytesXMLMessage	receiveNoWait() Receives the next available message.
void	start() Enables receiving messages from an appliance.
void	startSync()
void	stop() Disables receiving messages from an appliance.
void	stopSync()
boolean	stopSyncStart()
void	stopSyncWait()

Methods inherited from class java.lang.Object

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

Constructor Detail

TopicConsumerImpl

public TopicConsumerImpl(XMLMessageConsumer messageConsumer)
                  throws JCSMPException

Throws:

JCSMPException

Method Detail

close

public void close()

Description copied from interface: Consumer

Closes the message consumer, rendering it unusable.

Once closed, an application acquires a new instance in order to continue to receive messages.

New messages will not be processed and delivered after a call to close() returns, although it is possible for a single asynchronous message delivery to occur if it has already begun when close() is called.

Specified by:

close in interface Consumer

getMessageDestinationListener

public DestinationListener getMessageDestinationListener()

Description copied from interface: DestinationConsumer

Gets the message consumer's message listener.

Specified by:

getMessageDestinationListener in interface DestinationConsumer

Returns:

The message listener if set, null otherwise.

receive

public BytesXMLMessage receive()
                        throws JCSMPException

Description copied from interface: Consumer

Receives the next available message, waiting until one is available.

Specified by:

receive in interface Consumer

Returns:

The next available message, or null if it is interrupted.

Throws:

InvalidOperationException - If the consumer is not started, or a message listener is set.

JCSMPTransportException - If the consumer was closed after the function was called, but before any message was received.

JCSMPException

receive

public BytesXMLMessage receive(int timeoutInMillis)
                        throws JCSMPException

Description copied from interface: Consumer

Receives the next available message. If no message is available, this method blocks until timeoutInMillis is reached. A timeout of zero never expires, and the call blocks indefinitely.

Specified by:

receive in interface Consumer

Parameters:

timeoutInMillis - The timeout in milliseconds.

Returns:

The next available message, or null if the timeout expires.

Throws:

InvalidOperationException - If the consumer is not started, or a message listener is set.

JCSMPTransportException - If the consumer was closed after the method was called, but before any message was received.

JCSMPException

receiveNoWait

public BytesXMLMessage receiveNoWait()
                              throws JCSMPException

Description copied from interface: Consumer

Receives the next available message. If no message is available, this method returns null immediately.

Specified by:

receiveNoWait in interface Consumer

Returns:

The next available message, or null if one is not available.

Throws:

InvalidOperationException - If the consumer is not started, or a message listener is set.

JCSMPTransportException - If the consumer was closed after the function was called but before any message was received.

JCSMPException

start

public void start()
           throws JCSMPException

Description copied from interface: Consumer

Enables receiving messages from an appliance.

Specified by:

start in interface Consumer

Throws:

JCSMPException - upon error

InvalidOperationException - when called on a closed consumer.

stop

public void stop()

Description copied from interface: Consumer

Disables receiving messages from an appliance.

Note that there is no guarantee the effect of calling stop() will be instantaneous: messages already in-flight or being processed by the API may still be delivered after the call to stop() returns.

Specified by:

stop in interface Consumer

startSync

public void startSync()
               throws JCSMPException

Specified by:

startSync in interface Consumer

Throws:

JCSMPException - on error

stopSync

public void stopSync()
              throws JCSMPInterruptedException

Specified by:

stopSync in interface Consumer

Throws:

JCSMPInterruptedException

closeSync

public void closeSync()
               throws JCSMPException

Specified by:

closeSync in interface Consumer

Throws:

JCSMPException

closeSync

public void closeSync(boolean linger)
               throws JCSMPException

Specified by:

closeSync in interface Consumer

Throws:

JCSMPException

stopSyncStart

public boolean stopSyncStart()

Specified by:

stopSyncStart in interface Consumer

stopSyncWait

public void stopSyncWait()
                  throws JCSMPInterruptedException

Specified by:

stopSyncWait in interface Consumer

Throws:

JCSMPInterruptedException