org.jboss.soa.esb.listeners.lifecycle
Interface ManagedLifecycle

All Known Implementing Classes:
AbstractFileGateway, AbstractManagedLifecycle, AbstractThreadedManagedLifecycle, FileGatewayListener, GroovyGateway, JBossRemotingGatewayListener, JmsGatewayListener, MessageAwareListener, RemoteGatewayListener, SqlTableGatewayListener

public interface ManagedLifecycle


Method Summary
 void addManagedLifecycleEventListener(ManagedLifecycleEventListener listener)
          Add a managed lifecycle event listener.
 void destroy()
          Destroy the managed instance.
 ManagedLifecycleState getState()
          Get the state of the managed instance.
 void initialise()
          Initialise the managed instance.
 void removeManagedLifecycleEventListener(ManagedLifecycleEventListener listener)
          Remove a managed lifecycle event listener.
 void start()
          Start the managed instance.
 void stop()
          Stop the managed instance.
 boolean waitUntilDestroyed()
          Wait until the managed instance has transitioned into the DESTROYED state.
 boolean waitUntilDestroyed(long transitionPeriod)
          Wait until the managed instance has transitioned into the DESTROYED state.
 

Method Detail

initialise

void initialise()
                throws ManagedLifecycleException
Initialise the managed instance.

This method is called after the managed instance has been instantiated so that configuration options can be validated.

Throws:
ManagedLifecycleException - for errors during initialisation.

start

void start()
           throws ManagedLifecycleException
Start the managed instance.

This method is called to inform the managed instance that it can initialise resources prior to enabling the service.

Throws:
ManagedLifecycleException

stop

void stop()
          throws ManagedLifecycleException
Stop the managed instance.

This method is called to inform the managed instance that it must disable resources associated with the running service. The service may choose to disable the resources asynchronously provided that any subsequent call to start() or destroy() blocks until these resources have been disabled.

Throws:
ManagedLifecycleException

destroy

void destroy()
             throws ManagedLifecycleException
Destroy the managed instance.

This method is called prior to the release of the managed instance. All resources associated with this managed instance should be released as the instance will no longer be used.

Throws:
ManagedLifecycleException

getState

ManagedLifecycleState getState()
Get the state of the managed instance.

Returns:
The managed instance state.

waitUntilDestroyed

boolean waitUntilDestroyed()
Wait until the managed instance has transitioned into the DESTROYED state.

Returns:
true if the transition occurs within the expected period, false otherwise.

waitUntilDestroyed

boolean waitUntilDestroyed(long transitionPeriod)
Wait until the managed instance has transitioned into the DESTROYED state.

Parameters:
transitionPeriod - The maximum delay expected for the transition, specified in milliseconds.
Returns:
true if the transition occurs within the expected period, false otherwise.

addManagedLifecycleEventListener

void addManagedLifecycleEventListener(ManagedLifecycleEventListener listener)
Add a managed lifecycle event listener.

Parameters:
listener - The listener.

removeManagedLifecycleEventListener

void removeManagedLifecycleEventListener(ManagedLifecycleEventListener listener)
Remove a managed lifecycle event listener.

Parameters:
listener - The listener.