Show TOC

Adapter Framework JCA CCI LibraryLocate this document in the navigation structure

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.