Class ContainerLifeCycle
- java.lang.Object
-
- org.eclipse.jetty.util.component.AbstractLifeCycle
-
- org.eclipse.jetty.util.component.ContainerLifeCycle
-
- All Implemented Interfaces:
Container
,Destroyable
,Dumpable
,Dumpable.DumpableContainer
,LifeCycle
- Direct Known Subclasses:
AbstractConnectionFactory
,AbstractConnectionPool
,AbstractConnector
,AbstractHandler
,AbstractHttpClientTransport
,AbstractLoginService
,AbstractNCSARequestLog
,AbstractSessionCache
,AbstractSessionDataStore
,AttributeContainerMap
,CachingSessionDataStore
,ConfigurableSpnegoLoginService
,ConnectionManager
,CustomRequestLog
,DefaultSessionIdManager
,EatWhatYouKill
,ExecutorThreadPool
,ExtensionStack
,HttpClient
,HttpDestination
,KeyStoreScanner
,LeakTrackingByteBufferPool
,LowResourceMonitor
,ManagedSelector
,NativeWebSocketConfiguration
,QueuedThreadPool
,SelectorManager
,SimpleContainerScope
,WebSocketClient
,WebSocketServerFactory
,WebSocketSession
@ManagedObject("Implementation of Container and LifeCycle") @Deprecated(since="2021-05-27") public class ContainerLifeCycle extends AbstractLifeCycle implements Container, Destroyable, Dumpable.DumpableContainer
Deprecated.The Eclipse Jetty and Apache Felix Http Jetty packages are no longer supported.A ContainerLifeCycle is anLifeCycle
implementation for a collection of contained beans.Beans can be added to the ContainerLifeCycle either as managed beans or as unmanaged beans. A managed bean is started, stopped and destroyed with the aggregate. An unmanaged bean is associated with the aggregate for the purposes of
dump()
, but its lifecycle must be managed externally.When a
LifeCycle
bean is added without a managed state being specified the state is determined heuristically:- If the added bean is running, it will be added as an unmanaged bean.
- If the added bean is !running and the container is !running, it will be added as an AUTO bean (see below).
- If the added bean is !running and the container is starting, it will be added as a managed bean and will be started (this handles the frequent case of new beans added during calls to doStart).
- If the added bean is !running and the container is started, it will be added as an unmanaged bean.
When stopping the container, a contained bean will be stopped by this aggregate only if it is started by this aggregate.
The methods
addBean(Object, boolean)
,manage(Object)
andunmanage(Object)
can be used to explicitly control the life cycle relationship.If adding a bean that is shared between multiple
ContainerLifeCycle
instances, then it should be started before being added, so it is unmanaged, or the API must be used to explicitly set it as unmanaged.This class also provides utility methods to dump deep structures of objects. In the dump, the following symbols are used to indicate the type of contained object:
SomeContainerLifeCycleInstance +- contained POJO instance += contained MANAGED object, started and stopped with this instance +~ referenced UNMANAGED object, with separate lifecycle +? referenced AUTO object that could become MANAGED or UNMANAGED.
-
-
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.Dumpable
Dumpable.DumpableContainer
-
Nested classes/interfaces inherited from interface org.eclipse.jetty.util.component.LifeCycle
LifeCycle.Listener
-
-
Constructor Summary
Constructors Constructor Description ContainerLifeCycle()
Deprecated.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description boolean
addBean(java.lang.Object o)
Deprecated.Adds the given bean, detecting whether to manage it or not.boolean
addBean(java.lang.Object o, boolean managed)
Deprecated.Adds the given bean, explicitly managing it or not.void
addEventListener(Container.Listener listener)
Deprecated.Add an event listener.void
addManaged(LifeCycle lifecycle)
Deprecated.Adds a managed lifecycle.boolean
contains(java.lang.Object bean)
Deprecated.void
destroy()
Deprecated.Destroys the managed Destroyable beans in the reverse order they were added.java.lang.String
dump()
Deprecated.void
dump(java.lang.Appendable out)
Deprecated.Dump this object to an Appendable with no indent.void
dump(java.lang.Appendable out, java.lang.String indent)
Deprecated.Dump this object (and children) into an Appendable using the provided indent after any new lines.static void
dump(java.lang.Appendable out, java.lang.String indent, java.util.Collection<?>... collections)
Deprecated.static java.lang.String
dump(Dumpable dumpable)
Deprecated.useDumpable.dump(Dumpable)
insteadstatic void
dumpObject(java.lang.Appendable out, java.lang.Object obj)
Deprecated.useDumpable.dumpObject(Appendable, Object)
insteadvoid
dumpStdErr()
Deprecated.Dumps toSystem.err
.<T> T
getBean(java.lang.Class<T> clazz)
Deprecated.java.util.Collection<java.lang.Object>
getBeans()
Deprecated.<T> java.util.Collection<T>
getBeans(java.lang.Class<T> clazz)
Deprecated.<T> java.util.Collection<T>
getContainedBeans(java.lang.Class<T> clazz)
Deprecated.boolean
isAuto(java.lang.Object bean)
Deprecated.boolean
isManaged(java.lang.Object bean)
Deprecated.Test if this container manages a beanboolean
isUnmanaged(java.lang.Object bean)
Deprecated.void
manage(java.lang.Object bean)
Deprecated.Manages a bean already contained by this aggregate, so that it is started/stopped/destroyed with this aggregate.boolean
removeBean(java.lang.Object o)
Deprecated.Removes the given bean.void
removeBeans()
Deprecated.Removes all beanvoid
removeEventListener(Container.Listener listener)
Deprecated.Remove an event listener.void
setBeans(java.util.Collection<java.lang.Object> beans)
Deprecated.void
setStopTimeout(long stopTimeout)
Deprecated.void
unmanage(java.lang.Object bean)
Deprecated.Unmanages a bean already contained by this aggregate, so that it is not started/stopped/destroyed with this aggregate.void
updateBean(java.lang.Object oldBean, java.lang.Object newBean)
Deprecated.void
updateBean(java.lang.Object oldBean, java.lang.Object newBean, boolean managed)
Deprecated.void
updateBeans(java.lang.Object[] oldBeans, java.lang.Object[] newBeans)
Deprecated.-
Methods inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle
addLifeCycleListener, getState, getState, getStopTimeout, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, removeLifeCycleListener, start, stop, toString
-
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface org.eclipse.jetty.util.component.Dumpable.DumpableContainer
isDumpable
-
-
-
-
Method Detail
-
destroy
public void destroy()
Deprecated.Destroys the managed Destroyable beans in the reverse order they were added.- Specified by:
destroy
in interfaceDestroyable
-
contains
public boolean contains(java.lang.Object bean)
Deprecated.- Parameters:
bean
- the bean to test- Returns:
- whether this aggregate contains the bean
-
isManaged
public boolean isManaged(java.lang.Object bean)
Deprecated.Description copied from interface:Container
Test if this container manages a bean
-
isAuto
public boolean isAuto(java.lang.Object bean)
Deprecated.- Parameters:
bean
- the bean to test- Returns:
- whether this aggregate contains the bean in auto state
-
isUnmanaged
public boolean isUnmanaged(java.lang.Object bean)
Deprecated.- Parameters:
bean
- the bean to test- Returns:
- whether this aggregate contains the bean in auto state
-
addBean
public boolean addBean(java.lang.Object o)
Deprecated.Adds the given bean, detecting whether to manage it or not. If the bean is aLifeCycle
, then it will be managed if it is not already started and not managed if it is already started. TheaddBean(Object, boolean)
method should be used if this is not correct, or themanage(Object)
andunmanage(Object)
methods may be used after an add to change the status.
-
addBean
public boolean addBean(java.lang.Object o, boolean managed)
Deprecated.Adds the given bean, explicitly managing it or not.
-
addManaged
public void addManaged(LifeCycle lifecycle)
Deprecated.Adds a managed lifecycle.This is a convenience 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
- the managed lifecycle to add
-
addEventListener
public void addEventListener(Container.Listener listener)
Deprecated.Description copied from interface:Container
Add an event listener.- Specified by:
addEventListener
in interfaceContainer
- Parameters:
listener
- the listener to add- See Also:
Container.addBean(Object)
-
manage
public void manage(java.lang.Object bean)
Deprecated.Manages a bean already contained by this aggregate, so that it is started/stopped/destroyed with this aggregate.
-
unmanage
public void unmanage(java.lang.Object bean)
Deprecated.Unmanages a bean already contained by this aggregate, so that it is not started/stopped/destroyed with this aggregate.
-
getBeans
public java.util.Collection<java.lang.Object> getBeans()
Deprecated.- Specified by:
getBeans
in interfaceContainer
- Returns:
- the collection of beans known to this aggregate, in the order they were added.
- See Also:
Container.getBean(Class)
-
setBeans
public void setBeans(java.util.Collection<java.lang.Object> beans)
Deprecated.
-
getBeans
public <T> java.util.Collection<T> getBeans(java.lang.Class<T> clazz)
Deprecated.- Specified by:
getBeans
in interfaceContainer
- Type Parameters:
T
- the Bean type- Parameters:
clazz
- the class of the beans- Returns:
- a list of beans of the given class (or subclass), in the order they were added.
- See Also:
Container.getBeans()
,Container.getContainedBeans(Class)
-
getBean
public <T> T getBean(java.lang.Class<T> clazz)
Deprecated.
-
removeBeans
public void removeBeans()
Deprecated.Removes all bean
-
removeBean
public boolean removeBean(java.lang.Object o)
Deprecated.Description copied from interface:Container
Removes the given bean. If the bean is-aContainer.Listener
, then also do an implicitContainer.removeEventListener(Listener)
.- Specified by:
removeBean
in interfaceContainer
- Parameters:
o
- the bean to remove- Returns:
- whether the bean was removed
-
removeEventListener
public void removeEventListener(Container.Listener listener)
Deprecated.Description copied from interface:Container
Remove an event listener.- Specified by:
removeEventListener
in interfaceContainer
- Parameters:
listener
- the listener to remove- See Also:
Container.removeBean(Object)
-
setStopTimeout
public void setStopTimeout(long stopTimeout)
Deprecated.- Overrides:
setStopTimeout
in classAbstractLifeCycle
-
dumpStdErr
@ManagedOperation("Dump the object to stderr") public void dumpStdErr()
Deprecated.Dumps toSystem.err
.- See Also:
dump()
-
dump
@ManagedOperation("Dump the object to a string") public java.lang.String dump()
Deprecated.
-
dump
@Deprecated public static java.lang.String dump(Dumpable dumpable)
Deprecated.useDumpable.dump(Dumpable)
insteadDescription copied from interface:Dumpable
Utility method to implementDumpable.dump()
by callingDumpable.dump(Appendable, String)
- Parameters:
dumpable
- the object to dump- Returns:
- the string representation of the given Dumpable
-
dump
public void dump(java.lang.Appendable out, java.lang.String indent) throws java.io.IOException
Deprecated.Description copied from interface:Dumpable
Dump this object (and children) into an Appendable using the provided indent after any new lines. The indent should not be applied to the first object dumped.
-
dump
public void dump(java.lang.Appendable out) throws java.io.IOException
Deprecated.Dump this object to an Appendable with no indent.- Parameters:
out
- The appendable to dump to.- Throws:
java.io.IOException
- May be thrown by the Appendable
-
dumpObject
@Deprecated public static void dumpObject(java.lang.Appendable out, java.lang.Object obj) throws java.io.IOException
Deprecated.useDumpable.dumpObject(Appendable, Object)
insteadDescription copied from interface:Dumpable
Dump just an Object (but not it's contained items) to an Appendable.- Parameters:
out
- The Appendable to dump toobj
- The object to dump- Throws:
java.io.IOException
- May be thrown by the Appendable
-
dump
@Deprecated public static void dump(java.lang.Appendable out, java.lang.String indent, java.util.Collection<?>... collections) throws java.io.IOException
Deprecated.- Throws:
java.io.IOException
-
updateBean
public void updateBean(java.lang.Object oldBean, java.lang.Object newBean)
Deprecated.
-
updateBean
public void updateBean(java.lang.Object oldBean, java.lang.Object newBean, boolean managed)
Deprecated.
-
updateBeans
public void updateBeans(java.lang.Object[] oldBeans, java.lang.Object[] newBeans)
Deprecated.
-
getContainedBeans
public <T> java.util.Collection<T> getContainedBeans(java.lang.Class<T> clazz)
Deprecated.- Specified by:
getContainedBeans
in interfaceContainer
- Type Parameters:
T
- the Bean type- Parameters:
clazz
- the class of the beans- Returns:
- the list of beans of the given class from the entire Container hierarchy. The order is primarily depth first and secondarily added order.
-
-