FileDocCategorySizeDatePackage
LifecycleListener.javaAPI DocGlassfish v2 API3883Fri May 04 22:32:54 BST 2007com.sun.appserv.server

LifecycleListener

public interface LifecycleListener
lifecycle modules implement com.sun.appserv.server.LifecycleListener interface. There is just one method in this interface: handleEvent() which posts server lifecycle events to the lifecycle modules.

Upon start up, before initializing its subsystems application server posts lifcycle modules the INIT_EVENT. This is followed by server posting the STARTUP_EVENT to the lifecycle modules upon which server starts loading and initializaing the applications. Once this phase is completed, the READY_EVENT is posted to the lifecycle modules.

When the server is shutdown, server posts the SHUTDOWN_EVENT to the lifecycle modules and then shuts down the applications and subsystems. Once this phase is completed the TERMINATION_EVENT is posted.

Note that lifecycle modules may obtain the event specific data by calling getData() on the event parameter in the handleEvent(). For the INIT_EVENT event, getData() returns the lifecycle module's properties configured in server.xml.

When is-failure-fatal in server.xml is set to true, all exceptions from the lifecycle modules are treated as fatal conditions.

(Omit source code)

Fields Summary
Constructors Summary
Methods Summary
public voidhandleEvent(LifecycleEvent event)
receive a server lifecycle event

param
event associated event
throws
ServerLifecycleException for exception condition.