Package jakarta.enterprise.inject.spi

Class CDI<T>

java.lang.Object

jakarta.enterprise.inject.spi.CDI<T>

Type Parameters:

T - type inherited from Instance. Always Object for CDI

All Implemented Interfaces:

Instance<T>, jakarta.inject.Provider<T>, Iterable<T>

public abstract class CDI<T>
extends Object
implements Instance<T>

Provides access to the current container.

CDI implements Instance and therefore might be used to perform programmatic lookup. Initially, the required type of the Instance is java.lang.Object and there are no required qualifiers. If no qualifier is passed to Instance.select(), there is one required qualifier: @Default.

Since:

1.1

Author:

Pete Muir, Antoine Sabot-Durand, John D. Ament

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected static final record	CDI.ProviderState

Nested classes/interfaces inherited from interface jakarta.enterprise.inject.Instance

Instance.Handle<T>

Field Summary

Fields

Modifier and Type	Field	Description
protected static final AtomicReference<CDI.ProviderState>	providerState

Constructor Summary

Constructors

Constructor	Description
CDI()

Method Summary

Modifier and Type	Method	Description
static CDI<Object>	current()	Get the CDI instance that provides access to the current container.
BeanContainer	getBeanContainer()	Get the CDI BeanContainer for the current context.
abstract BeanManager	getBeanManager()	Get the CDI BeanManager for the current context
protected static CDI.ProviderState	initialState()
static void	setCDIProvider(CDIProvider provider)	Set the CDIProvider to use.

Methods inherited from class java.lang.Object

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

Methods inherited from interface jakarta.enterprise.inject.Instance

destroy, getHandle, handles, handlesStream, isAmbiguous, isResolvable, isUnsatisfied, select, select, select, stream

Methods inherited from interface java.lang.Iterable

forEach, iterator, spliterator

Methods inherited from interface jakarta.inject.Provider

get

Field Details

providerState

protected static final AtomicReference<CDI.ProviderState> providerState

Constructor Details

CDI

public CDI()

Method Details

initialState

protected static CDI.ProviderState initialState()

current

public static CDI<Object> current()

Get the CDI instance that provides access to the current container.

If there are no providers available, an IllegalStateException is thrown, otherwise the first provider which can access the container is used.

Returns:

the CDI instance

Throws:

IllegalStateException - if no CDIProvider is available

setCDIProvider

public static void setCDIProvider(CDIProvider provider)

Set the CDIProvider to use.

If a CDIProvider is set using this method, any provider specified as a service provider will not be used.

Parameters:

provider - the provider to use

Throws:

IllegalArgumentException - if the provided argument is null

getBeanManager

public abstract BeanManager getBeanManager()

Get the CDI BeanManager for the current context

Returns:

the BeanManager

getBeanContainer

public BeanContainer getBeanContainer()

Get the CDI BeanContainer for the current context. Default implementation just forwards the call to getBeanManager().

Returns:

the BeanContainer