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

Methods

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

Method Detail

handleEvent

void handleEvent(LifecycleEvent event)
                 throws ServerLifecycleException

receive a server lifecycle event

Parameters:

event - associated event

Throws:

- ServerLifecycleException for exception condition.

ServerLifecycleException