nl.nn.adapterframework.extensions.sap.jco3

Class SapLUWManager

java.lang.Object

nl.nn.adapterframework.core.TransactionAttributes

nl.nn.adapterframework.pipes.AbstractPipe

nl.nn.adapterframework.pipes.FixedForwardPipe

nl.nn.adapterframework.extensions.sap.jco3.SapLUWManager

All Implemented Interfaces:

HasTransactionAttribute, IConfigurable, IConfigurationAware, IExtendedPipe, IForwardTarget, INamedObject, IPipe, IPipeLineExitHandler, IScopeProvider, EventThrowing, org.springframework.beans.factory.Aware, org.springframework.context.ApplicationContextAware

public class SapLUWManager
extends FixedForwardPipe
implements IPipeLineExitHandler

Manager for SAP Logical Units of Work (LUWs). Used to begin, commit or rollback LUWs. A SapLUWManager can be placed before a number of SapSenders. The SapLUWManager and the SapSenders must each use the same value for luwHandleSessionKey. By doing so, they use the same connection to SAP. This allows to perform a commit on a number of actions.
The placement of the the first SapLUWManager is optionan: By specifying a new luwHandleSessionKey a new handle is created implicitly.
To explicityly commit or rollback a set of actions, a SapLUWManager-pipe can be used, with the action-attribute set apropriately.

Since:

5.0

Author:

Gerrit van Brakel, Jaco de Groot

Field Summary

Fields

Modifier and Type	Field and Description
static String	ACTION_BEGIN
static String	ACTION_COMMIT
static String	ACTION_RELEASE
static String	ACTION_ROLLBACK

Fields inherited from class nl.nn.adapterframework.pipes.AbstractPipe

parameterNamesMustBeUnique

Fields inherited from class nl.nn.adapterframework.core.TransactionAttributes

log

Fields inherited from interface nl.nn.adapterframework.core.IExtendedPipe

LONG_DURATION_MONITORING_EVENT, MESSAGE_SIZE_MONITORING_EVENT, PIPE_EXCEPTION_MONITORING_EVENT

Constructor Summary

Constructors

Constructor and Description
SapLUWManager()

Method Summary

Modifier and Type	Method and Description
void	atEndOfPipeLine(String correlationId, PipeLineResult pipeLineResult, PipeLineSession session)
void	configure()
PipeRunResult	doPipe(Message message, PipeLineSession session)
String	getAction()
String	getLuwHandleSessionKey()
SapSystemImpl	getSapSystem()
String	getSapSystemName()
void	setAction(String string)
void	setLuwHandleSessionKey(String string)
void	setSapSystemName(String string)
void	start()
void	stop()

Methods inherited from class nl.nn.adapterframework.pipes.FixedForwardPipe

doInitialPipe, getIfParam, getIfValue, getParameterValue, getSuccessForward, isSkipOnEmptyInput, setIfParam, setIfValue, setSkipOnEmptyInput

Methods inherited from class nl.nn.adapterframework.pipes.AbstractPipe

addParameter, consumesSessionVariable, createBean, findForward, getAdapter, getApplicationContext, getChompCharSize, getConfigurationClassLoader, getDurationThreshold, getElementToMove, getElementToMoveChain, getElementToMoveSessionKey, getEmptyInputReplacement, getEventSourceName, getForwards, getGetInputFromFixedValue, getGetInputFromSessionKey, getHideRegex, getInSizeStatDummyObject, getLocker, getLogIntermediaryResults, getLogPrefix, getMaxThreads, getName, getOutSizeStatDummyObject, getParameterList, getPipeLine, getSecLogSessionKeys, getStoreResultInSessionKey, hasSizeStatistics, isPreserveInput, isRemoveCompactMsgNamespaces, isRestoreMovedElements, isWriteToSecLog, registerEvent, registerForward, setApplicationContext, setChompCharSize, setDurationThreshold, setElementToMove, setElementToMoveChain, setElementToMoveSessionKey, setEmptyInputReplacement, setEventPublisher, setGetInputFromFixedValue, setGetInputFromSessionKey, setHideRegex, setLocker, setLogIntermediaryResults, setMaxThreads, setName, setPipeLine, setPreserveInput, setRemoveCompactMsgNamespaces, setRestoreMovedElements, setSecLogSessionKeys, setSizeStatistics, setStoreResultInSessionKey, setWriteToSecLog, throwEvent

Methods inherited from class nl.nn.adapterframework.core.TransactionAttributes

configureTransactionAttributes, getTransactionAttribute, getTransactionTimeout, getTxDef, isTransacted, isTransacted, setTransacted, setTransactionAttribute, setTransactionTimeout

Methods inherited from class java.lang.Object

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

Methods inherited from interface nl.nn.adapterframework.core.INamedObject

getName, setName

Methods inherited from interface nl.nn.adapterframework.core.IExtendedPipe

throwEvent

Field Detail

ACTION_BEGIN

public static final String ACTION_BEGIN

See Also:

Constant Field Values

ACTION_COMMIT

public static final String ACTION_COMMIT

See Also:

Constant Field Values

ACTION_ROLLBACK

public static final String ACTION_ROLLBACK

See Also:

Constant Field Values

ACTION_RELEASE

public static final String ACTION_RELEASE

See Also:

Constant Field Values

Constructor Detail

SapLUWManager

public SapLUWManager()

Method Detail

configure

public void configure()
               throws ConfigurationException

Specified by:

configure in interface IConfigurable

Specified by:

configure in interface IPipe

Overrides:

configure in class FixedForwardPipe

Throws:

ConfigurationException

atEndOfPipeLine

public void atEndOfPipeLine(String correlationId,
                            PipeLineResult pipeLineResult,
                            PipeLineSession session)
                     throws PipeRunException

Specified by:

atEndOfPipeLine in interface IPipeLineExitHandler

Throws:

PipeRunException

start

public void start()
           throws PipeStartException

Specified by:

start in interface IPipe

Overrides:

start in class AbstractPipe

Throws:

PipeStartException

stop

public void stop()

Specified by:

stop in interface IPipe

Overrides:

stop in class AbstractPipe

doPipe

public PipeRunResult doPipe(Message message,
                            PipeLineSession session)
                     throws PipeRunException

Specified by:

doPipe in interface IPipe

Specified by:

doPipe in class AbstractPipe

Throws:

PipeRunException

getSapSystem

public SapSystemImpl getSapSystem()

setSapSystemName

@IbisDoc(value={"1","name of the SapSystem used by this object",""})
public void setSapSystemName(String string)

setAction

@IbisDoc(value={"2","one of: begin, commit, rollback, release",""})
public void setAction(String string)

setLuwHandleSessionKey

@IbisDoc(value={"3","session key under which information is stored",""})
public void setLuwHandleSessionKey(String string)

getLuwHandleSessionKey

public String getLuwHandleSessionKey()

getAction

public String getAction()

getSapSystemName

public String getSapSystemName()