org.eclipse.jetty.util.component

Class ContainerLifeCycle

java.lang.Object

org.eclipse.jetty.util.component.AbstractLifeCycle

org.eclipse.jetty.util.component.ContainerLifeCycle

All Implemented Interfaces:

Container, Destroyable, Dumpable, LifeCycle

Direct Known Subclasses:

AbstractConnectionFactory, AbstractConnector, AbstractExtension, AbstractHandler, AbstractHttpClientTransport, AbstractSessionManager, ClientContainer, ConnectionManager, DelegatingThreadPool, DeploymentManager, ExtensionStack, HttpClient, LeakTrackingByteBufferPool, ServletTester, SPDYClient.Factory, WebSocketClient, WebSocketServerFactory, WebSocketSession, WebSocketUpgradeFilter

@ManagedObject(value="Implementation of Container and LifeCycle")
public class ContainerLifeCycle
extends AbstractLifeCycle
implements Container, Destroyable, Dumpable

Nested Class Summary

Nested classes/interfaces inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

AbstractLifeCycle.AbstractLifeCycleListener

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.component.Container

Container.InheritedListener, Container.Listener

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.component.LifeCycle

LifeCycle.Listener

Field Summary

Fields inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

FAILED, RUNNING, STARTED, STARTING, STOPPED, STOPPING

Constructor Summary

Constructors

Constructor and Description
ContainerLifeCycle()

Method Summary

Methods

Modifier and Type	Method and Description
boolean	addBean(Object o) Adds the given bean, detecting whether to manage it or not.
boolean	addBean(Object o, boolean managed) Adds the given bean, explicitly managing it or not.
boolean	addBean(Object o, org.eclipse.jetty.util.component.ContainerLifeCycle.Managed managed)
void	addEventListener(Container.Listener listener) Add an event listener.
void	addManaged(LifeCycle lifecycle) Add a managed lifecycle.
boolean	contains(Object bean)
void	destroy() Destroys the managed Destroyable beans in the reverse order they were added.
protected void	doStart() Starts the managed lifecycle beans in the order they were added.
protected void	doStop() Stops the managed lifecycle beans in the reverse order they were added.
String	dump()
void	dump(Appendable out)
void	dump(Appendable out, String indent)
static void	dump(Appendable out, String indent, Collection<?>... collections)
static String	dump(Dumpable dumpable)
protected void	dumpBeans(Appendable out, String indent, Collection<?>... collections)
static void	dumpObject(Appendable out, Object o)
void	dumpStdErr() Dumps to System.err.
protected void	dumpThis(Appendable out)
<T> T	getBean(Class<T> clazz)
Collection<Object>	getBeans()
<T> Collection<T>	getBeans(Class<T> clazz)
boolean	isManaged(Object bean)
void	manage(Object bean) Manages a bean already contained by this aggregate, so that it is started/stopped/destroyed with this aggregate.
boolean	removeBean(Object o) Removes the given bean.
void	removeBeans() Removes all bean
void	removeEventListener(Container.Listener listener) Remove an event listener.
void	setBeans(Collection<Object> beans)
void	setStopTimeout(long stopTimeout)
protected void	start(LifeCycle l) Starts the given lifecycle.
protected void	stop(LifeCycle l) Stops the given lifecycle.
void	unmanage(Object bean) Unmanages a bean already contained by this aggregate, so that it is not started/stopped/destroyed with this aggregate.
void	updateBean(Object oldBean, Object newBean)
void	updateBeans(Object[] oldBeans, Object[] newBeans)

Methods inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

addLifeCycleListener, getState, getState, getStopTimeout, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, removeLifeCycleListener, start, stop

Methods inherited from class java.lang.Object

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

Constructor Detail

ContainerLifeCycle

public ContainerLifeCycle()

Method Detail

doStart

protected void doStart()
                throws Exception

Starts the managed lifecycle beans in the order they were added.

Overrides:

doStart in class AbstractLifeCycle

Throws:

Exception

start

protected void start(LifeCycle l)
              throws Exception

Starts the given lifecycle.

Parameters:

l -

Throws:

Exception

stop

protected void stop(LifeCycle l)
             throws Exception

Stops the given lifecycle.

Parameters:

l -

Throws:

Exception

doStop

protected void doStop()
               throws Exception

Stops the managed lifecycle beans in the reverse order they were added.

Overrides:

doStop in class AbstractLifeCycle

Throws:

Exception

destroy

public void destroy()

Destroys the managed Destroyable beans in the reverse order they were added.

Specified by:

