Der Listenerassistent unterstützt Sie bei der Erstellung von Lebenszykluslistenern. Er leitet Sie durch den Erstellungsprozess und stellt Ihnen Ausgabedateien zur Verfügung, die Sie unverändert oder angepasst für Ihre Webanwendung
verwenden können. Die Listener können Sie auf Java EE-kompatiblen Webservern ausführen.
Führen Sie die folgenden Schritte aus, um einen Listener zu erstellen:
- Erweitern Sie in der Java EE-Perspektive Ihr dynamisches Projekt in der Sicht 'Projektexplorer'.
- Klicken Sie mit der rechten Maustaste auf das Symbol Listener
und wählen Sie im Kontextmenü aus. Der Assistent für die Erstellung eines Listeners wird angezeigt.
- Folgen Sie den Anweisungen des Projektassistenten.
- Lebenszykluslistener für Anwendungen
- Die Sun Microsystems Java Servlet 2.3-Spezifikation definiert die folgenden Schnittstellen, die
Lebenszykluslistener für Anwendungen repräsentieren. Sie sollten mindestens eine der Schnittstellen auswählen.
- javax.servlet.ServletContextListener: Diese Schnittstelle wird vom Paket 'javax.servlet' bereitgestellt und kann für die Überwachung von Lebenszyklusereignissen des Typs 'ServletContext' verwendet werden. Diese Schnittstelle verfügt über zwei Methoden: 'contextInitialized' und 'contextDestroyed'. Die Methode contextInitialized wird aufgerufen, wenn die Webanwendung für Serviceanforderungen bereit ist, die Methode contextDestroyed wird aufgerufen, wenn der Servlet-Kontext beendet werden soll.
- javax.servlet.ServletContextAttributeListener: Diese Schnittstelle wird vom Paket 'javax.servlet' bereitgestellt. Sie wird verwendet, um Benachrichtigungen zu erhalten, wenn ein Attribut zum Servlet-Kontext hinzugefügt wird oder Attribute des Servlet-Kontexts geändert oder entfernt werden. Diese Schnittstelle verfügt über drei Methoden: attributeAdded, attributeRemoved und attributeReplaced.
- javax.servlet.ServletRequestListener: Diese Schnittstelle wird vom Paket 'javax.servlet' bereitgestellt. Sie kann verwendet werden, um Benachrichtigungen zu erhalten, wenn eine Anforderung in einer Webkomponente innerhalb oder außerhalb eines Bereichs liegt. Diese Schnittstelle verfügt über zwei Methoden: 'requestInitialized' und 'requestDestroyed'. Die Methode requestInitialized wird aufgerufen, wenn das erste Servlet oder der erste Filter in den einzelnen Webanwendungen initialisiert wird. Die Methode requestDestroyed wird aufgerufen, wenn das letzte Servlet oder der erste Filter in der Kette beendet wird.
- javax.servlet.ServletRequestAttributeListener: Diese Schnittstelle wird vom Paket 'javax.servlet' bereitgestellt. Sie kann verwendet werden, um Benachrichtigungen zu erhalten, wenn ein Anforderungsattribut geändert wird. Diese Schnittstelle verfügt über drei Methoden: 'attributeAdded', 'attributeRemoved' und 'attributeReplaced'. Die Methode attributteAdded wird aufgerufen, wenn ein neues Attribut zur Servletanforderung hinzugefügt wurde. Die Methode attributeRemoved wird aufgerufen, wenn ein vorhandenes Attribut aus der Servletanforderung entfernt wurde. Die Methode attributeReplaced wird aufgerufen, wenn ein Attribut in der Servletanforderung ersetzt wurde.
- javax.servlet.http.HttpSessionListener: Diese Schnittstelle wird vom Paket 'javax.servlet.http' bereitgestellt. Sie kann verwendet werden, um Lebenszyklusereignisse von Sitzungen zu überwachen. Diese Schnittstelle verfügt über zwei Methoden: 'sessionCreated' und 'sessionDestroyed'. Die Methode sessionCreated wird aufgerufen, wenn ein Objekt vom Typ 'HttpSession' erstellt wird. Die Methode sessionDestroyed wird aufgerufen, wenn ein Objekt vom Typ 'HttpSession' ungültig gemacht wird.
- javax.servlet.http.HttpSessionActivationListener: Diese Schnittstelle wird vom Paket 'javax.servlet.http' bereitgestellt. Sie kann verwendet werden, um Containerereignisse zu überwachen; dabei werden Benachrichtigungen darüber ausgegeben, dass die Sitzungen passiviert oder aktiviert werden. Diese Schnittstelle verfügt über zwei Methoden: 'sessionDidActivate' und 'sessionWillPasivate'. Die Methode sessionDidActivate wird aufgerufen, wenn die Sitzung soeben aktiviert wurde; die Methode sessionWillPasivate wird aufgerufen, wenn die Sitzung passiviert wird.
- javax.servlet.http.HttpSessionAttributeListener: Diese Schnittstelle wird vom Paket 'javax.servlet.http' bereitgestellt. Sie kann verwendet werden, um Ereignisse zu überwachen, die in Verbindung zu Sitzungsattributen stehen. Diese Schnittstelle verfügt über drei Methoden: 'attributeAdded', 'attributeRemoved' und 'attributeReplaced'. Die Methode attributeAdded wird aufgerufen, wenn ein Attribut zu einem Objekt des Typs 'HttpSession' hinzugefügt wird. Die Methoden attributeRemoved und attributeReplaced werden aufgerufen, wenn ein Attribut des Typs 'HttpSession' entfernt bzw. ersetzt wird.
- javax.servlet.http.HttpSessionBindingListener: Diese Schnittstelle wird vom Paket 'javax.servlet.http' bereitgestellt. Sie kann verwendet werden, um Benachrichtigungen zu erhalten, wenn ein Objekt an eine Sitzung gebunden wird bzw. wenn die Bindung aufgehoben wird. Diese Schnittstelle verfügt über zwei Methoden: 'valueBound' und 'valueUnbound'. Die Methode valueBound wird aufgerufen, wenn das Objekt an eine Sitzung gebunden wurde und die Sitzung identifiziert. Die Methode valueUnbound wird aufgerufen, wenn die Bindung des Objekts an eine Sitzung aufgehoben wurde und die Sitzung identifiziert wurde.
- Änderungswerte
- Die Sun Microsystems Java Servlet 2.3-Spezifikation gibt an,
dass eine Listenerklasse öffentlich (public) sein muss und nicht abstrakt (abstract). Daher können diese Änderungswerte nicht geändert werden. Der einzige für Änderungen verfügbare Änderungswert ist final (final).
- Schnittstellen
- Die Schnittstellen, die Sie auf der vorherigen Seite des Assistenten ausgewählt haben,
werden als Standardwerte im Feld Schnittstellen bereitgestellt. Um weitere Schnittstellen hinzuzufügen,
klicken Sie auf die Schaltfläche Hinzufügen neben diesem Feld.
- Dialog 'Schnittstellenauswahl'
- Dieser Dialog wird angezeigt, wenn Sie sich entscheiden, eine Schnittstelle zu Ihrem Servlet hinzuzufügen.
Während Sie den Namen der Schnittstelle, die Sie hinzufügen wollen, eingeben, wird eine Liste der verfügbaren
Schnittstellen, die im Listenfeld Übereinstimmende Elemente aufgeführt werden,
dynamisch aktualisiert und zeigt nur die Schnittstellen
an, die mit dem Muster übereinstimmen. Wählen Sie eine Schnittstelle aus, um das Qualifikationsmerkmal anzuzeigen.
Wenn Sie fertig sind, klicken Sie auf OK.