Merkmal

Wert

Name

Adapter-Framework Message-Interface

Zweck

Verarbeitet und verwaltet XI-Messages

Typ

J2EE-Service und Java-Bibliothek

Technischer Name

com.sap.aii.af.ra.ms.api

Zertifizierung

Zwingend erforderlich

Syntax

Siehe unter Pfad: JavaDoc (.\index.html) package com.sap.aii.af.ra.ms.api

Name

Verwendung

ConnectionFactory

Factory-Klasse für die Adapter-Framework MessageFactory und Adapter-Framework Connection.

MessageFactory

Wird für die Sender/Inbound-Richtung verwendet, um Message-Objekte anzulegen, die das Message-Interface implementieren.

Message

Interface zur Veränderung von Adapter-Framework-Messages

MessageKey, MessageDirection

Hilfsklassen, um einen eindeutigen Message-Schlüssel aufzubauen, der aus der Message-ID und der Richtung besteht.

Payload, TextPayload, XMLPayload

Hilfsklassen , um unterschiedliche Payload-Typen von Messages zu verwalten

Party, Service, Action

Unterklassen, um die Adresse (von/nach) einer Message zu verwalten. Die Klasse Action enthält das Interface und den Interface-Namensraum. Sie spezifizieren im Integration Directory das Message-Interface.

DeliverySemantics

Beschreibt Quality-of-Service, der bei der Message angewendet werden soll. Gültige Werte sind:

●      Best-Effort (BE)

●      Exactly-Once (EO)

●      Exactly-Once-In-Order (EOIO)

Connection

Die Connection-Klasse dient hauptsächlich zur Erzeugung von Acknowledgment-Messages, die zum Integration Server geschickt werden sollen.

Exception

Unterschiedliche Exception-Klassen, um Fehlersituationen beschreiben zu können.

RetryControlException kann beispielsweise von einer Adapterimplementierung ausgelöst werden, um den Retry-Modus des Adapter-Framework Messaging-Systems zu kontrollieren.

Setzen Sie RetryModus.STOP_RETRIES in einer ausgelösten RetryControlException, wird das Adapter-Framework Messaging-System die Versuche, eine Message noch einmal zu versenden beenden, so, als ob die maximale Anzahl der Versuche erreicht wurde.

Es ist nötig, diese Exception auszulösen, wenn der Adapter auf eine Fehlersituation stößt, die einen manuellen Eingriff erfordert.

Es wird empfohlen, dann auch einen Alert auszulösen.

Weitere Informationen: Anschluss an den Kommunikationskanal-Monitor, dort unter Prozessstatus

Diese Exception kann auch durch Module im Modul-Prozessor ausgelöst werden, um Senderadaptern mitzuteilen, Wiederholungen zu beenden. Nur Adapter, für die dies ausdrücklich dokumentiert ist, reagieren auf RetryControlException.