Adapter Framework JCA CCI Library (SAP Library - Enabling Application-to-Application Processes)

Adapter Framework JCA CCI Library

SAP NetWeaver and the Adapter Framework enhance the standard JCA CCI interface.

If you are using the default inbound and outbound modules in your JCA adapter, you must implement the Adapter-Framework-specific JCA-CCI interfaces.

Use the exceptions that are provided by the Adapter Framework JCA CCI library.

Interface Overview

Characteristic	Value
Name	SAP NetWeaver XI AF JCA CCI
Purpose	Enhances the JCA CCI interfaces to call the JCA resource adapter using the default exit module of the Adapter Framework.
Type	Java library in the facade com.sap.aii.af.lib.facade
Technical name	Java package com.sap.aii.af.ra.cci
Certification	● Mandatory if you are using the Adapter Framework default modules ● Optional if you are using your own exit module for the Adapter Framework
Syntax	JavaDoc, package com.sap.aii.af.lib.ra.cci

JCA uses two specification types to access JCA resources:

● ConnectionSpec is used to select a JCA connection.

You cannot access ConnectionSpec using JNDI.

● InteractionSpec describes the CCI interaction to be executed.

Although the JCA specification mentions that InteractionSpec can be accessed using JNDI, this is not necessary in the Adapter Framework.

SAP NetWeaver provides additional functions:

● XIConnectionFactory provides getConnectionSpec() and getRecordFactory() as factory methods for the XI ConnectionSpec and XI MessageFactory.

● XIInteraction provides getInteractionSpec()as a factory method for InteractionSpec.

Additional Functions for the Adapter Framework

Name	Function
XIConnectionSpec	Adds the JCA standard properties for user name and password, to check credentials, and for the communication channel ID, to allow a connection selection based on the Adapter Framework channel.
XIInteractionSpec	Allows differentiation between synchronous and asynchronous message processing. Additional function names may be added for administrative purposes.
XIInteraction	Enhances CCI interaction by adding a method for creating XIInteractionSpecs.
XIRecordFactory	Provides a factory method for generating XI MessageRecords.
XIMessageRecord	Combination of CCI record and messaging service message. An XIMessageRecord containing an XI message is forwarded in the receiver direction to the JCA resource adapter.
XIAdapterException	Displays to the Adapter Framework that outbound message processing contains errors. The Adapter Framework executes a rollback, and schedules a resend.