SIP 1.1-Annotationen

Ab SIP 1.1 können Sie Annotationen in SIP-Servletanwendungen verwenden. Sie können Annotation verwenden, um Daten direkt in eine Anwendung zu integrieren, anstatt den Implementierungsdeskriptor zu verwenden.

In SIP 1.1 verfügbare Annotationen

Die folgenden Annotationen sind in SIP 1.1 verfügbar:
  • @SipApplication
  • @SipServlet
  • @SipListener
  • @SipApplicationKey
Tipp: Sie können weiterhin Implementierungsdeskriptoren anstelle von Annotationen verwenden. Implementierungsdeskriptoren setzen Einstellungen außer Kraft, die in den Annotationen beschrieben sind.

Annotation "@SipApplication"

Die Annotation "@SipApplication" definiert allgemeine Konfigurationsdaten für eine Anwendung. Es handelt sich um eine Annotation auf Paketebene, die sich in einer Datei mit dem Namen package-info.java befinden muss. Alle Servlets im Paket gehören zu derselben Anwendung.
Wichtig: Beim Container für jede WAR- oder SAR-Datei kann unabhängig davon, ob ein Implementierungsdeskriptor oder Annotationen verwendet werden, jeweils nur eine einzige SIP-Anwendung registriert werden.

Tabelle 1. Eigenschaften für @SipApplication und Zuordnung zu entsprechenden Implementierungsdeskriptorelementen
Annotationseigenschaft Implementierungsdeskriptorelement Beschreibung Standardannotationswert
name <app-name> Der Name der SIP-Anwendung. Erforderliches Feld
displayName <display-name> Der angezeigte Name der Anwendung. Anwendungsname
description <description> Bechreibt die Anwendung. Leere Zeichenfolge
smallicon <small-icon> Pfad mit der Position des kleinen Symbols. Leere Zeichenfolge
largeicon <large-icon> Pfad mit der Position des großen Symbols. Leere Zeichenfolge
distributable <destributable> Gibt an, ob die Anwendung in einer dezentralen Umgebung funktionieren kann. False (boolesch)
proxyTimeout <proxy-timeout> Standardzeitlimit für alle Proxy-Operationen. Drei Minuten, in Sekunden angegeben
sessionTimeout <session-timeout> Standardzeitlimit für alle Anwendungssitzungsoperationen. Drei Minuten, in Minuten angegeben
mainServlet <main-servlet> Gibt das SIP-Servlet an, das als Main-Servlet konzipiert ist. Leere Zeichenfolge

Annotation "@SipServlet"

Die Annotation "@SipServlet" gibt an, dass eine Klasse ein SIP-Servlet ist.

Tabelle 2. Eigenschaften für @SipServlet und Zuordnung zu entsprechenden Implementierungsdeskriptorelementen
Annotationseigenschaft Implementierungsdeskriptorelement Beschreibung Standardannotationswert
@SipServletServlet <servlet-class> Gibt an, dass die Klasse ein SIP-Servlet ist. Die Annotation ist für die Klasse deklariert
name <servlet-name> Der Name des Servlets. Kurzname der annotierten Klasse
applicationName <app-name> Der Name der Anwendung. (Optional) Kann im Implementierungsdeskriptor oder mit @SipApplication definiert werden
loadOnStartup <load-on-startup> Definiert die Startreihenfolge der Servletanwendung. Eine negative Zahl (veranlasst den Container auszuwählen, wann dieses Servlet gestartet werden soll)

Annotation "@SipListener"

Die Annotation "@SipListener" stellt eine Alternative zum Implementierungsdeskriptorelement <listener> dar.

Die Annotation "@SipListener" hat keine erforderlichen Felder, kann aber einen optionalen Anwendungsnamen und eine optionale Beschreibung haben. Die von @SipListener annotierte Klasse muss mindestens eine Listenerschnittstelle implementieren.

Annotation "@SipApplicationKey"

Die Annotation "@SipApplicationKey" markiert die Methode, die eine eingehende Anforderung und SIP-Sitzung (SipSession) einer bestimmten SIP-Anwendungssitzung (SipApplicationSession) zuordnet. Sie verwenden diese Annotation mit sitzungsschlüsselbasiertem Ziel.

Icon that indicates the type of topic Reference topic
Timestamp icon Last updated: last_date

File name: SIP_dd_mappingtoservlet.html