org.apache.avalon.phoenix
Interface ApplicationListener

All Superinterfaces:

BlockListener, EventListener

public interface ApplicationListener

extends EventListener, BlockListener

Implementations of this interface receive notifications about changes to the state of Application. The implementation must have a zero argument constructor and is instantiated before any other component of the Server Application. To receive notification events, the implementation class should be specified in the assembly.xml descriptor.

Author:

Peter Donald

Method Summary

void	applicationFailure(Exception causeOfFailure) Notification that an application has failed at some moment.
void	applicationStarted() Notification that an application has now started.
void	applicationStarting(ApplicationEvent applicationEvent) Notification that an application is being started.
void	applicationStopped() Notification that an application has stopped.
void	applicationStopping() Notification that an application is being stopped.
void	blockAdded(BlockEvent event) Notification that a block has just been added to Server Application.
void	blockRemoved(BlockEvent event) Notification that a block is just about to be removed from Server Application.

Method Detail

blockAdded

public void blockAdded(BlockEvent event)

Notification that a block has just been added to Server Application.

Specified by:

blockAdded in interface BlockListener

Parameters:

event - the BlockEvent

blockRemoved

public void blockRemoved(BlockEvent event)

Notification that a block is just about to be removed from Server Application.

Specified by:

blockRemoved in interface BlockListener

Parameters:

event - the BlockEvent

applicationStarting

public void applicationStarting(ApplicationEvent applicationEvent)
                         throws Exception

Notification that an application is being started.

Parameters:

applicationEvent - the ApplicationEvent

Exception

applicationStarted

public void applicationStarted()

Notification that an application has now started.

applicationStopping

public void applicationStopping()

Notification that an application is being stopped.

applicationStopped

public void applicationStopped()

Notification that an application has stopped.

applicationFailure

public void applicationFailure(Exception causeOfFailure)

Notification that an application has failed at some moment. This is for information only as Phoenix will do the right thing for correct shutdown both before and after this method is called. The user of this method should NOT call System.exit()

Parameters:

causeOfFailure -