Adapter-Framework JCA CCI-Bibliothek 

SAP NetWeaver und das Adapter-Framework erweitern das Standard JCA CCI-Interface. Wenn Sie in Ihrem JCA-Adapter die Standard-Eingangs- und Ausgangsmodule verwenden, dann müssen Sie die SAP NetWeaver-spezifischen Interfaces implementieren. Darüber hinaus müssen Sie die Exceptions implementieren, die von der Adapter-Framework JCA CCI-Bibliothek vorgesehen sind.

uml_ccilib.wmf enthält das Klassendiagram in UML-Darstellung. Das Diagramm zeigt das Verhältnis zwischen den JCA-CCI-Interfaces und den Adapter-Framwork CCI-Erweiterungen.

Interface-Überblick

Merkmal	Wert
Name	SAP NetWeaver und 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
Technischer Name	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	Siehe JavaDoc (.\index.html) Package com.sap.aii.af.ra.cci

 

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

·        ConnectionSpec wird dazu verwendet, eine JCA-Verbindung auszuwählen. ConnectionSpec ist als nicht JNDI-enabled kategorisiert.

·        InteractionSpec beschreibt die auszuführende CCI-Interaction. Obwohl in der JCA-Spezifikation erwähnt wird, das InteractionSpec über JNDI gesucht werden kann, ist das nicht unbedingt erforderlich.

SAP NetWeaver stellt weitere Funktionen zur Verfügung:

·        NWConnectionFactory stellt getConnectionSpec() und getRecordFactory() als Factory-Methoden für Enterprise Portal (EP) und XI-ConnectionSpec und –MessageFactory zur Verfügung.

·        NWInteraction stellt getInteractionSpec() als Factory-Methode für InteractionSpec zur Verfügung.

Das aufgerufene Modul kann durch den Aufruf (XI oder EP) unterscheiden, ob es im EP- oder XI-Umfeld arbeitet.

Für das Adapter-Framework sind folgende Funktionen ergänzt worden:

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.
XIRecordSpec	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.
XIDeliveryException	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.
XIRecoverableException	Zeigt einen temporären Fehler an. Ein wiederholtes Senden wird eingeplant.