Package org.objectweb.joram.client.jms

Class XASession

java.lang.Object

org.objectweb.joram.client.jms.XASession

All Implemented Interfaces:

AutoCloseable, Runnable, Session, XASession

Direct Known Subclasses:

XAQueueSession, XATopicSession

public class XASession
extends Object
implements XASession

Implements the javax.jms.XASession interface.

An XA session actually extends the behaviour of a normal session by providing an XA resource representing it to a Transaction Manager, so that it is part of a distributed transaction. The XASession wraps what looks like a "normal" Session object. This object takes care of producing and consuming messages, the actual sendings and acknowledgement being managed by this XA wrapper.

This class offers support to transactional environments. Client programs are strongly encouraged to use the transactional support available in their environment, rather than use these XA interfaces directly.

Field Summary

Fields

Modifier and Type	Field	Description
protected Session	sess
private XAResource	xaResource	The XA resource representing the session to the transaction manager.

Fields inherited from interface javax.jms.Session

AUTO_ACKNOWLEDGE, CLIENT_ACKNOWLEDGE, DUPS_OK_ACKNOWLEDGE, SESSION_TRANSACTED

Constructor Summary

Constructors

Constructor	Description
XASession(Connection cnx, Session sess, XAResourceMngr rm)	Constructs an XASession.

Method Summary

Modifier and Type	Method	Description
void	close()	API method.
void	commit()	API method inherited from session, but intercepted here for forbidding its use in the XA context (as defined by the API).
QueueBrowser	createBrowser(Queue queue)	Delegates the call to the wrapped JMS session.
QueueBrowser	createBrowser(Queue queue, String selector)	Delegates the call to the wrapped JMS session.
BytesMessage	createBytesMessage()	Delegates the call to the wrapped JMS session.
MessageConsumer	createConsumer(Destination dest)	Delegates the call to the wrapped JMS session.
MessageConsumer	createConsumer(Destination dest, String selector)	Delegates the call to the wrapped JMS session.
MessageConsumer	createConsumer(Destination dest, String selector, boolean noLocal)	Delegates the call to the wrapped JMS session.
MessageConsumer	createDurableConsumer(Topic topic, String name)	Delegates the call to the wrapped JMS session.
MessageConsumer	createDurableConsumer(Topic topic, String name, String messageSelector, boolean noLocal)	Delegates the call to the wrapped JMS session.
TopicSubscriber	createDurableSubscriber(Topic topic, String name)	Delegates the call to the wrapped JMS session.
TopicSubscriber	createDurableSubscriber(Topic topic, String name, String selector, boolean noLocal)	Delegates the call to the wrapped JMS session.
MapMessage	createMapMessage()	Delegates the call to the wrapped JMS session.
Message	createMessage()	Delegates the call to the wrapped JMS session.
ObjectMessage	createObjectMessage()	Delegates the call to the wrapped JMS session.
ObjectMessage	createObjectMessage(Serializable obj)	Delegates the call to the wrapped JMS session.
MessageProducer	createProducer(Destination dest)	Delegates the call to the wrapped JMS session.
Queue	createQueue(String queueName)	Delegates the call to the wrapped JMS session.
MessageConsumer	createSharedConsumer(Topic topic, String sharedSubscriptionName)	Delegates the call to the wrapped JMS session.
MessageConsumer	createSharedConsumer(Topic topic, String sharedSubscriptionName, String messageSelector)	Delegates the call to the wrapped JMS session.
MessageConsumer	createSharedDurableConsumer(Topic topic, String name)	Delegates the call to the wrapped JMS session.
MessageConsumer	createSharedDurableConsumer(Topic topic, String name, String messageSelector)	Delegates the call to the wrapped JMS session.
StreamMessage	createStreamMessage()	Delegates the call to the wrapped JMS session.
TemporaryQueue	createTemporaryQueue()	Delegates the call to the wrapped JMS session.
TemporaryTopic	createTemporaryTopic()	Delegates the call to the wrapped JMS session.
TextMessage	createTextMessage()	Delegates the call to the wrapped JMS session.
TextMessage	createTextMessage(String text)	Delegates the call to the wrapped JMS session.
Topic	createTopic(String topicName)	Delegates the call to the wrapped JMS session.
int	getAcknowledgeMode()	Delegates the call to the wrapped JMS session.
Session	getDelegateSession()
MessageListener	getMessageListener()	Delegates the call to the wrapped JMS session.
Session	getSession()	API method.
boolean	getTransacted()	API method.
XAResource	getXAResource()	API method.
void	recover()	API method inherited from session, but intercepted here for forbidding its use in the XA context (as defined by the API).
void	rollback()	API method inherited from session, but intercepted here for forbidding its use in the XA context (as defined by the API).
void	run()	Delegates the call to the wrapped JMS session.
void	setMessageListener(MessageListener messageListener)	Delegates the call to the wrapped JMS session.
String	toString()	Returns a String image of this session.
void	unsubscribe(String name)	Delegates the call to the wrapped JMS session.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

