Class FxfWrapperPipe
- All Implemented Interfaces:
DestinationValidator, FrankElement, HasApplicationContext, HasName, HasTransactionAttribute, IConfigurable, IForwardTarget, IPipe, IScopeProvider, IWithParameters, IWrapperPipe, NameAware, EventThrowing, org.springframework.beans.factory.Aware, org.springframework.context.ApplicationContextAware, org.springframework.context.Lifecycle
FxF wrapper to be used with FxF3. When receiving files (direction=unwrap)
the message handed to the pipeline is the local filename extracted from an
ESB SOAP message. When sending files (direction=wrap) input should be a local
filename which will be wrapped into an ESB SOAP message. Please note: When
writing files which need to be send through FxF they should be written to
${fxf.dir}/NNX00000/out. The property ${fxf.dir} will automatically be
available on the DTAP environment (define it in StageSpecifics_LOC.properties
only). Replace NNX00000 with the specific flowId and generate a unique
filename (files will automatically be cleaned after 30 days or any other
value specified by ${fxf.retention}).
- Author:
- Jaco de Groot
-
Nested Class Summary
Nested classes/interfaces inherited from class EsbSoapWrapperPipe
EsbSoapWrapperPipe.ModeNested classes/interfaces inherited from interface IWrapperPipe
IWrapperPipe.Direction -
Field Summary
Fields inherited from class EsbSoapWrapperPipe
APPLICATIONFUNCTION_PARAMETER_NAME, APPLICATIONNAME_PARAMETER_NAME, BUSINESSDOMAIN_PARAMETER_NAME, CMHVERSION_PARAMETER_NAME, CONVERSATIONID_PARAMETER_NAME, CORRELATIONID_PARAMETER_NAME, CPAID_PARAMETER_NAME, DESTINATION_PARAMETER_NAME, EXTERNALREFTOMESSAGEID_PARAMETER_NAME, FIXRESULTNAMESPACE_PARAMETER_NAME, FROMID_PARAMETER_NAME, MESSAGEID_PARAMETER_NAME, MESSAGINGLAYER_PARAMETER_NAME, MODE_PARAMETER_NAME, OPERATIONNAME_PARAMETER_NAME, OPERATIONVERSION_PARAMETER_NAME, OUTPUTNAMESPACEBASEURI, PARADIGM_PARAMETER_NAME, PHYSICALDESTINATION_PARAMETER_NAME, SERVICECONTEXT_PARAMETER_NAME, SERVICECONTEXTVERSION_PARAMETER_NAME, SERVICELAYER_PARAMETER_NAME, SERVICENAME_PARAMETER_NAME, TIMESTAMP_PARAMETER_NAME, TRANSACTIONID_PARAMETER_NAMEFields inherited from class SoapWrapperPipe
DEFAULT_SOAP_HEADER_SESSION_KEY, DEFAULT_SOAP_NAMESPACE_SESSION_KEY, DEFAULT_SOAP_VERSION_FOR_WRAPPINGFields inherited from class AbstractPipe
parameterNamesMustBeUniqueFields inherited from class TransactionAttributes
logFields inherited from interface IPipe
LONG_DURATION_MONITORING_EVENT, MESSAGE_SIZE_MONITORING_EVENT, PIPE_EXCEPTION_MONITORING_EVENT -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoidChecks for correct configuration of forward.@NonNull PipeRunResultdoPipe(Message message, PipeLineSession session) This is where the action takes place.voidsetClientFilenameSessionKey(String clientFilenameSessionKey) voidsetCreateFolder(boolean createFolder) when set totrue, the folder corresponding fxf.dir property will be created in case it does not existvoidThe flowId of the file transfer when direction=wrap.voidsetFlowIdSessionKey(String flowIdSessionKey) voidsetFlowOutFolder(String flowOutFolder) specifies the output folder if transformFilename=falseand direction=wrapvoidsetFxfDirSessionKey(String fxfDirSessionKey) voidsetFxfFileSessionKey(String fxfFileSessionKey) voidsetFxfVersion(String fxfVersion) either 3.1 or 3.2voidsetSoapBodySessionKey(String soapBodySessionKey) voidsetTransferFlowIdSessionKey(String transferFlowIdSessionKey) voidsetTransformFilename(boolean transformFilename) whentrueand direction=wrap, the input which is expected to be a local filename will be transformed to the filename as known on the IUF State machine.voidsetUseServerFilename(boolean useServerFilename) when set totrue, ServerFileName from the input will be used as the filenamevoidstart()Perform necessary action to start the pipe.voidstop()Perform necessary actions to stop thePipe.
For instance, closing JMS connections, DBMS connections etc.Methods inherited from class EsbSoapWrapperPipe
getApplicationFunction, getApplicationName, getBusinessDomain, getDestination, getMessagingLayer, getOperationName, getOperationVersion, getOutputNamespaceBaseUri, getParadigm, getServiceContext, getServiceContextVersion, getServiceLayer, getServiceName, isEsbDestinationWithoutServiceContext, isEsbNamespaceWithoutServiceContext, isValidNamespace, retrievePhysicalDestinationFromListener, retrievePhysicalDestinationFromSender, setAddOutputNamespace, setCmhVersion, setEsbAlias, setFixResultNamespace, setMode, setP2pAlias, setRetrievePhysicalDestination, setUseFixedValues, validateListenerDestinations, validateSenderDestinationMethods inherited from class SoapWrapperPipe
setAllowPlainXml, setDirection, setEncodingStyle, setIgnoreSoapFault, setOmitXmlDeclaration, setOutputNamespace, setRemoveOutputNamespaces, setRemoveUnusedOutputNamespaces, setRoot, setServiceNamespace, setSoapBodyStyleSheet, setSoapHeaderSessionKey, setSoapHeaderStyleSheet, setSoapNamespace, setSoapNamespaceSessionKey, setSoapVersion, setWssAuthAlias, setWssPassword, setWssPasswordDigest, setWssUserName, unwrapMessage, wrapMessageMethods inherited from class FixedForwardPipe
getParameterValueMethods inherited from class AbstractPipe
addForward, addParameter, createBean, findForward, getAdapter, getEventSourceName, getParameterList, getRegisteredForwards, hasRegisteredForward, isRunning, registerEvent, setApplicationContext, setChompCharSize, setDefaultValue, setDurationThreshold, setElementToMove, setElementToMoveChain, setElementToMoveSessionKey, setEmptyInputReplacement, setGetInputFromFixedValue, setGetInputFromSessionKey, setHideRegex, setIfParam, setIfValue, setLocker, setLogIntermediaryResults, setMaxThreads, setName, setOnlyIfSessionKey, setOnlyIfValue, setPreserveInput, setRemoveCompactMsgNamespaces, setRestoreMovedElements, setSecLogSessionKeys, setSizeStatistics, setSkipOnEmptyInput, setStoreResultInSessionKey, setUnlessSessionKey, setUnlessValue, setWriteToSecLog, sizeStatisticsEnabled, skipPipe, throwEventMethods inherited from class TransactionAttributes
configureTransactionAttributes, isTransacted, isTransacted, setTransacted, setTransactionTimeoutMethods inherited from class Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitMethods inherited from interface org.springframework.context.ApplicationContextAware
setApplicationContextMethods inherited from interface FrankElement
addConfigWarningMethods inherited from interface HasApplicationContext
getApplicationContext, getConfigurationClassLoaderMethods inherited from interface HasTransactionAttribute
getTransactionAttribute, getTransactionTimeout, getTxDef, setTransactionAttributeMethods inherited from interface IForwardTarget
getNameMethods inherited from interface IPipe
addForward, findForward, getChompCharSize, getDefaultValue, getDurationThreshold, getElementToMove, getElementToMoveChain, getElementToMoveSessionKey, getGetInputFromFixedValue, getGetInputFromSessionKey, getHideRegex, getIfParam, getIfValue, getLocker, getLogIntermediaryResults, getMaxThreads, getOnlyIfSessionKey, getOnlyIfValue, getRegisteredForwards, getSecLogSessionKeys, getStoreResultInSessionKey, getUnlessSessionKey, getUnlessValue, isPreserveInput, isRemoveCompactMsgNamespaces, isRestoreMovedElements, isSkipOnEmptyInput, isWriteToSecLog, registerEvent, setChompCharSize, setDefaultValue, setDurationThreshold, setElementToMove, setElementToMoveChain, setElementToMoveSessionKey, setEmptyInputReplacement, setGetInputFromFixedValue, setGetInputFromSessionKey, setHideRegex, setIfParam, setIfValue, setLocker, setLogIntermediaryResults, setOnlyIfSessionKey, setOnlyIfValue, setPipeLine, setPreserveInput, setRemoveCompactMsgNamespaces, setRestoreMovedElements, setSecLogSessionKeys, setSkipOnEmptyInput, setStoreResultInSessionKey, setUnlessSessionKey, setUnlessValue, setWriteToSecLog, sizeStatisticsEnabled, skipPipe, throwEvent, throwEventMethods inherited from interface IWrapperPipe
setNameMethods inherited from interface org.springframework.context.Lifecycle
isRunning
-
Constructor Details
-
FxfWrapperPipe
public FxfWrapperPipe()
-
-
Method Details
-
configure
Description copied from class:FixedForwardPipeChecks for correct configuration of forward.- Specified by:
configurein interfaceIConfigurable- Overrides:
configurein classEsbSoapWrapperPipe- Throws:
ConfigurationException- in case it was not able to configure the component.
-
start
public void start()Description copied from interface:IPipePerform necessary action to start the pipe. This method is executed after theIConfigurable.configure()method, for each start and stop command of the adapter.- Specified by:
startin interfaceIPipe- Specified by:
startin interfaceorg.springframework.context.Lifecycle- Overrides:
startin classSoapWrapperPipe
-
stop
public void stop()Description copied from interface:IPipePerform necessary actions to stop thePipe.
For instance, closing JMS connections, DBMS connections etc.- Specified by:
stopin interfaceIPipe- Specified by:
stopin interfaceorg.springframework.context.Lifecycle- Overrides:
stopin classSoapWrapperPipe
-
doPipe
public @NonNull PipeRunResult doPipe(Message message, PipeLineSession session) throws PipeRunException Description copied from interface:IPipeThis is where the action takes place. Pipes may only throw a PipeRunException, to be handled by the caller of this object. Implementations must either consume the message, or pass it on to the next Pipe in the PipeRunResult.- Specified by:
doPipein interfaceIPipe- Overrides:
doPipein classSoapWrapperPipe- Throws:
PipeRunException
-
setFlowId
The flowId of the file transfer when direction=wrap. When direction=unwrap the flowId will be extracted from the incoming message and added as a sessionKey to the pipeline. -
setFlowOutFolder
specifies the output folder if transformFilename=falseand direction=wrap -
setTransformFilename
public void setTransformFilename(boolean transformFilename) whentrueand direction=wrap, the input which is expected to be a local filename will be transformed to the filename as known on the IUF State machine.- Default value
- true
-
setSoapBodySessionKey
-
setTransferFlowIdSessionKey
-
setClientFilenameSessionKey
-
setFlowIdSessionKey
-
setFxfDirSessionKey
-
setFxfFileSessionKey
-
setFxfVersion
-
setCreateFolder
public void setCreateFolder(boolean createFolder) when set totrue, the folder corresponding fxf.dir property will be created in case it does not exist- Default value
- false
-
setUseServerFilename
public void setUseServerFilename(boolean useServerFilename) when set totrue, ServerFileName from the input will be used as the filename- Default value
- false
-