Module org.eclipse.jetty.util

Package org.eclipse.jetty.util.component

Interface Container

All Known Implementing Classes:

AdaptiveExecutionStrategy, AttributeContainerMap, CompressionPool, ContainerLifeCycle, DeflaterPool, ExecutorThreadPool, InflaterPool, KeyStoreScanner, MonitoredQueuedThreadPool, QueuedThreadPool, ReservedThreadExecutor, Scanner, SslContextFactory, SslContextFactory.Client, SslContextFactory.Server, VirtualThreadPool

public interface Container

A Container

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static interface	Container.InheritedListener	Inherited Listener.
static interface	Container.Listener	A listener for Container events.

Method Summary

Modifier and Type	Method	Description
boolean	addBean(Object o)	Add a bean.
boolean	addBean(Object o, boolean managed)	Adds the given bean, explicitly managing it or not.
static boolean	addBean(Object parent, Object child)	A utility method to add a bean to a container.
static boolean	addBean(Object parent, Object child, boolean managed)	A utility method to add a bean to a container.
boolean	addEventListener(EventListener listener)	Add an event listener.
<T> T	getBean(Class<T> clazz)
Collection<Object>	getBeans()
<T> Collection<T>	getBeans(Class<T> clazz)
default <T> Collection<T>	getCachedBeans(Class<T> clazz)
<T> Collection<T>	getContainedBeans(Class<T> clazz)
default List<EventListener>	getEventListeners()	Get the beans added to the container that are EventListeners.
boolean	isManaged(Object bean)	Test if this container manages a 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.
static boolean	removeBean(Object parent, Object child)	A utility method to remove a bean from a container.
boolean	removeEventListener(EventListener listener)	Remove an event listener.
void	unmanage(Object bean)	Unmanages a bean already contained by this aggregate, so that it is not started/stopped/destroyed with this aggregate.
static void	unmanage(Object parent, Object child)	A utility method to unmanage a bean from a container.

Method Details

addBean

boolean addBean(Object o)

Add a bean. If the bean is-a EventListener, then also do an implicit addEventListener(EventListener).

Parameters:

o - the bean object to add

Returns:

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

addBean

boolean addBean(Object o,
 boolean managed)

Adds the given bean, explicitly managing it or not. If the bean is-a EventListener, then also do an implicit addEventListener(EventListener).

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

getBeans

Collection<Object> getBeans()

Returns:

the collection of beans known to this aggregate, in the order they were added.

getBeans

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

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:

• getBeans()
• getContainedBeans(Class)

getCachedBeans

default <T> Collection<T> getCachedBeans(Class<T> clazz)

Type Parameters:

T - the Bean type

Parameters:

clazz - the class of the beans

Returns:

a list of beans of the given class (or subclass), which may be cached/shared.

See Also:

• getBeans()
• getContainedBeans(Class)

getBean

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

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

removeBean

boolean removeBean(Object o)

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

Parameters:

o - the bean to remove

Returns:

whether the bean was removed

addEventListener

boolean addEventListener(EventListener listener)

Add an event listener. EventListeners added by this method are also added as beans.

Parameters:

listener - the listener to add

Returns:

true if the listener was added

See Also:

• Container.Listener
• LifeCycle.Listener
• addBean(Object)

removeEventListener

boolean removeEventListener(EventListener listener)

Remove an event listener.

Parameters:

listener - the listener to remove

Returns:

true if the listener was removed

See Also:

• removeBean(Object)

unmanage

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).

manage

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).

isManaged

boolean isManaged(Object bean)

Test if this container manages a bean

Parameters:

bean - the bean to test

Returns:

whether this aggregate contains and manages the bean

getContainedBeans

<T> Collection<T> getContainedBeans(Class<T> clazz)

Type Parameters:

T - the bean type

Parameters:

clazz - the class of the beans

Returns:

the collection of beans of the given class from the Container hierarchy

getEventListeners

default List<EventListener> getEventListeners()

Get the beans added to the container that are EventListeners. This is essentially equivalent to getBeans(EventListener.class), except that:

• The result may be precomputed, so it can be more efficient
• The result is ordered by the order added.
• The result is immutable.

Returns:

An unmodifiable list of EventListener beans

See Also:

• getBeans(Class)

addBean

static boolean addBean(Object parent,
 Object child)

A utility method to add a bean to a container.

Parameters:

parent - the parent container.

child - the child bean.

Returns:

true if the child was added as a bean, false if parent was not instance of Container or bean was already present.

addBean

static boolean addBean(Object parent,
 Object child,
 boolean managed)

A utility method to add a bean to a container.

Parameters:

parent - the parent container.

child - the child bean.

managed - whether to managed the lifecycle of the bean.

Returns:

true if the child was added as a bean, false if parent was not instance of Container or bean was already present.

unmanage

static void unmanage(Object parent,
 Object child)

A utility method to unmanage a bean from a container.

Parameters:

parent - the parent container

child - the child bean

removeBean

static boolean removeBean(Object parent,
 Object child)

A utility method to remove a bean from a container.

Parameters:

parent - the parent container.

child - the child bean.

Returns:

true if parent was an instance of Container and the bean was removed.