nl.nn.adapterframework.extensions.sap.jco3

Class SapSenderImpl

java.lang.Object

nl.nn.adapterframework.extensions.sap.jco3.SapFunctionFacade

nl.nn.adapterframework.extensions.sap.jco3.SapSenderBase

nl.nn.adapterframework.extensions.sap.jco3.SapSenderImpl

All Implemented Interfaces:

HasPhysicalDestination, IConfigurable, IConfigurationAware, INamedObject, IScopeProvider, ISender, ISenderWithParameters, IWithParameters, ISapFunctionFacade, ISapSender, org.springframework.beans.factory.Aware, org.springframework.context.ApplicationContextAware

Direct Known Subclasses:

SapSender, SapSender

public abstract class SapSenderImpl
extends SapSenderBase
implements ISapSender

Implementation of sender that calls a SAP RFC-function. N.B. If no requestFieldIndex or requestFieldName is specified, input is converted from xml; If no replyFieldIndex or replyFieldName is specified, output is converted to xml.

Since:

5.0

Author:

Gerrit van Brakel, Jaco de Groot

Specific parameters

functionName defines functionName; required when attribute functionName is empty, inputfieldname The value of the parameter is set to the (simple) input field, structurename/inputfieldname The value of the parameter is set to the named field of the named structure

Field Summary

Fields inherited from class nl.nn.adapterframework.extensions.sap.jco3.SapSenderBase

paramList

Fields inherited from class nl.nn.adapterframework.extensions.sap.jco3.SapFunctionFacade

log

Constructor Summary

Constructors

Constructor and Description
SapSenderImpl()

Method Summary

Modifier and Type	Method and Description
void	configure() configure() is called once at startup of the framework in the configure method of the owner of this sender.
com.sap.conn.jco.JCoFunction	getFunction(SapSystemImpl sapSystem, ParameterValueList pvl)
SenderResult	sendMessage(Message message, PipeLineSession session) Send a message to some destination (as configured in the Sender object).
void	setFunctionName(String string) Name of the RFC-function to be called in the SAP system
void	setFunctionNameParam(String string) Name of the parameter used to obtain the functionName from if the attribute functionName is empty
void	setSynchronous(boolean b) If false, the sender operates in RR mode: the a reply is expected from SAP, and the sender does not participate in a transaction.

Methods inherited from class nl.nn.adapterframework.extensions.sap.jco3.SapSenderBase

addParameter, close, getDestination, getParameterList, getSystem, getTid, open, setLuwHandleSessionKey, setSapSystemNameParam

Methods inherited from class nl.nn.adapterframework.extensions.sap.jco3.SapFunctionFacade

calculateStaticFieldIndices, closeFacade, findFieldIndex, functionCall2message, functionResult2message, getCorrelationIdFromField, getFunctionName, getFunctionTemplate, getFunctionTemplate, getLogPrefix, getPhysicalDestinationName, getSapSystem, getSapSystem, message2FunctionCall, message2FunctionResult, openFacade, setCorrelationIdFieldIndex, setCorrelationIdFieldName, setName, setParameters, setReplyFieldIndex, setReplyFieldName, setRequestFieldIndex, setRequestFieldName, setSapSystemName

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.extensions.sap.ISapSender

getRequestFieldName, setLuwHandleSessionKey, setSapSystemNameParam

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

consumesSessionVariable

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

close, isSynchronous, open, sendMessageOrThrow

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

getName, setName

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

getApplicationContext, getName

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

getConfigurationClassLoader

Methods inherited from interface org.springframework.context.ApplicationContextAware

setApplicationContext

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

addParameter, getParameterList

Methods inherited from interface nl.nn.adapterframework.extensions.sap.ISapFunctionFacade

setCorrelationIdFieldIndex, setCorrelationIdFieldName, setReplyFieldIndex, setReplyFieldName, setRequestFieldIndex, setRequestFieldName, setSapSystemName

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

getDomain, getPhysicalDestinationName

Constructor Detail

SapSenderImpl

public SapSenderImpl()

Method Detail

configure

public void configure()
               throws ConfigurationException

Description copied from interface: ISender

configure() is called once at startup of the framework in the configure method of the owner of this sender. Purpose of this method is to check whether the static configuration of the sender is correct. As much as possible class-instantiating should take place in the configure() or open() method, to improve performance.

Specified by:

configure in interface IConfigurable

Specified by:

configure in interface ISender

Overrides:

configure in class SapSenderBase

Throws:

ConfigurationException

getFunction

public com.sap.conn.jco.JCoFunction getFunction(SapSystemImpl sapSystem,
                                                ParameterValueList pvl)
                                         throws SapException

Throws:

SapException

sendMessage

public SenderResult sendMessage(Message message,
                                PipeLineSession session)
                         throws SenderException,
                                TimeoutException

Description copied from interface: ISender

Send a message to some destination (as configured in the Sender object). This method may only be called after the configure() method is called.

The following table shows the difference between synchronous and a-synchronous senders:

	synchronous	a-synchronous
ISender.isSynchronous() returns	true	false
return value of sendMessage() is	the reply-message	the messageId of the message sent
the correlationID specified with sendMessage()	may be ignored	is sent with the message
a {link TimeOutException}	may be thrown if a timeout occurs waiting for a reply	should not be expected

Multiple objects may try to call this method at the same time, from different threads. Implementations of this method should therefore be thread-safe, or synchronized.

Specified by:

sendMessage in interface ISender

Throws:

SenderException

TimeoutException

setSynchronous

public void setSynchronous(boolean b)

Description copied from class: SapSenderBase

If false, the sender operates in RR mode: the a reply is expected from SAP, and the sender does not participate in a transaction. When false, the sender operates in FF mode: no reply is expected from SAP, and the sender joins the transaction, that must be present. The SAP transaction is committed right after the XA transaction is completed.

Specified by:

setSynchronous in interface ISapSender

Overrides:

setSynchronous in class SapSenderBase

setFunctionName

public void setFunctionName(String string)

Name of the RFC-function to be called in the SAP system

Specified by:

setFunctionName in interface ISapSender

setFunctionNameParam

public void setFunctionNameParam(String string)

Name of the parameter used to obtain the functionName from if the attribute functionName is empty

Specified by:

setFunctionNameParam in interface ISapSender

Default value

functionName