Package 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, Dumpable.DumpableContainer, LifeCycle
Direct Known Subclasses:
AbstractConnectionFactory, AbstractConnectionPool, AbstractConnector, AbstractHandler, AbstractHttpClientTransport, AbstractLoginService, AbstractNCSARequestLog, AbstractSessionCache, AbstractSessionDataStore, AttributeContainerMap, CachingSessionDataStore, ConfigurableSpnegoLoginService, CustomRequestLog, DefaultSessionIdManager, ExecutorThreadPool, HttpClient, HttpDestination, KeyStoreScanner, LeakTrackingByteBufferPool, LowResourceMonitor, ManagedSelector, QueuedThreadPool, SelectorManager
@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 an LifeCycle 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 the container is started, then all contained managed beans will also be started. Any contained AUTO beans will be check for their status and if already started will be switched unmanaged beans, else they will be started and switched to managed beans. Beans added after a container is started are not started and their state needs to be explicitly managed.

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) and unmanage(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.

  • Constructor Details

    • ContainerLifeCycle

      public ContainerLifeCycle()
      Deprecated.

  • Method Details

    • destroy

      public void destroy()
      Deprecated.
      Destroys the managed Destroyable beans in the reverse order they were added.
      Specified by:
      destroy in interface Destroyable

    • contains

      public boolean contains(Object bean)
      Deprecated.
      Parameters:
      bean - the bean to test
      Returns:
      whether this aggregate contains the bean

    • isManaged

      public boolean isManaged(Object bean)
      Deprecated.
      Description copied from interface: Container
      Test if this container manages a bean
      Specified by:
      isManaged in interface Container
      Parameters:
      bean - the bean to test
      Returns:
      whether this aggregate contains and manages the bean

    • isAuto

      public boolean isAuto(Object bean)
      Deprecated.
      Parameters:
      bean - the bean to test
      Returns:
      whether this aggregate contains the bean in auto state

    • isUnmanaged

      public boolean isUnmanaged(Object bean)
      Deprecated.
      Parameters:
      bean - the bean to test
      Returns:
      whether this aggregate contains the bean in auto state

    • addBean

      public boolean addBean(Object o)
      Deprecated.
      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)
      Deprecated.
      Adds the given bean, explicitly managing it or not.
      Specified by:
      addBean in interface Container
      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

    • 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 interface Container
      Parameters:
      listener - the listener to add
      See Also:

    • manage

      public void manage(Object bean)
      Deprecated.
      Manages a bean already contained by this aggregate, so that it is started/stopped/destroyed with this aggregate.
      Specified by:
      manage in interface Container
      Parameters:
      bean - The bean to manage (must already have been added).

    • unmanage

      public void unmanage(Object bean)
      Deprecated.
      Unmanages a bean already contained by this aggregate, so that it is not started/stopped/destroyed with this aggregate.
      Specified by:
      unmanage in interface Container
      Parameters:
      bean - The bean to unmanage (must already have been added).

    • getBeans

      public Collection<Object> getBeans()
      Deprecated.
      Specified by:
      getBeans in interface Container
      Returns:
      the collection of beans known to this aggregate, in the order they were added.
      See Also:

    • setBeans

      public void setBeans(Collection<Object> beans)
      Deprecated.

    • getBeans

      public <T> Collection<T> getBeans(Class<T> clazz)
      Deprecated.
      Specified by:
      getBeans in interface Container
      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:

    • getBean

      public <T> T getBean(Class<T> clazz)
      Deprecated.
      Specified by:
      getBean in interface Container
      Type Parameters:
      T - the Bean type
      Parameters:
      clazz - the class of the bean
      Returns:
      the first bean (in order added) of a specific class (or subclass), or null if no such bean exist

    • removeBeans

      public void removeBeans()
      Deprecated.
      Removes all bean

    • removeBean

      public boolean removeBean(Object o)
      Deprecated.
      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
      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 interface Container
      Parameters:
      listener - the listener to remove
      See Also:

    • setStopTimeout

      public void setStopTimeout(long stopTimeout)
      Deprecated.
      Overrides:
      setStopTimeout in class AbstractLifeCycle

    • dumpStdErr

      @ManagedOperation("Dump the object to stderr") public void dumpStdErr()
      Deprecated.
      Dumps to System.err.
      See Also:

    • dump

      @ManagedOperation("Dump the object to a string") public String dump()
      Deprecated.
      Specified by:
      dump in interface Dumpable

    • dump

      @Deprecated public static String dump(Dumpable dumpable)
      Deprecated.
      use Dumpable.dump(Dumpable) instead
      Parameters:
      dumpable - the object to dump
      Returns:
      the string representation of the given Dumpable

    • dump

      public void dump(Appendable out, String indent) throws 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.
      Specified by:
      dump in interface Dumpable
      Parameters:
      out - The appendable to dump to
      indent - The indent to apply after any new lines.
      Throws:
      IOException - if unable to write to Appendable

    • dump

      public void dump(Appendable out) throws IOException
      Deprecated.
      Dump this object to an Appendable with no indent.
      Parameters:
      out - The appendable to dump to.
      Throws:
      IOException - May be thrown by the Appendable

    • dumpObject

      @Deprecated public static void dumpObject(Appendable out, Object obj) throws IOException
      Deprecated.
      use Dumpable.dumpObject(Appendable, Object) instead
      Parameters:
      out - The Appendable to dump to
      obj - The object to dump
      Throws:
      IOException - May be thrown by the Appendable

    • dump

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

    • updateBean

      public void updateBean(Object oldBean, Object newBean)
      Deprecated.

    • updateBean

      public void updateBean(Object oldBean, Object newBean, boolean managed)
      Deprecated.

    • updateBeans

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

    • getContainedBeans

      public <T> Collection<T> getContainedBeans(Class<T> clazz)
      Deprecated.
      Specified by:
      getContainedBeans in interface Container
      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.