org.jboss.weld.inject

Interface WeldInstance<T>

Type Parameters:

T -

All Superinterfaces:

Instance<T>, Iterable<T>, Provider<T>

public interface WeldInstance<T>
extends Instance<T>

An enhanced version of Instance.

Author:

Martin Kouba

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) Obtains a child Instance for the given additional required qualifiers.
<U extends T> WeldInstance<U>	select(Class<U> subtype, Annotation... qualifiers) Obtains a child Instance for the given required type and additional required qualifiers.
<U extends T> WeldInstance<U>	select(TypeLiteral<U> subtype, Annotation... qualifiers) Obtains a child Instance for the given required type and additional required 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:

UnsatisfiedResolutionException

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)

Description copied from interface: Instance

Obtains a child Instance for the given additional required qualifiers.

Specified by:

select in interface Instance<T>

Parameters:

qualifiers - the additional required qualifiers

Returns:

the child Instance

select

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

Description copied from interface: Instance

Obtains a child Instance for the given required type and additional required qualifiers.

Specified by:

select in interface Instance<T>

Type Parameters:

U - the required type

Parameters:

subtype - a Class representing the required type

qualifiers - the additional required qualifiers

Returns:

the child Instance

select

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

Description copied from interface: Instance

Obtains a child Instance for the given required type and additional required qualifiers.

Specified by:

select in interface Instance<T>

Type Parameters:

U - the required type

Parameters:

subtype - a TypeLiteral representing the required type

qualifiers - the additional required qualifiers

Returns:

the child Instance