com.solacesystems.jcsmp.impl.transaction

Class TransactedSessionImpl

java.lang.Object

com.solacesystems.jcsmp.impl.transaction.BaseTransactedSessionImpl

com.solacesystems.jcsmp.impl.transaction.TransactedSessionImpl

All Implemented Interfaces:

TransactedSession

public class TransactedSessionImpl
extends BaseTransactedSessionImpl
implements TransactedSession

Nested Class Summary

Nested classes/interfaces inherited from class com.solacesystems.jcsmp.impl.transaction.BaseTransactedSessionImpl

BaseTransactedSessionImpl.AllowedOperation

Constructor Summary

Constructors

Constructor and Description
TransactedSessionImpl(TransactedSessionManager mgr, JCSMPChannelProperties channelProperties)

Method Summary

Modifier and Type	Method and Description
void	allowOperation(BaseTransactedSessionImpl.AllowedOperation op)
void	close() Rollback the active transaction and close the TransactedSession.
void	closeFlow(Closeable c)
void	commit() Commit the active transaction.
FlowReceiver	createFlow(XMLMessageListener listener, ConsumerFlowProperties flowProps, EndpointProperties endpointProps) Creates a consumer flow within this TransactedSession and associates it to this session.
FlowReceiver	createFlow(XMLMessageListener listener, ConsumerFlowProperties flowProps, EndpointProperties endpointProps, FlowEventHandler flowEventHander) Creates a consumer flow within this TransactedSession and associates it to this session.
XMLMessageProducer	createProducer(ProducerFlowProperties fprop, JCSMPStreamingPublishEventHandler callback) Creates a producer flow within this TransactedSession and associates it to this session.
XMLMessageProducer	createProducer(ProducerFlowProperties fprop, JCSMPStreamingPublishEventHandler callback, JCSMPProducerEventHandler eventCallback) Creates a producer flow within this TransactedSession and associates it to this session.
void	enqueueFlowToClose(Closeable flow) When a flow requests to be closed, it is added to a queue of flows to close, until the time the next transaction begins.
boolean	equals(Object obj) hashcode and equals to support shoving this into a Set
Integer	getConnTag()
TSState	getCurrentSessionState()
boolean	getExpectsAcks()
JCSMPBasicSession	getParentSession()
TransactionStatus	getStatus() Gets the status of the current transaction.
AssuredCtrlHeaderParameters.ParamTransactionId	getTransactionId()
void	handleControlMessage(AssuredCtrlEnums.TransactionCtrlMessageType mtype, AssuredCtrlHeaderBean adctrl, JCSMPErrorResponseException err_resp)
void	handleInterruptedException(JCSMPInterruptedException e)
void	handleTransportException(JCSMPTransportException e)
void	handleUnrecoverableException(JCSMPException e)
int	hashCode() hashcode and equals to support shoving this into a HashSet
boolean	hasUnboundSubFlows()
boolean	isXA()
void	notifyBound(String txSessionName, long txSessionId, AssuredCtrlEnums.TransactedSessionState routerState, AssuredCtrlHeaderParameters.ParamTransactionId routerTid)
void	notifyFinishedAdRetransmissions()
void	notifyFlowRebindFinished()
void	notifyUnknownName()
void	notifyVridChange()
void	processFlowsToClose() When the transaction state machine enters ACTIVE again (new transaction), everything queued for closing will be closed.
boolean	reconnectInProgress()
void	rollback() Rollback the active transaction.
void	setConnTag(Integer connTag)
void	setTransactionID(long txid)
boolean	startAdRetransmission()
boolean	switchStateIfNotIn(TSState newstate)
String	toString()

Methods inherited from class com.solacesystems.jcsmp.impl.transaction.BaseTransactedSessionImpl

addInputStep, addOutputStep, beforeEnqueue, getName, getTransactedSessionId, getTransactionSteps, notifyPostReconnect, setName

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.solacesystems.jcsmp.transaction.TransactedSession

getName

Constructor Detail

TransactedSessionImpl

public TransactedSessionImpl(TransactedSessionManager mgr,
                             JCSMPChannelProperties channelProperties)

Method Detail

getParentSession

public JCSMPBasicSession getParentSession()

allowOperation

public void allowOperation(BaseTransactedSessionImpl.AllowedOperation op)
                    throws InvalidOperationException

Overrides:

allowOperation in class BaseTransactedSessionImpl

Throws:

InvalidOperationException

notifyVridChange

public void notifyVridChange()

Specified by:

notifyVridChange in class BaseTransactedSessionImpl

notifyUnknownName

public void notifyUnknownName()

Specified by:

notifyUnknownName in class BaseTransactedSessionImpl

setConnTag

public void setConnTag(Integer connTag)

getConnTag

public Integer getConnTag()

getStatus

public TransactionStatus getStatus()

Description copied from interface: TransactedSession

Gets the status of the current transaction.

Specified by:

getStatus in interface TransactedSession

Returns:

An enum representing the status of the current transaction on this session.

commit

public void commit()
            throws RollbackException,
                   JCSMPException

Description copied from interface: TransactedSession

Commit the active transaction. Blocks until successfully committed or a rollback occurs.

Specified by:

commit in interface TransactedSession

Throws:

RollbackException - If the transaction was rolled back unexpectedly.

TransactionResultUnknownException - If the transaction result is unknown. This could happen when the transacted session could not be resumed after a session reconnection.

JCSMPException - On other exceptions.

rollback

public void rollback()
              throws JCSMPException

