XASession (Joram ${version} Platform Documentation)

Overview

Package

Class

Tree

Deprecated

Index

Help

Joram ${version}

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.objectweb.joram.client.jms
Class XASession

java.lang.Object
  org.objectweb.joram.client.jms.XASession

All Implemented Interfaces:: java.lang.Runnable, javax.jms.Session, javax.jms.XASession

Direct Known Subclasses:: XAQueueSession, XATopicSession

public class XASession
extends java.lang.Object
implements javax.jms.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.

Field Summary
`protected Session`	`sess`

Fields inherited from interface javax.jms.Session

AUTO_ACKNOWLEDGE, CLIENT_ACKNOWLEDGE, DUPS_OK_ACKNOWLEDGE, SESSION_TRANSACTED

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

Method Summary
`void`	`close()`
`void`	`commit()` API method inherited from session, but intercepted here for forbidding its use in the XA context (as defined by the API).
`javax.jms.QueueBrowser`	`createBrowser(javax.jms.Queue queue)` Delegates the call to the wrapped JMS session.
`javax.jms.QueueBrowser`	`createBrowser(javax.jms.Queue queue, java.lang.String selector)` Delegates the call to the wrapped JMS session.
`javax.jms.BytesMessage`	`createBytesMessage()`
`javax.jms.MessageConsumer`	`createConsumer(javax.jms.Destination dest)` Delegates the call to the wrapped JMS session.
`javax.jms.MessageConsumer`	`createConsumer(javax.jms.Destination dest, java.lang.String selector)` Delegates the call to the wrapped JMS session.
`javax.jms.MessageConsumer`	`createConsumer(javax.jms.Destination dest, java.lang.String selector, boolean noLocal)` Delegates the call to the wrapped JMS session.
`javax.jms.TopicSubscriber`	`createDurableSubscriber(javax.jms.Topic topic, java.lang.String name)` Delegates the call to the wrapped JMS session.
`javax.jms.TopicSubscriber`	`createDurableSubscriber(javax.jms.Topic topic, java.lang.String name, java.lang.String selector, boolean noLocal)` Delegates the call to the wrapped JMS session.
`javax.jms.MapMessage`	`createMapMessage()`
`javax.jms.Message`	`createMessage()`
`javax.jms.ObjectMessage`	`createObjectMessage()`
`javax.jms.ObjectMessage`	`createObjectMessage(java.io.Serializable obj)`
`javax.jms.MessageProducer`	`createProducer(javax.jms.Destination dest)` Delegates the call to the wrapped JMS session.
`javax.jms.Queue`	`createQueue(java.lang.String queueName)`
`javax.jms.StreamMessage`	`createStreamMessage()`
`javax.jms.TemporaryQueue`	`createTemporaryQueue()`
`javax.jms.TemporaryTopic`	`createTemporaryTopic()`
`javax.jms.TextMessage`	`createTextMessage()`
`javax.jms.TextMessage`	`createTextMessage(java.lang.String text)`
`javax.jms.Topic`	`createTopic(java.lang.String topicName)`
`int`	`getAcknowledgeMode()`
`Session`	`getDelegateSession()`
`javax.jms.MessageListener`	`getMessageListener()`
`javax.jms.Session`	`getSession()` API method.
`boolean`	`getTransacted()` API method.
`javax.transaction.xa.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()`
`void`	`setMessageListener(javax.jms.MessageListener messageListener)`
`java.lang.String`	`toString()` Returns a String image of this session.
`void`	`unsubscribe(java.lang.String name)`

Methods inherited from class java.lang.Object

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

Field Detail

sess

protected Session sess

Constructor Detail

XASession

public XASession(Connection cnx,
                 Session sess,
                 XAResourceMngr rm)
          throws javax.jms.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:

javax.jms.JMSException - Actually never thrown.

Method Detail

getDelegateSession

public final Session getDelegateSession()

toString

public java.lang.String toString()

Returns a String image of this session.

getSession

public javax.jms.Session getSession()
                             throws javax.jms.JMSException

API method.

Specified by:: getSession in interface javax.jms.XASession

Throws:: javax.jms.IllegalStateException - If the session is closed.; javax.jms.JMSException

getXAResource

public javax.transaction.xa.XAResource getXAResource()

API method.

Specified by:: getXAResource in interface javax.jms.XASession

getTransacted

public boolean getTransacted()
                      throws javax.jms.JMSException

API method.

Specified by:: getTransacted in interface javax.jms.XASession

Throws:: javax.jms.IllegalStateException - If the session is closed.; javax.jms.JMSException