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.