com.solacesystems.jms

Class SolConnectionConsumerRA

java.lang.Object

com.solacesystems.jms.SolConnectionConsumerRA

All Implemented Interfaces:

SolCloseableIF, SolConnectionConsumerIF, SolStartableIF, ConnectionConsumer

public class SolConnectionConsumerRA
extends Object
implements SolConnectionConsumerIF

A specialized facility for application servers. The ConnectionConsumer gets a ServerSession and loads messages to it. Exceptions are dispatched to the connection for processing by its Exception listener.

Constructor Summary

Constructors

Constructor and Description
SolConnectionConsumerRA(SolConnectionIF conn, SolDestinationInfo destInfo, String messageSelector, ServerSessionPool serverPool, int maxMessages, JMSState state)

Method Summary

Modifier and Type	Method and Description
void	close() Closes the connection consumer.
void	commitBatch(Collection<Message> msgs)
AckHandler	getAckHandler()
ConnectionConsumerTransactionStrategy	getAckTransaction()
ServerSessionPool	getServerSessionPool() Gets the server session pool associated with this connection consumer.
void	rollbackBatch(Collection<Message> msgs)
void	start()
void	stop()
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

SolConnectionConsumerRA

public SolConnectionConsumerRA(SolConnectionIF conn,
                               SolDestinationInfo destInfo,
                               String messageSelector,
                               ServerSessionPool serverPool,
                               int maxMessages,
                               JMSState state)
                        throws JMSException

Throws:

JMSException

Method Detail

getServerSessionPool

public ServerSessionPool getServerSessionPool()
                                       throws JMSException

Description copied from interface: ConnectionConsumer

Gets the server session pool associated with this connection consumer.

Specified by:

getServerSessionPool in interface ConnectionConsumer

Returns:

the server session pool used by this connection consumer

Throws:

JMSException - if the JMS provider fails to get the server session pool associated with this consumer due to some internal error.

start

public void start()
           throws JMSException

Specified by:

start in interface SolStartableIF

Throws:

JMSException

stop

public void stop()
          throws JMSException

Specified by:

stop in interface SolStartableIF

Throws:

JMSException

close

public void close()
           throws JMSException

Description copied from interface: ConnectionConsumer

Closes the connection consumer.

Since a provider may allocate some resources on behalf of a connection consumer outside the Java virtual machine, clients should close these resources when they are not needed. Relying on garbage collection to eventually reclaim these resources may not be timely enough.

Specified by:

close in interface SolCloseableIF

Specified by:

close in interface ConnectionConsumer

Throws:

JMSException - if the JMS provider fails to release resources on behalf of the connection consumer or fails to close the connection consumer.

toString

public String toString()

Overrides:

toString in class Object

commitBatch

public void commitBatch(Collection<Message> msgs)
                 throws JMSException

Specified by:

commitBatch in interface SolConnectionConsumerIF

Throws:

JMSException

rollbackBatch

public void rollbackBatch(Collection<Message> msgs)
                   throws JMSException

Specified by:

rollbackBatch in interface SolConnectionConsumerIF

Throws:

JMSException

getAckHandler

public AckHandler getAckHandler()

getAckTransaction

public ConnectionConsumerTransactionStrategy getAckTransaction()