ElementUtils (checker-framework 3.8.0 API)

java.lang.Object
- org.checkerframework.javacutil.ElementUtils

```
public class ElementUtils
extends Object
```
Utility methods for analyzing Elements. This complements Elements, providing functionality that it does not.

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static Set<ElementKind>`	`classElementKinds()` Return the set of kinds that represent classes.
`static @Nullable TypeElement`	`enclosingClass(Element elem)` Returns the innermost type element enclosing the given element.
`static PackageElement`	`enclosingPackage(Element elem)` Returns the innermost package element enclosing the given element.
`static @Nullable VariableElement`	`findFieldInType(TypeElement type, String name)` Returns the field of the class or `null` if not found.
`static Set<VariableElement>`	`findFieldsInType(TypeElement type, Collection<String> names)` Returns the elements of the fields whose simple names are `names` and are declared in `type`.
`static Set<VariableElement>`	`findFieldsInTypeOrSuperType(TypeMirror type, Collection<String> names)` Returns non-private field elements, and side-effects `names` to remove them.
`static List<VariableElement>`	`getAllFieldsIn(TypeElement type, Elements elements)` Return all fields declared in the given type or any superclass/interface.
`static List<ExecutableElement>`	`getAllMethodsIn(TypeElement type, Elements elements)` Return all methods declared in the given type or any superclass/interface.
`static List<TypeElement>`	`getAllSupertypes(TypeElement type, ProcessingEnvironment env)` Get all the supertypes of a given type, including the type itself.
`static List<TypeElement>`	`getAllTypeElementsIn(TypeElement type)` Return all nested/inner classes/interfaces declared in the given type.
`static Set<? extends ExecutableElement>`	`getOverriddenMethods(ExecutableElement m, Types types)` Returns the methods that are overriden or implemented by a given method.
`static @Nullable Name`	`getQualifiedClassName(Element element)` Returns the qualified name of the innermost class enclosing the provided `Element`.
`static String`	`getQualifiedName(Element elt)` Returns a verbose name that identifies the element.
`static CharSequence`	`getSimpleNameOrDescription(ExecutableElement element)` Returns a user-friendly name for the given method.
`static String`	`getSimpleSignature(ExecutableElement element)` Returns the canonical representation of the method declaration, which contains simple names of the types only.
`static List<TypeElement>`	`getSuperTypes(TypeElement type, Elements elements)` Determine all type elements for the classes and interfaces referenced (directly or indirectly) in the extends/implements clauses of the given type element.
`static TypeMirror`	`getType(Element element)` Returns the `TypeMirror` for usage of Element as a value.
`static TypeElement`	`getTypeElement(ProcessingEnvironment processingEnv, Class<?> clazz)` Returns the TypeElement for the given class.
`static boolean`	`hasAnnotation(Element element, String annotName)` Given an annotation name, return true if the element has the annotation of that name.
`static boolean`	`hasReceiver(Element element)` Does the given element need a receiver for accesses? For example, an access to a local variable does not require a receiver.
`static boolean`	`isClassElement(Element element)` Is the given element kind a class, i.e.
`static boolean`	`isCompileTimeConstant(Element elt)` Returns true if the element is a reference to a compile-time constant.
`static boolean`	`isEffectivelyFinal(Element element)` Returns true if the element is a effectively final element.
`static boolean`	`isElementFromByteCode(Element elt)` Returns true if the element is declared in ByteCode.
`static boolean`	`isElementFromSourceCode(@Nullable Element element)` Checks whether a given element came from a source file.
`static boolean`	`isError(Element element)` Returns true if `element` is "com.sun.tools.javac.comp.Resolve$SymbolNotFoundError".
`static boolean`	`isFinal(Element element)` Returns true if the element is a final element: a final field, final method, or final class.
`static boolean`	`isMethod(ExecutableElement questioned, ExecutableElement method, ProcessingEnvironment env)` Returns true if the given element is, or overrides, method.
`static boolean`	`isObject(TypeElement element)` Check if the element is an element for 'java.lang.Object'
`static boolean`	`isStatic(Element element)` Returns true if the element is a static element: whether it is a static field, static method, or static class.
`static boolean`	`isTypeDeclaration(Element elt)` Return true if the element is a type declaration.
`static boolean`	`matchesElement(ExecutableElement method, String methodName, Class<?>... parameters)` Check that a method Element matches a signature.
`static @Nullable PackageElement`	`parentPackage(PackageElement elem, Elements e)` Returns the "parent" package element for the given package element.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - enclosingClass
```
public static @Nullable TypeElement enclosingClass(Element elem)
```
    Returns the innermost type element enclosing the given element.
    
    Parameters:
    
    elem - the enclosed element of a class
    
    Returns:
    
    the innermost type element, or null if no type element encloses elem
  - enclosingPackage
```
public static PackageElement enclosingPackage(Element elem)
```
    Returns the innermost package element enclosing the given element. The same effect as Elements.getPackageOf(Element). Returns the element itself if it is a package.
    
    Parameters:
    
    elem - the enclosed element of a package
    
    Returns:
    
    the innermost package element
  - parentPackage
```
public static @Nullable PackageElement parentPackage(PackageElement elem,
                                                     Elements e)
```
    Returns the "parent" package element for the given package element. For package "A.B" it gives "A". For package "A" it gives the default package. For the default package it returns null.
    Note that packages are not enclosed within each other, we have to manually climb the namespaces. Calling "enclosingPackage" on a package element returns the package element itself again.
    
    Parameters:
    
    elem - the package to start from
    
    Returns:
    
    the parent package element or null
  - isStatic
```
public static boolean isStatic(Element element)
```
    Returns true if the element is a static element: whether it is a static field, static method, or static class.
    
    Returns:
    
    true if element is static
  - isFinal
```
public static boolean isFinal(Element element)
```
    Returns true if the element is a final element: a final field, final method, or final class.
    
    Returns:
    
    true if the element is final
  - isEffectivelyFinal
```
public static boolean isEffectivelyFinal(Element element)
```
    Returns true if the element is a effectively final element.
    
    Returns:
    
    true if the element is effectively final
  - getType
```
public static TypeMirror getType(Element element)
```
    Returns the TypeMirror for usage of Element as a value. It returns the return type of a method element, the class type of a constructor, or simply the type mirror of the element itself.
    
    Parameters:
    
    element - the element whose type to obtain
    
    Returns:
    
    the type for the element used as a value
  - getQualifiedClassName
```
public static @Nullable Name getQualifiedClassName(Element element)
```
    Returns the qualified name of the innermost class enclosing the provided Element.
    
    Parameters:
    
    element - an element enclosed by a class, or a TypeElement
    
    Returns:
    
    the qualified Name of the innermost class enclosing the element
  - getQualifiedName
```
public static String getQualifiedName(Element elt)
```
    Returns a verbose name that identifies the element.
    
    Parameters:
    
    elt - the element whose name to obtain
    
    Returns:
    
    the qualified name of the given element
  - getSimpleSignature
```
public static String getSimpleSignature(ExecutableElement element)
```
    Returns the canonical representation of the method declaration, which contains simple names of the types only.
    
    Parameters:
    
    element - a method declaration
    
    Returns:
    
    the simple name of the method, followed by the simple names of the formal parameter types
  - getSimpleNameOrDescription
```
public static CharSequence getSimpleNameOrDescription(ExecutableElement element)
```
    Returns a user-friendly name for the given method. Does not return "<init>" or "<clinit>" as ExecutableElement.getSimpleName() does.
    
    Parameters:
    
    element - a method declaration
    
    Returns:
    
    a user-friendly name for the method
  - isObject
```
public static boolean isObject(TypeElement element)
```
    Check if the element is an element for 'java.lang.Object'
    
    Parameters:
    
    element - the type element
    
    Returns:
    
    true iff the element is java.lang.Object element
  - isCompileTimeConstant
```
public static boolean isCompileTimeConstant(Element elt)
```
    Returns true if the element is a reference to a compile-time constant.
  - isElementFromSourceCode
```
public static boolean isElementFromSourceCode(@Nullable Element element)
```
    Checks whether a given element came from a source file.
    By contrast, isElementFromByteCode(Element) returns true if there is a classfile for the given element, even if there is also a source file.
    
    Parameters:
    
    element - the element to check, or null
    
    Returns:
    
    true if a source file containing the element is being compiled
  - isElementFromByteCode
```
public static boolean isElementFromByteCode(Element elt)
```
    Returns true if the element is declared in ByteCode. Always return false if elt is a package.
  - findFieldInType
```
public static @Nullable VariableElement findFieldInType(TypeElement type,
                                                        String name)
```
    Returns the field of the class or null if not found.
  - findFieldsInType
```
public static Set<VariableElement> findFieldsInType(TypeElement type,
                                                    Collection<String> names)
```
    Returns the elements of the fields whose simple names are names and are declared in type.
    If a field isn't declared in type, its element isn't included in the returned set. If none of the fields is declared in type, the empty set is returned.
    
    Parameters:
    
    type - where to look for fields
    
    names - simple names of fields that might be declared in type
    
    Returns:
    
    the elements of the fields whose simple names are names and are declared in type
  - findFieldsInTypeOrSuperType
```
public static Set<VariableElement> findFieldsInTypeOrSuperType(TypeMirror type,
                                                               Collection<String> names)
```
    Returns non-private field elements, and side-effects names to remove them. For every field name in names that is declared in type or a supertype, add its element to the returned set and remove it from names.
    When this routine returns, the combination of the return value and names has the same cardinality, and represents the same fields, as names did when the method was called.
    
    Parameters:
    
    type - where to look for fields
    
    names - simple names of fields that might be declared in type or a supertype. (Names that are found are removed from this list.)
    
    Returns:
    
    the VariableElements for non-private fields that are declared in type whose simple names were in names when the method was called.
  - isError
```
public static boolean isError(Element element)
```
    Returns true if element is "com.sun.tools.javac.comp.Resolve$SymbolNotFoundError".
    
    Parameters:
    
    element - the element to test
    
    Returns:
    
    true if element is "com.sun.tools.javac.comp.Resolve$SymbolNotFoundError"
  - hasReceiver
```
public static boolean hasReceiver(Element element)
```
    Does the given element need a receiver for accesses? For example, an access to a local variable does not require a receiver.
    
    Parameters:
    
    element - the element to test
    
    Returns:
    
    whether the element requires a receiver for accesses
  - getSuperTypes
```
public static List<TypeElement> getSuperTypes(TypeElement type,
                                              Elements elements)
