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>, 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. If no qualifier is passed to Instance.select(java.lang.annotation.Annotation...) method, the @Default qualifier is assumed.

Since:

1.1

Author:

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

Nested Class Summary

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

Instance.Handle<T>

Field Summary

Fields

Modifier and Type	Field	Description
protected static CDIProvider	configuredProvider	CDIProvider set by user or retrieved by service loader
protected static Set<CDIProvider>	discoveredProviders	The set of discovered CDIProviders

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

discoveredProviders

protected static volatile Set<CDIProvider> discoveredProviders

The set of discovered CDIProviders

configuredProvider

protected static volatile CDIProvider configuredProvider

CDIProvider set by user or retrieved by service loader

Constructor Details

CDI

public CDI()

Method Details

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