javax.enterprise.inject.spi

Class CDI<T>

java.lang.Object

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

All Implemented Interfaces:

AutoCloseable, Iterable<T>, Instance<T>, javax.inject.Provider<T>

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

Provides access to the current container.

Since:

1.1

Author:

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

Field Summary

Fields

Modifier and Type	Field and Description
protected static CDIProvider	configuredProvider
protected static Set<CDIProvider>	discoveredProviders

Constructor Summary

Constructors

Constructor and Description
CDI()

Method Summary

Modifier and Type	Method and Description
void	close() Shuts down this CDI instance when it is no longer in scope.
static CDI<Object>	current() Get the CDI instance that provides access to the current container.
abstract BeanManager	getBeanManager() Get the CDI BeanManager for the current context
static CDIProvider	getCDIProvider()
static void	setCDIProvider(CDIProvider provider) Set the CDIProvider to use.
abstract void	shutdown() Shuts down this CDI instance.

Methods inherited from class java.lang.Object

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

Methods inherited from interface javax.enterprise.inject.Instance

destroy, isAmbiguous, isUnsatisfied, select, select, select

Methods inherited from interface java.lang.Iterable

forEach, iterator, spliterator

Methods inherited from interface javax.inject.Provider

get

Field Detail

discoveredProviders

protected static volatile Set<CDIProvider> discoveredProviders

configuredProvider

protected static volatile CDIProvider configuredProvider

Constructor Detail

CDI

public CDI()

Method Detail

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.

Throws:

IllegalStateException - if no CDI provider 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:

IllegalStateException - if the CDIProvider is already set

shutdown

public abstract void shutdown()

Shuts down this CDI instance.

Throws:

IllegalStateException - if called within an application server or if the container is not already started

Since:

2.0

close

public void close()

Shuts down this CDI instance when it is no longer in scope. Implemented from AutoCloseable,

Specified by:

close in interface AutoCloseable

Since:

2.0

getBeanManager

public abstract BeanManager getBeanManager()

Get the CDI BeanManager for the current context

Returns:

the BeanManager

getCDIProvider

public static CDIProvider getCDIProvider()