Interface IndexView

All Known Implementing Classes:
CompositeIndex, EmptyIndex, Index, StackedIndex

public interface IndexView
The basic contract for accessing Jandex indexed information.
  • Method Details

    • empty

      static IndexView empty()
      Returns an immutable empty index; that is, an index that doesn't contain any class. All methods return either an empty collection, or null.
      Since:
      3.2.0
    • getKnownClasses

      Collection<ClassInfo> getKnownClasses()
      Gets all known classes by this index (those which were scanned).
      Returns:
      a collection of known classes
    • getClassByName

      ClassInfo getClassByName(DotName className)
      Gets the class (or interface, or annotation) that was scanned during the indexing phase.
      Parameters:
      className - the name of the class
      Returns:
      information about the class or null if it is not known
    • getClassByName

      default ClassInfo getClassByName(String className)
      Gets the class (or interface, or annotation) that was scanned during the indexing phase.
      Parameters:
      className - the name of the class
      Returns:
      information about the class or null if it is not known
    • getClassByName

      default ClassInfo getClassByName(Class<?> clazz)
      Gets the class (or interface, or annotation) that was scanned during the indexing phase.
      Parameters:
      clazz - the class
      Returns:
      information about the class or null if it is not known
    • getKnownDirectSubclasses

      Collection<ClassInfo> getKnownDirectSubclasses(DotName className)
      Gets all known direct subclasses of the specified class. A known direct subclass is one which was found during the scanning process; however, this is often not the complete universe of subclasses, since typically indexes are constructed per jar. It is expected that several indexes will need to be searched when analyzing a jar that is a part of a complex multi-module/classloader environment (like an EE application server).

      Note that this will only pick up direct subclasses of the class. It will not pick up subclasses of subclasses.

      Also note that interfaces are considered direct subclasses of java.lang.Object.

      Parameters:
      className - the super class of the desired subclasses
      Returns:
      a non-null list of all known subclasses of className
    • getKnownDirectSubclasses

      default Collection<ClassInfo> getKnownDirectSubclasses(String className)
      Gets all known direct subclasses of the specified class. A known direct subclass is one which was found during the scanning process; however, this is often not the complete universe of subclasses, since typically indexes are constructed per jar. It is expected that several indexes will need to be searched when analyzing a jar that is a part of a complex multi-module/classloader environment (like an EE application server).

      Note that this will only pick up direct subclasses of the class. It will not pick up subclasses of subclasses.

      Also note that interfaces are considered direct subclasses of java.lang.Object.

      Parameters:
      className - the super class of the desired subclasses
      Returns:
      a non-null list of all known subclasses of className
    • getKnownDirectSubclasses

      default Collection<ClassInfo> getKnownDirectSubclasses(Class<?> clazz)
      Gets all known direct subclasses of the specified class. A known direct subclass is one which was found during the scanning process; however, this is often not the complete universe of subclasses, since typically indexes are constructed per jar. It is expected that several indexes will need to be searched when analyzing a jar that is a part of a complex multi-module/classloader environment (like an EE application server).

      Note that this will only pick up direct subclasses of the class. It will not pick up subclasses of subclasses.

      Also note that interfaces are considered direct subclasses of java.lang.Object.

      Parameters:
      clazz - the super class of the desired subclasses
      Returns:
      a non-null list of all known subclasses of className
    • getAllKnownSubclasses

      Collection<ClassInfo> getAllKnownSubclasses(DotName className)
      Returns all known (including non-direct) subclasses of the given class. I.e., returns all known classes that are assignable to the given class.
      Parameters:
      className - The class
      Returns:
      All known subclasses
    • getAllKnownSubclasses

      default Collection<ClassInfo> getAllKnownSubclasses(String className)
      Returns all known (including non-direct) subclasses of the given class. I.e., returns all known classes that are assignable to the given class.
      Parameters:
      className - The class
      Returns:
      All known subclasses
    • getAllKnownSubclasses

      default Collection<ClassInfo> getAllKnownSubclasses(Class<?> clazz)
      Returns all known (including non-direct) subclasses of the given class. I.e., returns all known classes that are assignable to the given class.
      Parameters:
      clazz - The class
      Returns:
      All known subclasses
    • getKnownDirectSubinterfaces

      Collection<ClassInfo> getKnownDirectSubinterfaces(DotName interfaceName)
      Gets all known direct subinterfaces of the specified interface. A known direct subinterface is one which was found during the scanning process; however, this is often not the complete universe of subinterfaces, since typically indexes are constructed per jar. It is expected that several indexes will need to be searched when analyzing a jar that is a part of a complex multi-module/classloader environment (like an EE application server).

      Note that this will only pick up direct subinterfaces of the interface. It will not pick up subinterfaces of subinterfaces.

      Parameters:
      interfaceName - the super interface of the desired subinterfaces
      Returns:
      a non-null list of all known subinterfaces of interfaceName
      Since:
      3.0
    • getKnownDirectSubinterfaces

      default Collection<ClassInfo> getKnownDirectSubinterfaces(String interfaceName)
      Gets all known direct subinterfaces of the specified interface. A known direct subinterface is one which was found during the scanning process; however, this is often not the complete universe of subinterfaces, since typically indexes are constructed per jar. It is expected that several indexes will need to be searched when analyzing a jar that is a part of a complex multi-module/classloader environment (like an EE application server).

      Note that this will only pick up direct subinterfaces of the interface. It will not pick up subinterfaces of subinterfaces.

      Parameters:
      interfaceName - the super interface of the desired subinterfaces
      Returns:
      a non-null list of all known subinterfaces of interfaceName
      Since:
      3.0
    • getKnownDirectSubinterfaces

      default Collection<ClassInfo> getKnownDirectSubinterfaces(Class<?> interfaceClass)
      Gets all known direct subinterfaces of the specified interface. A known direct subinterface is one which was found during the scanning process; however, this is often not the complete universe of subinterfaces, since typically indexes are constructed per jar. It is expected that several indexes will need to be searched when analyzing a jar that is a part of a complex multi-module/classloader environment (like an EE application server).

      Note that this will only pick up direct subinterfaces of the interface. It will not pick up subinterfaces of subinterfaces.

      Parameters:
      interfaceClass - the super interface of the desired subinterfaces
      Returns:
      a non-null list of all known subinterfaces of interfaceClass
      Since:
      3.0
    • getAllKnownSubinterfaces

      Collection<ClassInfo> getAllKnownSubinterfaces(DotName interfaceName)
      Returns all known interfaces that extend the given interface, directly and indirectly. I.e., returns every interface in the index that is assignable to the given interface.
      Parameters:
      interfaceName - The interface
      Returns:
      all known subinterfaces
      Since:
      3.0
    • getAllKnownSubinterfaces

      default Collection<ClassInfo> getAllKnownSubinterfaces(String interfaceName)
      Returns all known interfaces that extend the given interface, directly and indirectly. I.e., returns every interface in the index that is assignable to the given interface.
      Parameters:
      interfaceName - The interface
      Returns:
      all known subinterfaces
      Since:
      3.0
    • getAllKnownSubinterfaces

      default Collection<ClassInfo> getAllKnownSubinterfaces(Class<?> interfaceClass)
      Returns all known interfaces that extend the given interface, directly and indirectly. I.e., returns every interface in the index that is assignable to the given interface.
      Parameters:
      interfaceClass - The interface
      Returns:
      all known subinterfaces
      Since:
      3.0
    • getKnownDirectImplementors

      Collection<ClassInfo> getKnownDirectImplementors(DotName interfaceName)
      Gets all known direct implementors of the specified interface. A known direct implementor is one which was found during the scanning process; however, this is often not the complete universe of implementors, since typically indexes are constructed per jar. It is expected that several indexes will need to be searched when analyzing a jar that is a part of a complex multi-module/classloader environment (like an EE application server).

      The list of implementors also includes direct subinterfaces. This is inconsistent with getAllKnownImplementors(DotName), which doesn't return subinterfaces.

      Note that this will only pick up classes that directly implement given interface. It will not pick up classes implementing subinterfaces.

      Parameters:
      interfaceName - The interface
      Returns:
      All known direct implementors of the interface
    • getKnownDirectImplementors

      default Collection<ClassInfo> getKnownDirectImplementors(String interfaceName)
      Gets all known direct implementors of the specified interface name. A known direct implementor is one which was found during the scanning process; however, this is often not the complete universe of implementors, since typically indexes are constructed per jar. It is expected that several indexes will need to be searched when analyzing a jar that is a part of a complex multi-module/classloader environment (like an EE application server).

      The list of implementors also includes direct subinterfaces. This is inconsistent with getAllKnownImplementors(String), which doesn't return subinterfaces.

      Note that this will only pick up classes that directly implement given interface. It will not pick up classes implementing subinterfaces.

      Parameters:
      interfaceName - The interface
      Returns:
      All known direct implementors of the interface
    • getKnownDirectImplementors

      default Collection<ClassInfo> getKnownDirectImplementors(Class<?> interfaceClass)
      Gets all known direct implementors of the specified interface name. A known direct implementor is one which was found during the scanning process; however, this is often not the complete universe of implementors, since typically indexes are constructed per jar. It is expected that several indexes will need to be searched when analyzing a jar that is a part of a complex multi-module/classloader environment (like an EE application server).

      The list of implementors also includes direct subinterfaces. This is inconsistent with getAllKnownImplementors(Class), which doesn't return subinterfaces.

      Note that this will only pick up classes that directly implement given interface. It will not pick up classes implementing subinterfaces.

      Parameters:
      interfaceClass - The interface
      Returns:
      All known direct implementors of the interface
    • getAllKnownImplementors

      Collection<ClassInfo> getAllKnownImplementors(DotName interfaceName)
      Returns all known classes that implement the given interface, directly and indirectly. This will return all classes that implement the interface and its subinterfaces, as well as subclasses of classes that implement the interface and its subinterfaces. (In short, it will return every class in the index that is assignable to the interface.)

      Note that this method only returns classes. Unlike getKnownDirectImplementors(DotName), this method does not return subinterfaces of given interface.

      Parameters:
      interfaceName - The interface
      Returns:
      All known implementors of the interface
    • getAllKnownImplementors

      default Collection<ClassInfo> getAllKnownImplementors(String interfaceName)
      Returns all known classes that implement the given interface, directly and indirectly. This will return all classes that implement the interface and its subinterfaces, as well as subclasses of classes that implement the interface and its subinterfaces. (In short, it will return every class in the index that is assignable to the interface.)

      Note that this method only returns classes. Unlike getKnownDirectImplementors(String), this method does not return subinterfaces of given interface.

      Parameters:
      interfaceName - The interface
      Returns:
      All known implementors of the interface
    • getAllKnownImplementors

      default Collection<ClassInfo> getAllKnownImplementors(Class<?> interfaceClass)
      Returns all known classes that implement the given interface, directly and indirectly. This will return all classes that implement the interface and its subinterfaces, as well as subclasses of classes that implement the interface and its subinterfaces. (In short, it will return every class in the index that is assignable to the interface.)

      Note that this method only returns classes. Unlike getKnownDirectImplementors(Class), this method does not return subinterfaces of given interface.

      Parameters:
      interfaceClass - The interface
      Returns:
      All known implementors of the interface
    • getAnnotations

      Collection<AnnotationInstance> getAnnotations(DotName annotationName)
      Obtains a list of instances for the specified annotation. This is done using an O(1) lookup. Valid instance targets include field, method, parameter, and class.
      Parameters:
      annotationName - the name of the annotation to look for
      Returns:
      a non-null list of annotation instances
    • getAnnotations

      default Collection<AnnotationInstance> getAnnotations(String annotationName)
      Obtains a list of instances for the specified annotation. This is done using an O(1) lookup. Valid instance targets include field, method, parameter, and class.
      Parameters:
      annotationName - the name of the annotation to look for
      Returns:
      a non-null list of annotation instances
    • getAnnotations

      default Collection<AnnotationInstance> getAnnotations(Class<?> annotationType)
      Obtains a list of instances for the specified annotation. This is done using an O(1) lookup. Valid instance targets include field, method, parameter, and class.
      Parameters:
      annotationType - the type of the annotation to look for
      Returns:
      a non-null list of annotation instances
    • getAnnotationsWithRepeatable

      Collection<AnnotationInstance> getAnnotationsWithRepeatable(DotName annotationName, IndexView index)
      Obtains a list of instances for the specified annotation. If the specified annotation is repeatable (JLS 9.6), the result also contains all values from all instances of the container annotation. In this case, the AnnotationInstance.target() returns the target of the container annotation instance.
      Parameters:
      annotationName - the name of the repeatable annotation
      index - the index containing the annotation class
      Returns:
      a non-null list of annotation instances
      Throws:
      IllegalArgumentException - If the index does not contain the annotation definition or if it does not represent an annotation type
    • getAnnotationsWithRepeatable

      default Collection<AnnotationInstance> getAnnotationsWithRepeatable(String annotationName, IndexView index)
      Obtains a list of instances for the specified annotation. If the specified annotation is repeatable (JLS 9.6), the result also contains all values from all instances of the container annotation. In this case, the AnnotationInstance.target() returns the target of the container annotation instance.
      Parameters:
      annotationName - the name of the repeatable annotation
      index - the index containing the annotation class
      Returns:
      a non-null list of annotation instances
      Throws:
      IllegalArgumentException - If the index does not contain the annotation definition or if it does not represent an annotation type
    • getAnnotationsWithRepeatable

      default Collection<AnnotationInstance> getAnnotationsWithRepeatable(Class<?> annotationType, IndexView index)
      Obtains a list of instances for the specified annotation. If the specified annotation is repeatable (JLS 9.6), the result also contains all values from all instances of the container annotation. In this case, the AnnotationInstance.target() returns the target of the container annotation instance.
      Parameters:
      annotationType - the name of the repeatable annotation
      index - the index containing the annotation class
      Returns:
      a non-null list of annotation instances
      Throws:
      IllegalArgumentException - If the index does not contain the annotation definition or if it does not represent an annotation type
    • getKnownModules

      Collection<ModuleInfo> getKnownModules()
      Gets all known modules by this index (those which were scanned).
      Returns:
      a collection of known modules
    • getModuleByName

      ModuleInfo getModuleByName(DotName moduleName)
      Gets the module that was scanned during the indexing phase.
      Parameters:
      moduleName - the name of the module
      Returns:
      information about the module or null if it is not known
    • getModuleByName

      default ModuleInfo getModuleByName(String moduleName)
      Gets the module that was scanned during the indexing phase.
      Parameters:
      moduleName - the name of the module
      Returns:
      information about the module or null if it is not known
    • getKnownUsers

      Collection<ClassInfo> getKnownUsers(DotName className)
      Returns a list of classes in this index that use the specified class. For one class to use another class, the other class has to:
      • occur in the signature of the class (that is, in the superclass type, in the superinterface types, in the type parameters, or in the list of permitted subclasses), or
      • occur in the signature of any of the class's methods (that is, in the return type, in the parameter types, in the exception types, or in the type parameters), or
      • occur in the type of any of the class's fields or record components, or
      • occur in the list of class references in the constant pool, as described by the JLS and JVMS.
      Parameters:
      className - the name of the class to look for
      Returns:
      a non-null list of classes that use the specified class
    • getKnownUsers

      default Collection<ClassInfo> getKnownUsers(String className)
      Returns a list of classes in this index that use the specified class. For one class to use another class, the other class has to:
      • occur in the signature of the class (that is, in the superclass type, in the superinterface types, in the type parameters, or in the list of permitted subclasses), or
      • occur in the signature of any of the class's methods (that is, in the return type, in the parameter types, in the exception types, or in the type parameters), or
      • occur in the type of any of the class's fields or record components, or
      • occur in the list of class references in the constant pool, as described by the JLS and JVMS.
      Parameters:
      className - the name of the class to look for
      Returns:
      a non-null list of classes that use the specified class
    • getKnownUsers

      default Collection<ClassInfo> getKnownUsers(Class<?> clazz)
      Returns a list of classes in this index that use the specified class. For one class to use another class, the other class has to:
      • occur in the signature of the class (that is, in the superclass type, in the superinterface types, in the type parameters, or in the list of permitted subclasses), or
      • occur in the signature of any of the class's methods (that is, in the return type, in the parameter types, in the exception types, or in the type parameters), or
      • occur in the type of any of the class's fields or record components, or
      • occur in the list of class references in the constant pool of the class, as described by the JLS and JVMS.
      Parameters:
      clazz - the class to look for
      Returns:
      a non-null list of classes that use the specified class
    • getClassesInPackage

      Collection<ClassInfo> getClassesInPackage(DotName packageName)
      Returns all classes known to this index that are present in given package. Classes present in subpackages of given package are not returned. Classes present in the unnamed package may be looked up using null as the package name. If this index does not contain any class in given package, returns an empty collection.

      In the default Index implementation, this information is not stored in the index initially. Instead, an index of classes by package name is constructed on demand (on the first invocation of this method).

      Parameters:
      packageName - package name in the common, dot-separated form (e.g. com.example.foobar); null means the unnamed package
      Returns:
      immutable collection of classes present in given package, never null
      Since:
      3.0
    • getClassesInPackage

      default Collection<ClassInfo> getClassesInPackage(String packageName)
      Returns all classes known to this index that are present in given package. Classes present in subpackages of given package are not returned. Classes present in the unnamed package may be looked up using null as the package name. If this index does not contain any class in given package, returns an empty collection.

      In the default Index implementation, this information is not stored in the index initially. Instead, an index of classes by package name is constructed on demand (on the first invocation of this method).

      Parameters:
      packageName - package name in the common, dot-separated form (e.g. com.example.foobar); null means the unnamed package
      Returns:
      immutable collection of classes present in given package, never null
      Since:
      3.0
    • getSubpackages

      Set<DotName> getSubpackages(DotName packageName)
      Returns a set of packages known to this index that are direct subpackages of given package. Indirect subpackages of given package (subpackages of subpackages) are not returned. If this index does not contain any class in a direct or indirect subpackage of given package, returns an empty collection.

      Given that the unnamed package may not contain subpackages, passing null as the package name is permitted, but always results in an empty set.

      In the default Index implementation, this information is not stored in the index initially. Instead, an index of packages is constructed on demand (on the first invocation of this method).

      Parameters:
      packageName - package name in the common, dot-separated form (e.g. com.example.foobar); null means the unnamed package
      Returns:
      immutable set of subpackages of given package, never null
      Since:
      3.0
    • getSubpackages

      default Set<DotName> getSubpackages(String packageName)
      Returns a set of packages known to this index that are direct subpackages of given package. Indirect subpackages of given package (subpackages of subpackages) are not returned. If this index does not contain any class in a direct or indirect subpackage of given package, returns an empty collection.

      Given that the unnamed package may not contain subpackages, passing null as the package name is permitted, but always results in an empty set.

      In the default Index implementation, this information is not stored in the index initially. Instead, an index of packages is constructed on demand (on the first invocation of this method).

      Parameters:
      packageName - package name in the common, dot-separated form (e.g. com.example.foobar); null means the unnamed package
      Returns:
      immutable set of subpackages of given package, never null
      Since:
      3.0