Package com.sun.appserv.server

Interface 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.

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    handleEvent(LifecycleEvent event)
    receive a server lifecycle event