Methode

Bedeutung

public void setMessagingTimeoutInMSec
(long timeout);

Legt die Gültigkeitsdauer einer Message fest:

·      Kann eine asynchrone Message nicht innerhalb der Gültigkeitsdauer an den Integration Server versendet werden, wird sie für das MS-Monitoring persistiert.

·      Erhält das Messaging-System auf eine synchrone Message innerhalb der Gültigkeitsdauer keine Response-Message, wird ein Fehler an die Anwendung zurückgegeben. Falls die Response-Message danach noch empfangen wird, persistiert das Messaging-System diese Message ebenfalls für das MS-Monitoring.

public void
setQueueId(String id)

Mit dieser Methode können Sie hintereinander mehreren asynchronen Messages einen Serialisierungskontext zuweisen, um für diese Messages den Quality of Service exactly once in order zu garantieren. Der String id darf höchstens 16 Zeichen lang sein und nur Großbuchstaben enthalten. Alle asychronen Messages mit dem gleichen Serialisierungskontext werden beim Empfänger in der gleichen Reihenfolge empfangen, wie sie beim COMMIT WORK auf der Sender-Seite in die Ausgangs-Queue aufgenommen worden sind.

public String
getQueueId()

Gibt den vorher gesetzten Serialisierungskontext zurück.

Methode

Bedeutung

public String getInputPayload()

Gibt die Payload der Input-Message zurück (nach dem Aufruf eines Client-Proxies oder während der Inbound-Verarbeitung)

public String getOutputPayload()

Gibt die Payload der Output-Message zurück (nach dem Aufruf eines Client-Proxies)

public void
setPayload(
String payload )

Mit dieser Methode können Sie die Payload selbst setzen, anstatt sie über die an das Proxy übergebenen Daten erzeugen zu lassen. In diesem Fall ist die Anwendung für das korrekte Format der Payload verantwortlich. Die Proxy-Laufzeit füllt nur den Message-Header und leitet die Message mit der übergebenen Payload weiter.

Methode

Bedeutung

public void addReceiverService( String service)

Hinzufügen eines Service zur Menge aller Empfänger-Services des Client-Proxies

public void addReceiver(
 java.lang.String partyName,
 java.lang.String partyAgency,
 java.lang.String partyScheme,
 java.lang.String service)

Hinzufügen eines Empfängers zur Menge aller Empfänger des Client-Proxies. Die Angabe von Kommunikationspartner, vergebender Agentur und Identifikationsschema ist wichtig bei Unternehmens-übergreifender Kommunikation.

public boolean removeReceiverService(String service)

Löschen eines spezifizierten Service aus der Menge aller Empfänger-Services des Server-Proxies

public void clearReceivers()

Löschen aller spezifizierten Empfänger.

Methode

Bedeutung

public MessageAttachment createAttachment( String name, String type, Object data)

Erzeugt ein neues Attachment-Objekt. Für type sollte der MIME-Type angegeben werden (zum Beispiel 'text/html').

public MessageAttachment addAttachment( String name, String type, Object data)

Erzeugt ein neues Attachment-Objekt, fügt dieses der Menge der Attachments hinzu und gibt das Attachment-Objekt zurück.

public void addAttachment( MessageAttachment attachment)

Fügt der Menge der Attachments ein neues hinzu.

public boolean removeAttachment(MessageAttachment attachment);

Löscht das spezifizierte Attachment

public void clearAttachments();

Löscht alle Attachments. Diese Methode sollten Sie auf jeden Fall auf Empfängerseite aufrufen, damit empfangene Attachments nicht zurückgeschickt werden.

public MessageAttachment getAttachment(String name);

Gibt das Attachment mit dem Namen name zurück.

public java.util.Enumeration getAttachments();

Gibt eine Aufzählung aller Attachments zurück.

Methode

Bedeutung

public String
getSenderService()

Ermitteln des Service einer empfangenen Message beim Empfänger.

public String
getSenderPartyName()

Ermitteln des Namens eines Kommunikationspartners einer empfangenen Message beim Empfänger.

public String
getSenderPartyAgency()

Ermitteln der vergebenen Agentur einer empfangenen Message beim Empfänger.

public String
getSenderPartyScheme()

Ermitteln des Identifikationsschemas einer empfangenen Message beim Empfänger.

Methode

Bedeutung

public
com.sap.guid.IGUID
getMessageID()

Abfrage der Message-ID bei Empfang einer Message. Mit der Methode toString() erhalten Sie die String-Repräsentation der ID.

public
com.sap.guid.IGUID
getMessageIDLastSent()

Abfrage der Message-ID nach dem Versenden einer Message. Mit der Methode toString() erhalten Sie die String-Repräsentation der ID.

public com.sap.guid.IGUID
getRefToMessageID

Abfrage der ID einer Message, die von dieser Message referenziert wird. Beispielsweise ‚merkt’ sich eine Response-Message über dieses Feld zu welcher Request-Message sie gehört.

Methode

Angefordertes Acknowledgment
und Bedeutung

public void
setSystemAckRequested(
String ackListenerName)

Positives System-Acknowledgment

Der Empfänger wurde erfolgreich erreicht; für Server-Proxies bedeutet dies, dass die implementierende Klasse zum Server-Proxy gefunden wurde und die Methode zur Inbound-Verarbeitung aufgerufen werden konnte.

public void
setSystemErrorAckRequested(
String ackListenerName)

Negatives System-Acknowledgment

Die Laufzeit der Exchange Infrastructure meldet einen Fehler während der Übertragung beziehungsweise der Verarbeitung der Message auf dem Weg zum Empfänger. Beispielsweise kann ein Fehler in einem Mapping-Programm oder ein nicht im Empfängersystem vorhandenes Server-Proxy dieses Acknowledgment auslösen.

public void
setApplicationAckRequested(
String ackListenerName)

Positives Anwendungs-Acknowledgment

Die Message wurde vom Empfänger erfolgreich verarbeitet.

public void
setApplicationErrorAckRequested(
String ackListenerName)

Negatives Anwendungs-Acknowledgment

Während der Verarbeitung der Message beim Empfänger ist ein Fehler aufgetreten.