xaResource

private XAResource xaResource

The XA resource representing the session to the transaction manager.

sess

protected Session sess

Constructor Detail

XASession

public XASession(Connection cnx,
                 Session sess,
                 XAResourceMngr rm)
          throws JMSException

Constructs an XASession.

This constructor is called by subclasses.

Parameters:

cnx - The connection the session belongs to.

sess - The wrapped "regular" session.

rm - The resource manager.

Throws:

JMSException - Actually never thrown.

Method Detail

getDelegateSession

public final Session getDelegateSession()

toString

public String toString()

Returns a String image of this session.

Overrides:

toString in class Object

getSession

public Session getSession()
                   throws JMSException

API method. Gets the session associated with this XASession.

Specified by:

getSession in interface XASession

Returns:

the session object.

Throws:

IllegalStateException - If the session is closed.

JMSException

getXAResource

public XAResource getXAResource()

API method. Returns an XA resource to the caller.

Specified by:

getXAResource in interface XASession

Returns:

an XA resource.

getTransacted

public boolean getTransacted()
                      throws JMSException

API method. Indicates whether the session is in transacted mode.

Specified by:

getTransacted in interface Session

Specified by:

getTransacted in interface XASession

Returns:

true

Throws:

IllegalStateException - If the session is closed.

JMSException

createBrowser

public QueueBrowser createBrowser(Queue queue,
                                  String selector)
                           throws JMSException

Delegates the call to the wrapped JMS session.

Specified by:

createBrowser in interface Session

Throws:

JMSException

createBrowser

public QueueBrowser createBrowser(Queue queue)
                           throws JMSException

Delegates the call to the wrapped JMS session.

Specified by:

createBrowser in interface Session

Throws:

JMSException

createProducer

public MessageProducer createProducer(Destination dest)
                               throws JMSException

Delegates the call to the wrapped JMS session.

Specified by:

createProducer in interface Session

Throws:

JMSException

createConsumer

public MessageConsumer createConsumer(Destination dest,
                                      String selector,
                                      boolean noLocal)
                               throws JMSException

Delegates the call to the wrapped JMS session.

Specified by:

createConsumer in interface Session

Throws:

JMSException

createConsumer

public MessageConsumer createConsumer(Destination dest,
                                      String selector)
                               throws JMSException

Delegates the call to the wrapped JMS session.

Specified by:

createConsumer in interface Session

Throws:

JMSException

createConsumer

public MessageConsumer createConsumer(Destination dest)
                               throws JMSException

Delegates the call to the wrapped JMS session.

Specified by:

createConsumer in interface Session

Throws:

JMSException

createDurableSubscriber

public TopicSubscriber createDurableSubscriber(Topic topic,
                                               String name,
                                               String selector,
                                               boolean noLocal)
                                        throws JMSException

Delegates the call to the wrapped JMS session.

Specified by:

createDurableSubscriber in interface Session

Throws:

JMSException

createDurableSubscriber

public TopicSubscriber createDurableSubscriber(Topic topic,
                                               String name)
                                        throws JMSException

Delegates the call to the wrapped JMS session.

Specified by:

createDurableSubscriber in interface Session

Throws:

JMSException

commit

public void commit()
            throws JMSException

API method inherited from session, but intercepted here for forbidding its use in the XA context (as defined by the API).

Specified by:

commit in interface Session

Specified by:

commit in interface XASession

Throws:

IllegalStateException - Systematically thrown.

JMSException

rollback

public void rollback()
              throws JMSException

API method inherited from session, but intercepted here for forbidding its use in the XA context (as defined by the API).

Specified by:

rollback in interface Session

Specified by:

rollback in interface XASession

Throws:

IllegalStateException - Systematically thrown.

JMSException

recover

public void recover()
             throws JMSException

API method inherited from session, but intercepted here for forbidding its use in the XA context (as defined by the API).

Specified by:

recover in interface Session

Throws:

IllegalStateException - Systematically thrown.

JMSException

close

public void close()
           throws JMSException

API method. Closes the session.

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Session

Throws:

JMSException - Actually never thrown.

See Also:

Session.close

run

public void run()

Delegates the call to the wrapped JMS session.

Specified by:

run in interface Runnable

Specified by:

run in interface Session

unsubscribe

public void unsubscribe(String name)
                 throws JMSException

Delegates the call to the wrapped JMS session.

Specified by:

unsubscribe in interface Session

Throws:

