Package io.airlift.bootstrap

Class LifeCycleManager

java.lang.Object

io.airlift.bootstrap.LifeCycleManager

public final class LifeCycleManager
extends Object

Manages PostConstruct and PreDestroy life cycles

Constructor Summary

Constructors

Constructor	Description
LifeCycleManager(List<Object> managedInstances, io.airlift.bootstrap.LifeCycleMethodsMap methodsMap)

Method Summary

Modifier and Type	Method	Description
void	addInstance(Object instance)	Add an additional managed instance
int	size()	Returns the number of managed instances
void	start()	Start the life cycle - all instances will have their PostConstruct method(s) called
void	stop()	Stop the life cycle - all instances will have their PreDestroy method(s) called and any exceptions raised will be immediately logged.
void	stopWithoutFailureLogging()	Stop the life cycle - all instances will have their PreDestroy method(s) called and any exceptions raised will be collected and thrown in a wrapped LifeCycleStopException as suppressed exceptions.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

LifeCycleManager

public LifeCycleManager(List<Object> managedInstances,
 io.airlift.bootstrap.LifeCycleMethodsMap methodsMap)
                 throws LifeCycleStartException

Parameters:

managedInstances - list of objects that have life cycle annotations

methodsMap - existing or new methods map

Throws:

LifeCycleStartException - exceptions starting instances (depending on mode)

Method Details

size

public int size()

Returns the number of managed instances

Returns:

qty

start

public void start()
           throws LifeCycleStartException

Start the life cycle - all instances will have their PostConstruct method(s) called

Throws:

LifeCycleStartException

stopWithoutFailureLogging

public void stopWithoutFailureLogging()
                               throws LifeCycleStopException

Stop the life cycle - all instances will have their PreDestroy method(s) called and any exceptions raised will be collected and thrown in a wrapped LifeCycleStopException as suppressed exceptions. Those failures will not be logged and are the responsibility of the caller to handle appropriately.

Throws:

LifeCycleStopException - If any failure occurs during the clean up process

stop

public void stop()
          throws LifeCycleStopException

Stop the life cycle - all instances will have their PreDestroy method(s) called and any exceptions raised will be immediately logged. If any such exceptions occur, a single LifeCycleStopException will be raised at the end of processing which will not contain any reference to exceptions already logged.

Throws:

LifeCycleStopException - If any failure occurs during the clean up process

addInstance

public void addInstance(Object instance)
                 throws LifeCycleStartException

Add an additional managed instance

Parameters:

instance - instance to add

Throws:

LifeCycleStartException - errors during PostConstruct method invocation

IllegalStateException - if the life cycle has been stopped