SIB: URL-Syntax
Der URL sib: hat die folgende Syntax:
sib:/[Ziel|Pfad]?Eigenschaft_1=Wert_1&Wert_2=Wert_2&...
Erläuterungen: - Eckige Klammern ("[ ]") zeigen an, dass ein Parameter optional ist.
- Der Transporttyp ist sib:, gefolgt von /destination (zur Angabe eines Zieltyps) oder /path (zur Angabe eines Routing-Pfades) gefolgt von einer "Abfragezeichenfolge", die ein oder mehrere Eigenschaften enthält. Die gültigen Eigenschaften werden in den folgenden Abschnitten dieses Artikels beschrieben.
Erforderliche Eigenschaften
Die folgenden Eigenschaften sind erforderlich.
Mit den Eigenschaften wird das Ziel für die Anforderung angegeben.
Anmerkung: Alle Zielnamen müssen vollständig qualifiziert sein, d. h., sie müssen den Namen des
Service Integration Bus sowie den Zielnamen selbst enthalten.
Verwenden Sie die Syntax Bus:Ziel.
Wenn ein Bus- oder Zielname einen Doppelpunkt oder ein Komma enthält, müssen Sie den Namen in
Anführungszeichen ("") setzen. Falls der Name bereits Anführungszeichen enthält, wiederholen Sie das Anführungszeichen.
- destinationName
- Der Name des Ziels.
- path
- Der Routing-Pfad, der sich aus einer Folge von Zielnamen zusammensetzt, die durch Kommata voneinander getrennt werden.
- replyDestinationName
- Der Name des für die Antwort zu verwendenden Ziels.
- inboundService
- Der Name des Service für eingehende Daten, der die von der anfordernden Anwendung verwendete spezifische Verbindung angibt. Sie können diesen Wert weglassen, wenn das Ziel ein Serviceziel mit einem zugehörigen Service für abgehende Daten ist, da der Anforderer in diesem Fall über das Serviceziel eine Verbindung zum Service für abgehende Daten herstellt.
- timeout
- Gibt an, wie lange der Anforderer auf eine Antwort wartet. Der Standardwert ist 60 Sekunden. Der Wert null zeigt eine unbegrenzte Wartezeit an.
Auf Serviceintegrationstechnologien bezogene Eigenschaften
Die folgenden Eigenschaften sind optional. Wenn Sie für eine Eigenschaft keinen Wert angeben, wird der Standardwert verwendet. Weitere Informationen zu den zulässigen Werten für diese Eigenschaften finden Sie in den generierten API-Informationen zur Schnittstelle "SIMessage".
- reliability
- Die Zuverlässigkeit der Anforderungsnachricht.
- timeToLive
- Das Zeitlimit (in Millisekunden) für die Anforderung. Der Wert null entspricht einem
nicht definierten Zeitlimit.
Anmerkung: Die Eigenschaft timeout (siehe Erforderliche Eigenschaften) bestimmt die Zeitverzögerung, nach der die anfordernde Anwendung den Anwendungsthread blockiert, der auf eine Antwort auf eine Anforderung- und Antwortoperation wartet. Die optionalen Eigenschaften timeToLive und replyTimeToLive geben an, wie lange die Anforderungs- und Antwortnachrichten von den Messaging-Engines maximal verarbeitet werden. Die Verarbeitungszeit während der Serviceimplementierung ist hier nicht eingeschlossen. Normalerweise wird als Zeitlimit die Summe aus Lebensdauer der Anforderung und Lebensdauer der Antwort plus einer gewissen Zeit für die Serviceverarbeitung festgelegt.
- priority
- Die Priorität der Anforderungsnachricht.
- user
- Die erforderliche Benutzer-ID für den Zugriff auf das Anforderungsziel.
- password
- Das erforderliche Kennwort für den Zugriff auf das Anforderungsziel.
- replyReliability
- Die Zuverlässigkeit der Antwortnachricht.
- replyTimeToLive
- Das Zeitlimit (in Millisekunden) für die Antwort. Der Wert null entspricht einem nicht definierten Zeitlimit.
- replyPriority
- Die Priorität der Antwortnachricht.
Weitere Eigenschaften
Sie können auch angepasste Eigenschaften in den URL einfügen.
Diese Eigenschaften müssen das Präfix user. haben.
Beispiele:
sib:/destination?destinationName=myBus:myDestination & reliability=assured & user.customData=XYZ
Nach dem Senden der Anforderung ist der URL selbst in den Nachrichteneigenschaften als inbound.url enthalten.