Message-Fluss in Empfängerrichtung

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

• Wenn eine Message vom Integration Server (IS Outbound) zum Adapter-Framework gesendet wird, wird sie 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, wenn Quality-of-Service Exactly Once oder Exactly Once in Order ist.

• Dann bestimmt der Service 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 und übergibt den XI-Message-Record, der eine Kombination aus einem CCI-Record und einem Java-Objekt ist, das das XI-Message-Interface implementiert.

    Weitere Informationen: Adapter-Framework JCA CCI-Bibliothek

  • Im zweiten Fall nimmt das erste Adapter-Framework-Modul (MeinModul1) das XIMessage -Objekt mit Kontext und der Konfigurationsinformation entgegen.
  • Die Message wird modulspezifisch weiterverarbeitet. Sie können das XI-Message-Objekt in eine eigene Objektdarstellung mit selbst definierten Interfaces oder Methoden wandeln.
  • 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 transaktionale Verhalten und 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.

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

• Das XIMessage Java-Interface für den Message-Zugriff und die Message-Erstellung.
• Die Adapter-Framework Module-Java-Interfaces bestehend aus Module , ModuleContext, ModuleData und ModuleException .
• Das Adapter-Framework CCI-Interface

  Weitere Informationen: Adapter-Framework JCA CCI-Bibliothek

  Hinweis

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