Show TOC

Adapter-Framework JCA CCI-BibliothekLocate this document in the navigation structure

SAP NetWeaver und das Adapter-Framework erweitern das Standard JCA CCI-Interface.

Verwenden Sie in Ihrem JCA-Adapter die Standard-Eingangs- und Ausgangsmodule, müssen Sie die Adapter-Framework-spezifischen JCA-CCI-Interfaces implementieren.

Verwenden Sie die Exceptions, die von der Adapter-Framework JCA CCI-Bibliothek vorgesehen sind.

Interface-Überblick

Merkmal Wert

Name

SAP NetWeaver XI AF JCA CCI

Zweck

Erweitert die JCA CCI-Interfaces, um den JCA Resource Adapter über das Standard Exit-Modul des Adapter-Framework aufzurufen.

Typ

Java-Bibliothek in der Fassade com.sap.aii.af.lib.facade

Technischer Name

Java-Paket com.sap.aii.af.ra.cci

Zertifizierung

  • Zwingend erforderlich, falls Sie die Adapter-Framework Standardmodule verwenden
  • Optional, wenn Sie ein eigenes Exit-Modul für das Adapter-Framework verwenden

Syntax

JavaDoc, package com.sap.aii.af.lib.ra.cci

JCA verwendet zwei Spezifikationstypen, um auf JCA-Ressourcen zuzugreifen:

  • ConnectionSpec wird dazu verwendet, eine JCA-Verbindung auszuwählen.

    Sie können auf ConnectionSpec üblicherweise nicht über JNDI zugreifen.

  • InteractionSpec beschreibt die auszuführende CCI-Interaction.

    Obwohl in der JCA-Spezifikation erwähnt wird, dass auf die InteractionSpec über JNDI zugegriffen werden kann, ist das im Adapter-Framework nicht erforderlich.

SAP NetWeaver stellt weitere Funktionen zur Verfügung:

  • XIConnectionFactory stellt getConnectionSpec() und getRecordFactory() als Factory-Methoden für die XI-ConnectionSpec und -MessageFactory zur Verfügung.
  • XIInteraction stellt getInteractionSpec() als Factory-Methode für InteractionSpec zur Verfügung.

Zusätzliche Funktionen für das Adapter-Framework

Name Funktion

XIConnectionSpec

Fügt die JCA-Standard-Properties für Benutzername und Kennwort hinzu, um Credentials zu überprüfen und für die Kommunikationskanal-ID, um eine Verbindungsauswahl basierend auf dem Adapter-Framework-Kanal zu erlauben.

XIInteractionSpec

Erlaubt die Unterscheidung zwischen synchroner und asynchroner Message-Verarbeitung. Für administrative Zwecke werden eventuell weitere Funktionsnamen hinzugefügt.

XIInteraction

Erweitert die CCI-Interaction, indem eine Methode zur Erzeugung von XIInteractionSpecs hinzugefügt wird.

XIRecordFactory

Stellt eine Factory-Methode zur Verfügung, um XI-MessageRecords zu erzeugen

XIMessageRecord

Steht für die Kombination aus CCI-Record und Messaging-Service Message. Ein XIMessageRecord mit einer enthaltenen XI-Message wird in Empfängerrichtung an den JCA Resource Adapter weitergeleitet.

XIAdapterException

Zeigt dem Adapter-Framework an, dass eine ausgehende Message-Verarbeitung fehlerhaft ist. Das Adapter-Framework führt ein Rollback durch und plant ein wiederholtes Senden ein.