Package io.quarkus.arc

Interface InjectableInstance<T>

Type Parameters:
T -
All Superinterfaces:
jakarta.enterprise.inject.Instance<T>, Iterable<T>, jakarta.inject.Provider<T>
All Known Implementing Classes:
InstanceImpl
public interface InjectableInstance<T> extends jakarta.enterprise.inject.Instance<T>
Enhanced version of Instance.

  • Nested Class Summary

    Nested classes/interfaces inherited from interface jakarta.enterprise.inject.Instance

    jakarta.enterprise.inject.Instance.Handle<T extends Object>

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    clearCache()
    Removes the cached result of the Provider.get() operation.
    InstanceHandle<T>
    getHandle()
     
    Iterable<InstanceHandle<T>>
    handles()
     
    Iterator<T>
    iterator()
    This method attempts to resolve ambiguities.
    default T
    orElse(T other)
    If there is exactly one bean that matches the required type and qualifiers, returns the instance, otherwise returns other.
    default T
    orNull()
    If there is exactly one bean that matches the required type and qualifiers, returns the instance, otherwise returns null.
    <U extends T>
    InjectableInstance<U>
    select(jakarta.enterprise.util.TypeLiteral<U> subtype, Annotation... qualifiers)
     
    InjectableInstance<T>
    select(Annotation... qualifiers)
     
    <U extends T>
    InjectableInstance<U>
    select(Class<U> subtype, Annotation... qualifiers)
     

    Methods inherited from interface jakarta.enterprise.inject.Instance

    destroy, handlesStream, isAmbiguous, isResolvable, isUnsatisfied, stream

    Methods inherited from interface java.lang.Iterable

    forEach, spliterator

    Methods inherited from interface jakarta.inject.Provider

    get

  • Method Details

    • getHandle

      InstanceHandle<T> getHandle()
      Specified by:
      getHandle in interface jakarta.enterprise.inject.Instance<T>

    • handles

      Iterable<InstanceHandle<T>> handles()
      Specified by:
      handles in interface jakarta.enterprise.inject.Instance<T>

    • select

      InjectableInstance<T> select(Annotation... qualifiers)
      Specified by:
      select in interface jakarta.enterprise.inject.Instance<T>

    • select

      <U extends T> InjectableInstance<U> select(Class<U> subtype, Annotation... qualifiers)
      Specified by:
      select in interface jakarta.enterprise.inject.Instance<T>

    • select

      <U extends T> InjectableInstance<U> select(jakarta.enterprise.util.TypeLiteral<U> subtype, Annotation... qualifiers)
      Specified by:
      select in interface jakarta.enterprise.inject.Instance<T>

    • clearCache

      void clearCache()
      Removes the cached result of the Provider.get() operation. If the cached result was a contextual reference of a Dependent bean, destroy the reference as well.
      See Also:

    • iterator

      Iterator<T> iterator()
      This method attempts to resolve ambiguities.

      In general, if multiple beans are eligible then the container eliminates all beans that are:

      • not alternatives, except for producer methods and fields of beans that are alternatives,
      • default beans.
      Specified by:
      iterator in interface Iterable<T>
      Returns:
      an iterator over the contextual references of the disambiguated beans
      See Also:

    • orElse

      default T orElse(T other)
      If there is exactly one bean that matches the required type and qualifiers, returns the instance, otherwise returns other.
      Parameters:
      other -
      Returns:
      the bean instance or the other value

    • orNull

      default T orNull()
      If there is exactly one bean that matches the required type and qualifiers, returns the instance, otherwise returns null.
      Parameters:
      other -
      Returns:
      the bean instance or null