Description copied from interface: TransactedSession

Rollback the active transaction. Blocks until successfully rolled back or an error occurs.

Specified by:

rollback in interface TransactedSession

Throws:

JCSMPException - On exception.

reconnectInProgress

public boolean reconnectInProgress()

hasUnboundSubFlows

public boolean hasUnboundSubFlows()

createFlow

public FlowReceiver createFlow(XMLMessageListener listener,
                               ConsumerFlowProperties flowProps,
                               EndpointProperties endpointProps)
                        throws JCSMPException

Description copied from interface: TransactedSession

Creates a consumer flow within this TransactedSession and associates it to this session.

The semantics and error conditions of this call are identical to JCSMPSession.createFlow(XMLMessageListener, ConsumerFlowProperties, EndpointProperties).

Specified by:

createFlow in interface TransactedSession

Throws:

JCSMPException

createFlow

public FlowReceiver createFlow(XMLMessageListener listener,
                               ConsumerFlowProperties flowProps,
                               EndpointProperties endpointProps,
                               FlowEventHandler flowEventHander)
                        throws JCSMPException

Description copied from interface: TransactedSession

Creates a consumer flow within this TransactedSession and associates it to this session.

The semantics and error conditions of this call are identical to JCSMPSession.createFlow(XMLMessageListener, ConsumerFlowProperties, EndpointProperties, FlowEventHandler).

Specified by:

createFlow in interface TransactedSession

Throws:

JCSMPException

createProducer

public XMLMessageProducer createProducer(ProducerFlowProperties fprop,
                                         JCSMPStreamingPublishEventHandler callback)
                                  throws JCSMPException

Description copied from interface: TransactedSession

Creates a producer flow within this TransactedSession and associates it to this session. A maximum of one (1) producer flow may be created per TransactedSession. Only streaming producers are allowed, so callback must not be null.

Specified by:

createProducer in interface TransactedSession

Parameters:

fprop - The producer flow properties. Not used and should be null.

callback - he event handler which has to implement the at least the interface JCSMPStreamingPublishEventHandler.

Returns:

a new producer with its own producer flow

Throws:

InvalidOperationException - If the peer capabilities do not support features requested in this operation.

JCSMPException - On other errors.

createProducer

public XMLMessageProducer createProducer(ProducerFlowProperties fprop,
                                         JCSMPStreamingPublishEventHandler callback,
                                         JCSMPProducerEventHandler eventCallback)
                                  throws JCSMPException

Description copied from interface: TransactedSession

Creates a producer flow within this TransactedSession and associates it to this session. A maximum of one (1) producer flow may be created per TransactedSession. Only streaming producers are allowed, so callback must not be null.

Specified by:

createProducer in interface TransactedSession

Parameters:

fprop - The producer flow properties. Not used and should be null.

callback - A stream event handler

eventCallback - A producer event handler

Returns:

a new producer with its own producer flow

Throws:

InvalidOperationException - If the peer capabilities do not support features requested in this operation.

JCSMPException - On other errors.

close

public void close()

Description copied from interface: TransactedSession

Rollback the active transaction and close the TransactedSession. This call closes all subordinate guaranteed delivery flows (producers / consumers).

Specified by:

close in interface TransactedSession

handleTransportException

public void handleTransportException(JCSMPTransportException e)

handleInterruptedException

public void handleInterruptedException(JCSMPInterruptedException e)

handleUnrecoverableException

public void handleUnrecoverableException(JCSMPException e)

getTransactionId

public AssuredCtrlHeaderParameters.ParamTransactionId getTransactionId()

notifyBound

public void notifyBound(String txSessionName,
                        long txSessionId,
                        AssuredCtrlEnums.TransactedSessionState routerState,
                        AssuredCtrlHeaderParameters.ParamTransactionId routerTid)
                 throws JCSMPException

Throws:

JCSMPException

notifyFlowRebindFinished

public void notifyFlowRebindFinished()
                              throws JCSMPException

Throws:

JCSMPException

setTransactionID

public void setTransactionID(long txid)

switchStateIfNotIn

public boolean switchStateIfNotIn(TSState newstate)
                           throws JCSMPException

Throws:

JCSMPException

getCurrentSessionState

public TSState getCurrentSessionState()

handleControlMessage

public void handleControlMessage(AssuredCtrlEnums.TransactionCtrlMessageType mtype,
                                 AssuredCtrlHeaderBean adctrl,
                                 JCSMPErrorResponseException err_resp)

hashCode

public int hashCode()

hashcode and equals to support shoving this into a HashSet

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

hashcode and equals to support shoving this into a Set

Overrides:

equals in class Object

toString

public String toString()

Overrides:

toString in class Object

getExpectsAcks

public boolean getExpectsAcks()

Specified by:

getExpectsAcks in class BaseTransactedSessionImpl

closeFlow

public void closeFlow(Closeable c)

Specified by:

closeFlow in class BaseTransactedSessionImpl

enqueueFlowToClose

public void enqueueFlowToClose(Closeable flow)

When a flow requests to be closed, it is added to a queue of flows to close, until the time the next transaction begins.

processFlowsToClose

public void processFlowsToClose()

When the transaction state machine enters ACTIVE again (new transaction), everything queued for closing will be closed.

notifyFinishedAdRetransmissions

public void notifyFinishedAdRetransmissions()

startAdRetransmission

public boolean startAdRetransmission()

isXA

public boolean isXA()

Specified by:

isXA in class BaseTransactedSessionImpl