Interface WeldInstance<T>
-
- Type Parameters:
T
- the required bean type
- All Known Implementing Classes:
AbstractCDI
,ForwardingWeldInstance
,InstanceImpl
,SimpleCDI
,WeldContainer
public interface WeldInstance<T> extends Instance<T>
Represents an enhanced version ofInstance
.In the following example we filter out beans which are not
Dependent
then sort the beans by priority and use the handler whose bean has the highest priority (according togetPriorityComparator()
) to obtain the hello string. Note that contextual references for beans with lower priority are not created at all.@ApplicationScoped class Hello { @Inject WeldInstance<HelloProvider> instance; String hello() { HelloProvider helloProvider = instance.handlersStream().filter(h -> h.getBean().getScope().equals(Dependent.class)) .sorted(instance.getPriorityComparator()).findFirst().map(Handler::get).orElse(null); if (helloProvider != null) return helloProvider.getHello(); return "No hello provider found!"; } }
- Author:
- Martin Kouba
- See Also:
- WELD-2204
-
-
Nested Class Summary
Nested Classes Modifier and Type Interface Description static interface
WeldInstance.Handler<T>
This interface represents a contextual reference handler.
-
Method Summary
All Methods Instance Methods Abstract Methods Default Methods Modifier and Type Method Description WeldInstance.Handler<T>
getHandler()
Obtains an initialized contextual reference handler for the bean that has the required type and required qualifiers and is eligible for injection.Comparator<WeldInstance.Handler<?>>
getPriorityComparator()
The returned comparator sorts handlers by priority in descending order.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.default Stream<WeldInstance.Handler<T>>
handlersStream()
<U extends T>
WeldInstance<U>select(TypeLiteral<U> subtype, Annotation... qualifiers)
Obtains a childInstance
for the given required type and additional required qualifiers.WeldInstance<T>
select(Annotation... qualifiers)
Obtains a childInstance
for the given additional required qualifiers.<U extends T>
WeldInstance<U>select(Class<U> subtype, Annotation... qualifiers)
Obtains a childInstance
for the given required type and additional required qualifiers.<X> WeldInstance<X>
select(Type subtype, Annotation... qualifiers)
Obtains a childInstance
for the given required type and additional required qualifiers.-
Methods inherited from interface jakarta.enterprise.inject.Instance
destroy, isAmbiguous, isResolvable, isUnsatisfied, stream
-
Methods inherited from interface java.lang.Iterable
forEach, iterator, spliterator
-
-
-
-
Method Detail
-
getHandler
WeldInstance.Handler<T> getHandler()
Obtains an initialized contextual reference handler for the bean that has the required type and required qualifiers and is eligible for injection.The contextual reference is obtained lazily, i.e. when first needed.
- Returns:
- a new handler
- Throws:
UnsatisfiedResolutionException
- if there is no bean with given type and qualifiersAmbiguousResolutionException
- if there is more than one bean given type and qualifiers
-
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 eachIterable.iterator()
produces a new set of handlers.- Returns:
- a new iterable
-
handlersStream
default Stream<WeldInstance.Handler<T>> handlersStream()
- Returns:
- a new stream of contextual reference handlers
-
getPriorityComparator
Comparator<WeldInstance.Handler<?>> getPriorityComparator()
The returned comparator sorts handlers by priority in descending order.- A class-based bean whose annotated type has
jakarta.annotation.Priority
has the priority of valuejakarta.annotation.Priority#value()
- A custom bean which implements
Prioritized
has the priority of valuePrioritized.getPriority()
- Any other bean has the priority of value 0
- Returns:
- a comparator instance
- A class-based bean whose annotated type has
-
select
WeldInstance<T> select(Annotation... qualifiers)
Description copied from interface:Instance
Obtains a child
Instance
for the given additional required qualifiers.
-
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.
-
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 interfaceInstance<T>
- Type Parameters:
U
- the required type- Parameters:
subtype
- aTypeLiteral
representing the required typequalifiers
- the additional required qualifiers- Returns:
- the child
Instance
-
select
<X> WeldInstance<X> select(Type subtype, Annotation... qualifiers)
Obtains a child
Instance
for the given required type and additional required qualifiers. Must be invoked onInstance<T>
where T isObject
.- Type Parameters:
X
- the required type- Parameters:
subtype
- aType
representing the required typequalifiers
- the additional required qualifiers- Returns:
- the child
Instance
- Throws:
IllegalArgumentException
- if passed two instances of the same non repeating qualifier type, or an instance of an annotation that is not a qualifier typeIllegalStateException
- if the container is already shutdownIllegalStateException
- if invoked onInstance<T>
where T is of any other type thanObject
-
-