org.jboss.weld.inject

Interface WeldInstance<T>

Type Parameters:

T -

All Superinterfaces:

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

public interface WeldInstance<T>
extends javax.enterprise.inject.Instance<T>

An enhanced version of Instance.

Author:

Martin Kouba

Issue tracker:

• WELD-2151

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	WeldInstance.Handler<T> A contextual reference handler.

Method Summary

Modifier and Type	Method and Description
WeldInstance.Handler<T>	getHandler() Obtains a contextual reference handler for the bean that has the required type and required qualifiers and is eligible for injection.
Iterable<WeldInstance.Handler<T>>	handlers() Allows to iterate over contextual reference handlers for all the beans that have the required type and required qualifiers and are eligible for injection.
boolean	isResolvable()
WeldInstance<T>	select(Annotation... qualifiers)
<U extends T> WeldInstance<U>	select(Class<U> subtype, Annotation... qualifiers)
<U extends T> WeldInstance<U>	select(javax.enterprise.util.TypeLiteral<U> subtype, Annotation... qualifiers)

Methods inherited from interface javax.enterprise.inject.Instance

destroy, isAmbiguous, isUnsatisfied

Methods inherited from interface java.lang.Iterable

forEach, iterator, spliterator

Methods inherited from interface javax.inject.Provider

get

Method Detail

getHandler

WeldInstance.Handler<T> getHandler()

Obtains a contextual reference handler for the bean that has the required type and required qualifiers and is eligible for injection.

Note that each invocation of this method results in a separate Provider.get() invocation.

Returns:

a new handler

Throws:

javax.enterprise.inject.UnsatisfiedResolutionException

javax.enterprise.inject.AmbiguousResolutionException

isResolvable

boolean isResolvable()

Returns:

true if satisfied and not ambiguous, false otherwise

See Also:

Instance.isAmbiguous(), Instance.isUnsatisfied()

handlers

Iterable<WeldInstance.Handler<T>> handlers()

Allows to iterate over contextual reference handlers for all the beans that have the required type and required qualifiers and are eligible for injection.

Note that the returned Iterable is stateless and so each Iterable.iterator() produces a new set of handlers.

Returns:

an iterable to iterate over the handlers

select

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

Specified by:

select in interface javax.enterprise.inject.Instance<T>

select

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

Specified by:

select in interface javax.enterprise.inject.Instance<T>

select

<U extends T> WeldInstance<U> select(javax.enterprise.util.TypeLiteral<U> subtype,
                                     Annotation... qualifiers)

Specified by:

select in interface javax.enterprise.inject.Instance<T>