destroy in interface Destroyable

contains

public boolean contains(Object bean)

Parameters:

bean - the bean to test

Returns:

whether this aggregate contains the bean

isManaged

public boolean isManaged(Object bean)

Parameters:

bean - the bean to test

Returns:

whether this aggregate contains and manages the bean

addBean

public boolean addBean(Object o)

Adds the given bean, detecting whether to manage it or not. If the bean is a LifeCycle, then it will be managed if it is not already started and not managed if it is already started. The addBean(Object, boolean) method should be used if this is not correct, or the manage(Object) and unmanage(Object) methods may be used after an add to change the status.

Specified by:

addBean in interface Container

Parameters:

o - the bean object to add

Returns:

true if the bean was added, false if it was already present

addBean

public boolean addBean(Object o,
              boolean managed)

Adds the given bean, explicitly managing it or not.

Parameters:

o - The bean object to add

managed - whether to managed the lifecycle of the bean

Returns:

true if the bean was added, false if it was already present

addBean

public boolean addBean(Object o,
              org.eclipse.jetty.util.component.ContainerLifeCycle.Managed managed)

addManaged

public void addManaged(LifeCycle lifecycle)

Add a managed lifecycle.

This is a conveniance method that uses addBean(lifecycle,true) and then ensures that the added bean is started iff this container is running. Exception from nested calls to start are caught and wrapped as RuntimeExceptions

Parameters:

lifecycle -

addEventListener

public void addEventListener(Container.Listener listener)

Description copied from interface: Container

Add an event listener.

Specified by:

addEventListener in interface Container

See Also:

Container.addBean(Object)

manage

public void manage(Object bean)

Manages a bean already contained by this aggregate, so that it is started/stopped/destroyed with this aggregate.

Parameters:

bean - The bean to manage (must already have been added).

unmanage

public void unmanage(Object bean)

Unmanages a bean already contained by this aggregate, so that it is not started/stopped/destroyed with this aggregate.

Parameters:

bean - The bean to unmanage (must already have been added).

getBeans

public Collection<Object> getBeans()

Specified by:

getBeans in interface Container

Returns:

the list of beans known to this aggregate

See Also:

Container.getBean(Class)

setBeans

public void setBeans(Collection<Object> beans)

getBeans

public <T> Collection<T> getBeans(Class<T> clazz)

Specified by:

getBeans in interface Container

Parameters:

clazz - the class of the beans

Returns:

the list of beans of the given class (or subclass)

See Also:

Container.getBeans()

getBean

public <T> T getBean(Class<T> clazz)

Specified by:

getBean in interface Container

Parameters:

clazz - the class of the bean

Returns:

the first bean of a specific class (or subclass), or null if no such bean exist

removeBeans

public void removeBeans()

Removes all bean

removeBean

public boolean removeBean(Object o)

Description copied from interface: Container

Removes the given bean. If the bean is-a Container.Listener, then also do an implicit Container.removeEventListener(Listener).

Specified by:

removeBean in interface Container

Returns:

whether the bean was removed

removeEventListener

public void removeEventListener(Container.Listener listener)

Description copied from interface: Container

Remove an event listener.

Specified by:

removeEventListener in interface Container

See Also:

Container.removeBean(Object)

setStopTimeout

public void setStopTimeout(long stopTimeout)

Overrides:

setStopTimeout in class AbstractLifeCycle

dumpStdErr

@ManagedOperation(value="Dump the object to stderr")
public void dumpStdErr()

Dumps to System.err.

See Also:

dump()

dump

@ManagedOperation(value="Dump the object to a string")
public String dump()

Specified by:

dump in interface Dumpable

dump

public static String dump(Dumpable dumpable)

dump

public void dump(Appendable out)
          throws IOException

Throws:

IOException

dumpThis

protected void dumpThis(Appendable out)
                 throws IOException

Throws:

IOException

dumpObject

public static void dumpObject(Appendable out,
              Object o)
                       throws IOException

Throws:

IOException

dump

public void dump(Appendable out,
        String indent)
          throws IOException

Specified by:

dump in interface Dumpable

Throws:

IOException

dumpBeans

protected void dumpBeans(Appendable out,
             String indent,
             Collection<?>... collections)
                  throws IOException

Throws:

IOException

dump

public static void dump(Appendable out,
        String indent,
        Collection<?>... collections)
                 throws IOException

Throws:

IOException

updateBean

public void updateBean(Object oldBean,
              Object newBean)

updateBeans

public void updateBeans(Object[] oldBeans,
               Object[] newBeans)