Helper class for injecting and calling lifecycle callbacks unmanaged instances for use by framework and library integrators.

Unmanaged<Foo> unmanagedFoo = new Unmanaged<Foo>(Foo.class);
UnmanagedInstance<Foo> fooInstance = unmanagedFoo.newInstance();
Foo foo = fooInstance.produce().inject().postConstruct().get();
... // Use the foo instance
fooInstance.preDestroy().dispose();

An instance of this class can be safely held for the lifetime of the application.

UnmanagedInstances created by this class are not suitable for sharing between threads.

CDI Lite implementations are not required to provide support for Unmanaged.

Modifier and Type	Class and Description
public static class	Unmanaged.UnmanagedInstance<T> Represents a non-contextual instance.

Modifier and Type	Field and Description
private final BeanManager	beanManager
private final InjectionTarget<T>	injectionTarget

Access	Constructor and Description
public	Unmanaged(BeanManager the `BeanManager` manager, Class<T> class of the unmanaged instances clazz) Create an injector for the given class
public	Unmanaged(Class<T> class of the unmanaged instances clazz) Create an injector for the given class, using the current bean manager

Modifier and Type	Method and Description
public Unmanaged.UnmanagedInstance<T>	Returns: a new `UnmanagedInstance` newInstance() Instantiate a new UnmanagedInstance

beanManager	back to summary
private final BeanManager beanManager

injectionTarget	back to summary
private final InjectionTarget<T> injectionTarget

Unmanaged	back to summary
public Unmanaged(BeanManager manager, Class<T> clazz) Create an injector for the given class Parameters manager:BeanManager the `BeanManager` clazz:Class<T> class of the unmanaged instances

Unmanaged	back to summary
public Unmanaged(Class<T> clazz) Create an injector for the given class, using the current bean manager Parameters clazz:Class<T> class of the unmanaged instances

newInstance	back to summary
public Unmanaged.UnmanagedInstance<T> newInstance() Instantiate a new UnmanagedInstance Returns:Unmanaged.UnmanagedInstance<T> a new `UnmanagedInstance`

jakarta.enterprise.inject.spi back to summary

public Class Unmanaged.UnmanagedInstance<T>

Class Inheritance

extends Object

java.lang.Object
jakarta.enterprise.inject.spi.Unmanaged.UnmanagedInstance

Represents a non-contextual instance.

See Also: Unmanaged

Field Summary

Modifier and Type	Field and Description
private final CreationalContext<T>	ctx
private boolean	disposed
private final InjectionTarget<T>	injectionTarget
private T	instance

Constructor Summary

Access	Constructor and Description
private	UnmanagedInstance(BeanManager beanManager, InjectionTarget<T> injectionTarget)

Method Summary

Modifier and Type	Method and Description
public Unmanaged.UnmanagedInstance<T>	Returns: self dispose() Dispose of the instance, doing any necessary cleanup
public T	Returns: the instance get() Get the instance
public Unmanaged.UnmanagedInstance<T>	Returns: self inject() Inject the instance
public Unmanaged.UnmanagedInstance<T>	Returns: self postConstruct() Call the @PostConstruct callback
public Unmanaged.UnmanagedInstance<T>	Returns: self preDestroy() Call the @PreDestroy callback
public Unmanaged.UnmanagedInstance<T>	Returns: self produce() Create the instance

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

ctx	back to summary
private final CreationalContext<T> ctx

disposed	back to summary
private boolean disposed

injectionTarget	back to summary
private final InjectionTarget<T> injectionTarget

instance	back to summary
private T instance

Constructor Detail

UnmanagedInstance	back to summary
private UnmanagedInstance(BeanManager beanManager, InjectionTarget<T> injectionTarget)

Method Detail

dispose	back to summary
public Unmanaged.UnmanagedInstance<T> dispose() Dispose of the instance, doing any necessary cleanup Returns:Unmanaged.UnmanagedInstance<T> self Exceptions IllegalStateException: if dispose() is called before produce() is called if dispose() is called on an instance that has already been disposed

dispose

back to summary

public Unmanaged.UnmanagedInstance<T> dispose()

Dispose of the instance, doing any necessary cleanup

Returns:Unmanaged.UnmanagedInstance<T>

self

Exceptions

IllegalStateException:

if dispose() is called before produce() is called
if dispose() is called on an instance that has already been disposed

get	back to summary
public T get() Get the instance Returns:T the instance

get

back to summary

public T get()

Get the instance

Returns:T: the instance

inject	back to summary
public Unmanaged.UnmanagedInstance<T> inject() Inject the instance Returns:Unmanaged.UnmanagedInstance<T> self Exceptions IllegalStateException: if inject() is called before produce() is called if inject() is called on an instance that has already been disposed

inject

back to summary

public Unmanaged.UnmanagedInstance<T> inject()

Inject the instance

Returns:Unmanaged.UnmanagedInstance<T>

self

Exceptions

IllegalStateException:

if inject() is called before produce() is called
if inject() is called on an instance that has already been disposed

postConstruct	back to summary
public Unmanaged.UnmanagedInstance<T> postConstruct() Call the @PostConstruct callback Returns:Unmanaged.UnmanagedInstance<T> self Exceptions IllegalStateException: if postConstruct() is called before produce() is called if postConstruct() is called on an instance that has already been disposed

postConstruct

back to summary

public Unmanaged.UnmanagedInstance<T> postConstruct()

Call the @PostConstruct callback

Returns:Unmanaged.UnmanagedInstance<T>

self

Exceptions

IllegalStateException:

if postConstruct() is called before produce() is called
if postConstruct() is called on an instance that has already been disposed

preDestroy	back to summary
public Unmanaged.UnmanagedInstance<T> preDestroy() Call the @PreDestroy callback Returns:Unmanaged.UnmanagedInstance<T> self Exceptions IllegalStateException: if preDestroy() is called before produce() is called if preDestroy() is called on an instance that has already been disposed

preDestroy

back to summary

public Unmanaged.UnmanagedInstance<T> preDestroy()

Call the @PreDestroy callback

Returns:Unmanaged.UnmanagedInstance<T>

self

Exceptions

IllegalStateException:

if preDestroy() is called before produce() is called
if preDestroy() is called on an instance that has already been disposed

produce	back to summary
public Unmanaged.UnmanagedInstance<T> produce() Create the instance Returns:Unmanaged.UnmanagedInstance<T> self Exceptions IllegalStateException: if produce() is called on an already produced instance if produce() is called on an instance that has already been disposed

produce

back to summary

public Unmanaged.UnmanagedInstance<T> produce()

Create the instance

Returns:Unmanaged.UnmanagedInstance<T>

self

Exceptions

IllegalStateException: