javax.enterprise.inject

Interface Instance<T>

Type Parameters:

T - bean required type

All Superinterfaces:

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

All Known Subinterfaces:

SeContainer

All Known Implementing Classes:

CDI

public interface Instance<T>
extends Iterable<T>, javax.inject.Provider<T>

The Instance interface provides a method for obtaining instances of beans with required types and qualifiers.

Version:

$Rev$ $Date$

Method Summary

Modifier and Type	Method and Description
void	destroy(T instance) Destroy the given Contextual Instance.
boolean	isAmbiguous() Returns true if resolution is ambiguous, false otherwise.
default boolean	isResolvable()
boolean	isUnsatisfied() Return true if resolution is unsatisfied, false otherwise.
Instance<T>	select(Annotation... qualifiers) Creates new Instance with given qualifiers.
<U extends T> Instance<U>	select(Class<U> subtype, Annotation... qualifiers) Returns new child instance with given class and qualifiers.
<U extends T> Instance<U>	select(TypeLiteral<U> subtype, Annotation... qualifiers) Return new child instance with given class info and qualifiers.
default Stream<T>	stream()

Methods inherited from interface java.lang.Iterable

forEach, iterator, spliterator

Methods inherited from interface javax.inject.Provider

get

Method Detail

select

Instance<T> select(Annotation... qualifiers)

Creates new Instance with given qualifiers.

Parameters:

qualifiers -

Returns:

new child instance with given qualifiers.

select

<U extends T> Instance<U> select(Class<U> subtype,
                                 Annotation... qualifiers)

Returns new child instance with given class and qualifiers.

Type Parameters:

U - subtype info

Parameters:

subtype - subtype class

qualifiers - qualifiers

Returns:

new child instance with given class and qualifiers

select

<U extends T> Instance<U> select(TypeLiteral<U> subtype,
                                 Annotation... qualifiers)

Return new child instance with given class info and qualifiers.

Type Parameters:

U - subtype info

Parameters:

subtype - subtype class

qualifiers - qualifiers

Returns:

new child instance with given class info and qualifiers

isUnsatisfied

boolean isUnsatisfied()

Return true if resolution is unsatisfied, false otherwise.

Returns:

true if resolution is unsatisfied, false otherwise

isAmbiguous

boolean isAmbiguous()

Returns true if resolution is ambiguous, false otherwise.

Returns:

true if resolution is ambiguous, false otherwise.

isResolvable

default boolean isResolvable()

Returns:

true if there is exactly one Bean which resolves according to the currently selected type and qualifiers. In other words: whether the Instance can serve an actual Contextual Reference.

Since:

2.0

stream

default Stream<T> stream()

Returns:

a Stream of all the beans available for the currently selected type and qualifiers, or an empty Stream if isUnsatisfied()

destroy

void destroy(T instance)

Destroy the given Contextual Instance. This is especially intended for Dependent scoped beans which might otherwise create mem leaks.

Parameters:

instance -