Nachrichten ohne Entsprechung in Session Initiation Protocol (SIP) in Liberty empfangen

Verwenden Sie die UnmatchedMessageListener-API, um eingehende SIP-Anforderungsnachrichten oder -Antwortnachrichten zu empfangen, die nicht vom SIP-Container verarbeitet werden können.

Vorbereitende Schritte

Installieren und konfigurieren Sie das Feature sipServlet-1.1 in Ihrer Datei server.xml. Weitere Informationen finden Sie unter Session Initiation Protocol (SIP) in Liberty verwalten.

Informationen zu diesem Vorgang

Der SIP-Container stellt eine Schnittstelle bereit, mit der eine Anwendung alle eingehenden Anforderungs- oder Antwortnachrichten empfangen kann, die keinem vorhandenen Dialog entsprechen. Alle Anforderungs- oder Antwortnachrichten, die keinem vorhandenen Dialog entsprechen, werden als Nachrichten ohne Entsprechung bezeichnet.

Eine Anforderung ohne Entsprechung ist eine Anforderung mit den Tags To und From, für die im SIP-Container kein zugehöriger Dialog gefunden wurde, weil kein Dialog erstellt wurde oder der Dialog ungültig ist. Wenn ein SIP-Container eine eingehende Anforderung ohne Entsprechung empfängt, antwortet der Container mit 481 Call/Transaction Does Not Exist und leitet die eingehende Anforderung dann an die Listenerklasse weiter. Die eingehende Anforderung wird im Rahmen des Ereignisses "UnmatchedRequestEvent" weitergeleitet, das im Paket "com.ibm.websphere.sip.unmatchedMessages.events" definiert ist. Das Ereignis enthält eine Schnittstelle zum Abrufen der eingehenden Anforderung ohne Entsprechung und des Servletkontexts (ServletContext) für die Anwendung, die das Ereignis empfängt. Die Anwendung kann den ServletContext verwenden, um eine neue SIP-Aktivität zu erstellen. Der Listener kann weder eine Antwort für die empfangene Anforderung ohne Entsprechung erstellen noch die Anforderung weiterleiten. Tritt diese Bedingung ein, wird die Ausnahme "IllegalStateException" im SIP-Container ausgelöst.

Eine Antwort ohne Entsprechung ist eine Antwort, die im SIP-Container empfangen wird, aber keiner abgehenden Anforderung entspricht. Bevor der SIP-Container die Antwort ohne Entsprechung verwirft, wird sie im Rahmen des Ereignisses "UnmatchedResponseEvent" an den Listener "UnmatchedMessageListener" gesendet. Ähnlich wie bei der Anforderung ohne Entsprechung erhält die Anwendung Zugriff auf die Antwort ohne Entsprechung und auf den zugehörigen ServletContext für die Anwendung.

Wenn für eine Anwendung mehrere Listener vom Typ "UnmatchedMessageListener" definiert sind, werden die Listener unabhängig voneinander gestartet. Wenn ein einzelner Anwendungsserver mehrere Anwendungen enthält und mehrere Anwendungen Listener vom Typ "UnmatchedMessageListener" haben, werden alle Listener in einer Zufallsreihenfolge gestartet. Sendet eine Anwendung auf demselben Server im Rahmen der Anwendungskomposition eine Anforderung an eine andere Anwendung und stellt der SIP-Container fest, dass er diese Anforderung nicht verarbeiten kann, werden alle Listener vom Typ "UnmatchedMessageListener" auf diesem Server aktiviert.

Die UnmatchedMessageListener-API ist in der Datei com.ibm.websphere.appserver.api.sipServlet des Pakets "com.ibm.websphere.sip.unmatchedMessages" definiert.

Vorgehensweise

Sie können eine der folgenden Methoden im Anwendungscode für den Zugriff auf die UnmatchedMessageListener-API verwenden:


Symbol das den Typ des Artikels anzeigt. Taskartikel



Symbol für Zeitmarke Letzte Aktualisierung: 01.12.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twlp_sip_unmatchedmsg_api
Dateiname: twlp_sip_unmatchedmsg_api.html