SIP-Server: Konfiguration: AppRouter

Konfigurationsoptionen     

Auf dieser Seite konfigurieren Sie die Features von Application Router (AR) für den SIP-Servlet-Container.

Um eine erste Anforderung zu verarbeiten, ruft der SIP-Servlet-Container zunächst den Application Router (AR) auf. Er stellt die Logik bereit, die zur Auswahl einer geeigneten SIP-Servlet-Anwendung benötigt wird. Ohne Application Router kann ein Container nicht funktionieren, der AR ist jedoch eine vom Container getrennte logische Entität. Der AR ist nur für die Anwendungsauswahl zuständig und darf keine Anwendungslogik implementieren. Der AR kann beispielsweise keine Anforderungen bearbeiten oder Antworten senden. Weitere Informationen finden Sie unter "Composing SIP Applications" im Programmierhandbuch.

Konfigurationsoptionen

Name Beschreibung
AR-Konfigurationsdaten

Eigenschaften, die mit der init-Methode an den Standard-AR oder benutzerdefinierten AR übergeben werden

Alle Konfigurationseigenschaften müssen dem Format für Java-Eigenschaften entsprechen. Wenn Sie Eigenschaften für das DAR eingeben, müssen die Eigenschaften außerdem dem detaillierten Format für Eigenschaften entsprechen, das in Anhang C von SIP Servlet Specification v1.1 beschrieben wird. Benutzerdefinierte AR-Implementierungen können ein detailliertes Eigenschaftenformat verwenden, das von dem in Anhang C beschriebenen abweicht. Ein benutzerdefinierter AR muss die Konfigurationsdaten validieren.

Sie können optional AR-Initialisierungseigenschaften angeben, wenn Sie die WebLogic Communications Server-Instanz starten. Hierfür müssen Sie die Java-Option -Djavax.servlet.sip.ar.dar.configuration aufnehmen. (Wenn Sie statt eines URI eine Eigenschaftendatei angeben möchten, fügen Sie das Präfix file:/// ein.) Wenn Sie die Java-Startup-Option angeben, ignoriert der Container alle Konfigurationsoptionen, die in den AR-Konfigurationsdaten definiert wurden. Sie können die Eigenschaften in den AR-Konfigurationsdaten jederzeit ändern. Die Eigenschaften werden jedoch erst dann an·den·AR·übergeben,·wenn·der·Server·neu·gestartet·und·dabei·die·Option·-Djavax.servlet.sip.ar.dar.configuration weggelassen wird.

MBean-Attribut:
AppRouterBean.AppRouterConfigData

Änderungen werden wirksam, nachdem Sie das Modul erneut bereitgestellt oder den Server neu gestartet haben.

Benutzerdefinierten AR verwenden

Statt des Standard-Application Router wird ein benutzerdefinierter Application Router verwendet.

MBean-Attribut:
AppRouterBean.UseCustomAppRouter

Änderungen werden wirksam, nachdem Sie das Modul erneut bereitgestellt oder den Server neu gestartet haben.

Benutzerdefinierter AR-Dateiname

Der benutzerdefinierte AR JAR-Dateiname (muss im Verzeichnis $DOMAIN_HOME/approuter gespeichert werden)

MBean-Attribut:
AppRouterBean.CustomAppRouterJarFileName

Änderungen werden wirksam, nachdem Sie das Modul erneut bereitgestellt oder den Server neu gestartet haben.

Standardanwendungsname

Der Name der Standardanwendung, die der Container aufrufen soll, wenn der benutzerdefinierte AR keine Anwendung findet, um eine erste Anforderung zu verarbeiten.

Ist keine Standardanwendung angegeben, gibt der Container den Fehler 500 zurück, wenn AR keine Anwendung auswählen kann.

Hinweis: Sie können nur Namen von bereitgestellten Anwendungen als Standardanwendungsname angeben.

MBean-Attribut:
AppRouterBean.DefaultApplicationName