JMSException

createTemporaryQueue

public TemporaryQueue createTemporaryQueue()
                                    throws JMSException

Delegates the call to the wrapped JMS session.

Specified by:

createTemporaryQueue in interface Session

Throws:

JMSException

createTemporaryTopic

public TemporaryTopic createTemporaryTopic()
                                    throws JMSException

Delegates the call to the wrapped JMS session.

Specified by:

createTemporaryTopic in interface Session

Throws:

JMSException

createTopic

public Topic createTopic(String topicName)
                  throws JMSException

Delegates the call to the wrapped JMS session.

Specified by:

createTopic in interface Session

Throws:

JMSException

createQueue

public Queue createQueue(String queueName)
                  throws JMSException

Delegates the call to the wrapped JMS session.

Specified by:

createQueue in interface Session

Throws:

JMSException

setMessageListener

public void setMessageListener(MessageListener messageListener)
                        throws JMSException

Delegates the call to the wrapped JMS session.

Specified by:

setMessageListener in interface Session

Throws:

JMSException

getMessageListener

public MessageListener getMessageListener()
                                   throws JMSException

Delegates the call to the wrapped JMS session.

Specified by:

getMessageListener in interface Session

Throws:

JMSException

getAcknowledgeMode

public int getAcknowledgeMode()
                       throws JMSException

Delegates the call to the wrapped JMS session.

Specified by:

getAcknowledgeMode in interface Session

Throws:

JMSException

createTextMessage

public TextMessage createTextMessage()
                              throws JMSException

Delegates the call to the wrapped JMS session.

Specified by:

createTextMessage in interface Session

Throws:

JMSException

createTextMessage

public TextMessage createTextMessage(String text)
                              throws JMSException

Delegates the call to the wrapped JMS session.

Specified by:

createTextMessage in interface Session

Throws:

JMSException

createStreamMessage

public StreamMessage createStreamMessage()
                                  throws JMSException

Delegates the call to the wrapped JMS session.

Specified by:

createStreamMessage in interface Session

Throws:

JMSException

createObjectMessage

public ObjectMessage createObjectMessage()
                                  throws JMSException

Delegates the call to the wrapped JMS session.

Specified by:

createObjectMessage in interface Session

Throws:

JMSException

createObjectMessage

public ObjectMessage createObjectMessage(Serializable obj)
                                  throws JMSException

Delegates the call to the wrapped JMS session.

Specified by:

createObjectMessage in interface Session

Throws:

JMSException

createMessage

public Message createMessage()
                      throws JMSException

Delegates the call to the wrapped JMS session.

Specified by:

createMessage in interface Session

Throws:

JMSException

createMapMessage

public MapMessage createMapMessage()
                            throws JMSException

Delegates the call to the wrapped JMS session.

Specified by:

createMapMessage in interface Session

Throws:

JMSException

createBytesMessage

public BytesMessage createBytesMessage()
                                throws JMSException

Delegates the call to the wrapped JMS session.

Specified by:

createBytesMessage in interface Session

Throws:

JMSException

createSharedConsumer

public MessageConsumer createSharedConsumer(Topic topic,
                                            String sharedSubscriptionName)
                                     throws JMSException

Delegates the call to the wrapped JMS session.

Specified by:

createSharedConsumer in interface Session

Throws:

JMSException

createSharedConsumer

public MessageConsumer createSharedConsumer(Topic topic,
                                            String sharedSubscriptionName,
                                            String messageSelector)
                                     throws JMSException

Delegates the call to the wrapped JMS session.

Specified by:

createSharedConsumer in interface Session

Throws:

JMSException

createDurableConsumer

public MessageConsumer createDurableConsumer(Topic topic,
                                             String name)
                                      throws JMSException

Delegates the call to the wrapped JMS session.

Specified by:

createDurableConsumer in interface Session

Throws:

JMSException

createDurableConsumer

public MessageConsumer createDurableConsumer(Topic topic,
                                             String name,
                                             String messageSelector,
                                             boolean noLocal)
                                      throws JMSException

Delegates the call to the wrapped JMS session.

Specified by:

createDurableConsumer in interface Session

Throws:

JMSException

createSharedDurableConsumer

public MessageConsumer createSharedDurableConsumer(Topic topic,
                                                   String name)
                                            throws JMSException

Delegates the call to the wrapped JMS session.

Specified by:

createSharedDurableConsumer in interface Session

Throws:

JMSException

createSharedDurableConsumer

public MessageConsumer createSharedDurableConsumer(Topic topic,
                                                   String name,
                                                   String messageSelector)
                                            throws JMSException

Delegates the call to the wrapped JMS session.

Specified by:

createSharedDurableConsumer in interface Session

Throws:

JMSException