Adapter Framework JCA CCI Library 

SAP NetWeaver and the Adapter Framework enhance the standard JCA CCI interface. If you use the default inbound and outbound modules in your JCA adapter, you must implement the SAP NetWeaver-specific interfaces. Furthermore, you must implement the exceptions that are provided by the Adapter Framework JCA CCI library.

uml_ccilib.wmf contains the class diagram in UML format. The diagram shows the relationship between the JCA CCI interfaces and the Adapter Framework CCI enhancements.

Interface Overview

Characteristic	Value
Name	SAP NetWeaver and 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
Technical name	com.sap.aii.af.ra.cci
Certification	·        Mandatory if you use the Adapter Framework default modules ·        Optional if you use your own exit module for the Adapter Framework
Syntax	See Javadoc (.\index.html) package com.sap.aii.af.ra.cci

 

JCA uses two specification types to access JCA resources:

·        ConnectionSpec is used to select a JCA connection. ConnectionSpec is categorized as not JNDI-enabled.

·        InteractionSpec describes the CCI interaction to be executed. Although the JCA specification mentions that InteractionSpec can be searched for using JNDI, this is not absolutely necessary.

SAP NetWeaver provides additional functions:

·        NWConnectionFactory provides getConnectionSpec() and getRecordFactory() as factory methods for Enterprise Portal (EP) and XI ConnectionSpec and XI MessageFactory.

·        NWInteraction provides getInteractionSpec() as a factory method for InteractionSpec.

The called module can tell from the call (XI or EP) whether it is working in an EP or XI environment.

The following functions are added for the Adapter Framework:

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.
XIRecordSpec	Provides a factory method to generate XI MessageRecords.
XIMessageRecord	Combination of CCI record and messaging service message. An XIMessageRecord with a contained XI message is forwarded in the receiver direction to the JCA resource adapter.
XIDeliveryException	Displays to the Adapter Framework that outbound message processing contains errors. The Adapter Framework executes a rollback and schedules a resend.
XIRecoverableException	Displays a temporary error. A resend is scheduled.