The module processor controls the message flow between the messaging service and the JCA adapter.
CallSapAdapter
For more information about the modules that are provided by SAP, see Modules .
A module is a session ejb that also implements the Adapter Framework module interface. An Adapter Framework module should be stateless, that is, not persist any data. In a file system or database, it is not possible to have a joint transaction with Adapter Framework message processing. Inconsistencies could occur in error situations.
The Adapter Framework contains the example module ConvertCRLFfromToLF.
More information: Example Module from Adapter Development
Interface Overview
Characteristic | Value |
---|---|
Name |
AF module interface |
Purpose |
Writes adapter-specific or general Adapter Framework modules. |
Type |
Library in the facade
com.sap.aii.af.lib.facade |
Technical name |
com.sap.aii.af.lib.mp.modulecom.sap.aii.af.lib.mp.processor |
Certification |
Optional |
Syntax |
Javadoc package com.sap.aii.af.mp.module |
In the message flow to the receiver the messaging service calls the module processor.
In the message flow from the sender it is called by the adapter (or an adapter Enterprise JavaBean).
More information: Adding Modules in the Module Processor
Classes and Interfaces
Class or Interface | Use |
---|---|
ModuleProcessorFactory |
Factory for generating a module processor object |
ModuleProcessor |
Module processor instance for transferring a message from the adapter to the Adapter Framework in the sender channel |
ModuleProcessorException |
Exception of the Adapter Framework module processor |
Modules |
The module interface implemented by the module processor |
ModuleData |
The data container that transports the message (main data) and the additional objects (additional data) between the modules does not have a type. |
ModuleContext |
The module processor gives the module configuration to the module. Therefore, the module does not have to use the Adapter Framework configuration API. |
ModuleException |
A module must output a module exception and should save the triggering exception under cause. |
For a detailed description of the classes and interfaces, see the Javadoc documentation.
The following default modules are shipped with the Adapter Framework:
If you use the recommended Adapter Framework CCI interface in the receiver direction, this module must be the last in the module chain. It recognizes the following parameters:
JNDIName
In the sender direction, this module must be called in the module chain. It does not use any configuration parameters.
The example module ConvertCRLFfromToLF is shipped with the Adapter Framework. It shows the processing of text payloads in which carriage return line feed (CRLF) line breaks are converted to line feed (LF) or the other way around.
This module is installed with the Adapter Framework and you use it as follows:
The ConvertCRLFfromToLF module must be the first in the module chain in the receiver channel or the penultimate module before CallSAPAdapter in the sender channel. The convert parameter can have the following values:
More information: Example Adapter and Example Module