```
    Determine all type elements for the classes and interfaces referenced (directly or indirectly) in the extends/implements clauses of the given type element.
    TODO: can we learn from the implementation of com.sun.tools.javac.model.JavacElements.getAllMembers(TypeElement)?
  - getAllFieldsIn
```
public static List<VariableElement> getAllFieldsIn(TypeElement type,
                                                   Elements elements)
```
    Return all fields declared in the given type or any superclass/interface. TODO: should this use javax.lang.model.util.Elements.getAllMembers(TypeElement) instead of our own getSuperTypes?
  - getAllMethodsIn
```
public static List<ExecutableElement> getAllMethodsIn(TypeElement type,
                                                      Elements elements)
```
    Return all methods declared in the given type or any superclass/interface. Note that no constructors will be returned. TODO: should this use javax.lang.model.util.Elements.getAllMembers(TypeElement) instead of our own getSuperTypes?
  - getAllTypeElementsIn
```
public static List<TypeElement> getAllTypeElementsIn(TypeElement type)
```
    Return all nested/inner classes/interfaces declared in the given type.
  - classElementKinds
```
public static Set<ElementKind> classElementKinds()
```
    Return the set of kinds that represent classes.
    
    Returns:
    
    the set of kinds that represent classes
  - isClassElement
```
public static boolean isClassElement(Element element)
```
    Is the given element kind a class, i.e. a class, enum, interface, or annotation type.
    
    Parameters:
    
    element - the element to test
    
    Returns:
    
    true, iff the given kind is a class kind
  - isTypeDeclaration
```
public static boolean isTypeDeclaration(Element elt)
```
    Return true if the element is a type declaration.
    
    Parameters:
    
    elt - the element to test
    
    Returns:
    
    true if the argument is a type declaration
  - matchesElement
```
public static boolean matchesElement(ExecutableElement method,
                                     String methodName,
                                     Class<?>... parameters)
```
    Check that a method Element matches a signature.
    Note: Matching the receiver type must be done elsewhere as the Element receiver type is only populated when annotated.
    
    Parameters:
    
    method - the method Element to be tested
    
    methodName - the goal method name
    
    parameters - the goal formal parameter Classes
    
    Returns:
    
    true if the method matches the methodName and parameters
  - isMethod
```
public static boolean isMethod(ExecutableElement questioned,
                               ExecutableElement method,
                               ProcessingEnvironment env)
```
    Returns true if the given element is, or overrides, method.
  - hasAnnotation
```
public static boolean hasAnnotation(Element element,
                                    String annotName)
```
    Given an annotation name, return true if the element has the annotation of that name.
    
    Parameters:
    
    element - the element
    
    annotName - name of the annotation
    
    Returns:
    
    true if the element has the annotation of that name
  - getTypeElement
```
public static TypeElement getTypeElement(ProcessingEnvironment processingEnv,
                                         Class<?> clazz)
```
    Returns the TypeElement for the given class.
    
    Parameters:
    
    processingEnv - the processing environment
    
    clazz - a class
    
    Returns:
    
    the TypeElement for the class
  - getAllSupertypes
```
public static List<TypeElement> getAllSupertypes(TypeElement type,
                                                 ProcessingEnvironment env)
```
    Get all the supertypes of a given type, including the type itself.
    
    Parameters:
    
    type - a type
    
    env - the processing environment
    
    Returns:
    
    list including the type and all its supertypes, with a guarantee that supertypes (i.e. those that appear in extends clauses) appear before indirect supertypes
  - getOverriddenMethods
```
public static Set<? extends ExecutableElement> getOverriddenMethods(ExecutableElement m,
                                                                    Types types)
```
    Returns the methods that are overriden or implemented by a given method.
    
    Parameters:
    
    m - a method
    
    types - the type utilities
    
    Returns:
    
    the methods that m overrides or implements

Class ElementUtils

Method Summary

Methods inherited from class java.lang.Object

Method Detail

enclosingClass

enclosingPackage

parentPackage

isStatic

isFinal

isEffectivelyFinal

getType

getQualifiedClassName

getQualifiedName

getSimpleSignature

getSimpleNameOrDescription

isObject

isCompileTimeConstant

isElementFromSourceCode

isElementFromByteCode

findFieldInType

findFieldsInType

findFieldsInTypeOrSuperType

isError

hasReceiver

getSuperTypes

getAllFieldsIn

getAllMethodsIn

getAllTypeElementsIn

classElementKinds

isClassElement

isTypeDeclaration

matchesElement

isMethod

hasAnnotation

getTypeElement

getAllSupertypes

getOverriddenMethods