Message-Fluss in Empfängerrichtung 

Verwendung

In der folgenden Grafik ist der Message-Fluss in Empfängerrichtung, also vom Integration Server zum Business-System dargestellt.

Funktionsumfang

·        Wenn eine Message vom Integration Server (IS Outbound) zum Adapter-Framework gesendet wird, dann wird sie dort vom Adapter-Framework Messaging-Service (AF MS) empfangen. Dieser Service ist für die HTTP/SOAP-Kommunikation auf Basis des XI-Message-Protokolls verantwortlich. Zunächst speichert der Service die erhaltene Message.

·        Dann bestimmt er aufgrund der Daten im Message-Header den Kommunikationskanal und ruft den Modul-Prozessor (AF MP) mit der Message und der Kommunikationskanal-ID auf. Die Message ist nun in ein Java-Objekt umgewandelt, das das XIMessage-Interface implementiert.

·        In Abhängigkeit von der Adapter-Implementierung wird nun entweder das Adapter-Framework Standard-JCA Exit-Bean (ModuleProcessorExitBean) aufgerufen oder es werden Ihre Adapter-Framework Module (MeinModul1, ..., MeinModulN) aufgerufen. Ein Adapter-Framework Modul ist als zustandslose Session Enterprise JavaBean definiert, die das Adapter-Framework Module-Interface implementieren.

¡        Im ersten Fall ermittelt die ModuleProcessorExitBean den JCA Resource Adapter (JCA RA) anhand der ModuleProcessorExitBean Modulkonfiguration des verwendeten Kommunikationskanals. Er ruft den JCA Resource Adapter über CCI auf (siehe hierzu: Adapter-Framework JCA CCI-Bibliothek) und übergibt den XI-Message-Record, der eine Kombination aus einem CCI-Record und einem Java-Objekt ist, das das XI-Message-Interface implementiert.

¡        Im zweiten Fall nimmt das erste Adapter-Framework-Modul (MeinModul1) das XIMessage-Objekt mit Kontext und der Konfigurationsinformation entgegen.

¡        Die Message wird modulspezifisch weiterverarbeitet. Alternativ kann der Adapter ein eigenes Austausch-Java-Objekt implementieren.

¡        Schließlich müssen Sie in der Adapter-Implementierung entscheiden, ob das Adaper-Framework CCI-Interface verwendet werden soll, um mit dem JCA Resource Adapter zu kommunizieren. Alternativ können Sie eine eigene CCI-Variante oder ein Nicht-CCI-Interface verwenden. Die erste Alternative ist sinnvoll, da der JCA Resource Adapter in diesem Fall mit anderen Modulen kombiniert werden kann.

·        Der letzte Schritt unterliegt der Kontrolle des JCA Resource Adapters (JCA RA). Er extrahiert die Message-Daten aus dem XIMessage-Objekt (oder aus der eigenen Struktur, falls ein anderer Weg gewählt wurde), mappt sie auf das externe Protokoll und schickt sie an die entsprechende Anwendung. Hierbei sind das transaktionale Verhalten und die Sicherheitsmechanismen wichtig.

·        Im Falle von asynchronen Messages können vom Integration Server zusätzliche Acknowledgment-Messages angefordert werden. Diese zeigen an, ob eine Message erfolgreich oder nicht erfolgreich ausgeliefert wurde. Außerdem können Sie anzeigen, ob eine Message erfolgreich von der Anwendung bearbeitet wurde. Falls ein Adapter keine Acknowledgment-Messages unterstützt, muss er dies explizit durch einen Methodenaufruf ankündigen.

Aktivitäten

Folgende Interfaces sind für Sie für den Message-Austausch in der Adapterentwicklung wichtig:

Das...

       1.      Das XIMessage Java-Interface für den Message-Zugriff und die Message-Erstellung.

       2.      Die Adapter-Framework Module-Java-Interfaces bestehend aus Module, ModuleContext, ModuleData und ModuleException.

       3.      Das Adapter-Framework CCI-Interface, siehe auch: Adapter-Framework JCA CCI-Bibliothek

Die Adapter-Framework Module können nach der Verarbeitung im JCA Resource Adapter aufgerufen werden, um die erhaltene JCA Resource Adapter Antwort zu bearbeiten, bevor sie an den Adapter-Framework Messaging-Service zurückgegeben wird.