Message Exchange 

Use

The Adapter Framework controls the exchange of synchronous and asynchronous XI messages and communicates with the Integration Server to do this. The adapters in the Adapter Framework convert XI messages to the protocols of connected external systems and the other way around.

Activities

You use the following interfaces and classes in adapter development:

·        You can define your own modules for the adapter in the module processor. These must be compliant with the Adapter Framework module interfaces. See: Adapter-Framework Module Interfaces

·        Follow the rules and design guidelines that are described in the following chapters:

¡        The adapter must differentiate between synchronous and asynchronous messages.

¡        In the case of Exactly Once and Exactly Once In Order, the adapter must ensure guaranteed message delivery. See also: Parts of an XI Message, under Quality of Service.

¡        The adapter must use the J2EE Transaction Manager and the MessageIDMapper to guarantee message delivery. See also: Asynchronous Messages

·        Note the following for the receiver/outbound direction:

¡        The adapter must use the Message interface to read the message. This can be used either in the JCA adapter or in your own modules.

¡        The adapter must use the ModuleProcessorExitBean of the Adapter Framework to forward the message to the JCA adapter part. Note the requirements of the Adapter Framework CCI.

See also: Adapter Framework JCA CCI Library

¡        The adapter must use the messaging service message factory to generate response messages in synchronous communication.

·        Note the following for the sender/inbound direction:

¡        The adapter must forward a message object that implements the Message interface to the Adapter Framework messaging service.

¡        The adapter must use the messaging service message factory to create a new message.

¡        The adapter must call the module processor to send new messages to the Adapter Framework. It must not call CallSapAdapter directly or call the messaging service by using the connection class for this purpose.

¡        The last module in the module processor must be CallSapAdapter.