Elements

```
public interface Elements
```
Utility methods for operating on program elements.
Compatibility Note: Methods may be added to this interface in future releases of the platform.

从以下版本开始:

1.6

另请参阅:

ProcessingEnvironment.getElementUtils()

方法概要

所有方法实例方法抽象方法
限定符和类型	方法	说明
`List<? extends AnnotationMirror>`	`getAllAnnotationMirrors(Element e)`	Returns all annotations present on an element, whether directly present or present via inheritance.
`List<? extends Element>`	`getAllMembers(TypeElement type)`	Returns all members of a type element, whether inherited or declared directly.
`Name`	`getBinaryName(TypeElement type)`	Returns the binary name of a type element.
`String`	`getConstantExpression(Object value)`	Returns the text of a constant expression representing a primitive value or a string.
`String`	`getDocComment(Element e)`	Returns the text of the documentation ("Javadoc") comment of an element.
`Map<? extends ExecutableElement,? extends AnnotationValue>`	`getElementValuesWithDefaults(AnnotationMirror a)`	Returns the values of an annotation's elements, including defaults.
`Name`	`getName(CharSequence cs)`	Return a name with the same sequence of characters as the argument.
`PackageElement`	`getPackageElement(CharSequence name)`	Returns a package given its fully qualified name.
`PackageElement`	`getPackageOf(Element type)`	Returns the package of an element.
`TypeElement`	`getTypeElement(CharSequence name)`	Returns a type element given its canonical name.
`boolean`	`hides(Element hider, Element hidden)`	Tests whether one type, method, or field hides another.
`boolean`	`isDeprecated(Element e)`	Returns `true` if the element is deprecated, `false` otherwise.
`boolean`	`isFunctionalInterface(TypeElement type)`	Returns `true` if the type element is a functional interface, `false` otherwise.
`boolean`	`overrides(ExecutableElement overrider, ExecutableElement overridden, TypeElement type)`	Tests whether one method, as a member of a given type, overrides another method.
`void`	`printElements(Writer w, Element... elements)`	Prints a representation of the elements to the given writer in the specified order.

- 方法详细资料
  - getPackageElement
```
PackageElement getPackageElement(CharSequence name)
```
    Returns a package given its fully qualified name.
    
    参数:
    
    name - fully qualified package name, or "" for an unnamed package
    
    返回:
    
    the named package, or null if it cannot be found
  - getTypeElement
```
TypeElement getTypeElement(CharSequence name)
```
    Returns a type element given its canonical name.
    
    参数:
    
    name - the canonical name
    
    返回:
    
    the named type element, or null if it cannot be found
  - getElementValuesWithDefaults
```
Map<? extends ExecutableElement,? extends AnnotationValue> getElementValuesWithDefaults(AnnotationMirror a)
```
    Returns the values of an annotation's elements, including defaults.
    
    参数:
    
    a - annotation to examine
    
    返回:
    
    the values of the annotation's elements, including defaults
    
    另请参阅:
    
    AnnotationMirror.getElementValues()
  - getDocComment
```
String getDocComment(Element e)
```
    Returns the text of the documentation ("Javadoc") comment of an element.
    A documentation comment of an element is a comment that begins with "/**" , ends with a separate "*/", and immediately precedes the element, ignoring white space. Therefore, a documentation comment contains at least three"*" characters. The text returned for the documentation comment is a processed form of the comment as it appears in source code. The leading "/**" and trailing "*/" are removed. For lines of the comment starting after the initial "/**", leading white space characters are discarded as are any consecutive "*" characters appearing after the white space or starting the line. The processed lines are then concatenated together (including line terminators) and returned.
    
    参数:
    
    e - the element being examined
    
    返回:
    
    the documentation comment of the element, or null if there is none
  - isDeprecated
```
boolean isDeprecated(Element e)
```
    Returns true if the element is deprecated, false otherwise.
    
    参数:
    
    e - the element being examined
    
    返回:
    
    true if the element is deprecated, false otherwise
  - getBinaryName
```
Name getBinaryName(TypeElement type)
```
    Returns the binary name of a type element.
    
    参数:
    
    type - the type element being examined
    
    返回:
    
    the binary name
    
    另请参阅:
    
    TypeElement.getQualifiedName()
  - getPackageOf
```
PackageElement getPackageOf(Element type)
```
    Returns the package of an element. The package of a package is itself.
    
    参数:
    
    type - the element being examined
    
    返回:
    
    the package of an element
  - getAllMembers
```
List<? extends Element> getAllMembers(TypeElement type)
```
    Returns all members of a type element, whether inherited or declared directly. For a class the result also includes its constructors, but not local or anonymous classes.
    Note that elements of certain kinds can be isolated using methods in ElementFilter.
    
    参数:
    
    type - the type being examined
    
    返回:
    
    all members of the type
    
    另请参阅:
    
    Element.getEnclosedElements()
  - getAllAnnotationMirrors
```
List<? extends AnnotationMirror> getAllAnnotationMirrors(Element e)
```
    Returns all annotations present on an element, whether directly present or present via inheritance.
    
    参数:
    
    e - the element being examined
    
    返回:
    
    all annotations of the element
    
    另请参阅:
    
    Element.getAnnotationMirrors(), AnnotatedConstruct
  - hides
```
boolean hides(Element hider,
              Element hidden)
```
    Tests whether one type, method, or field hides another.
    
    参数:
    
    hider - the first element
    
    hidden - the second element
    
    返回:
    
    true if and only if the first element hides the second
  - overrides
```
boolean overrides(ExecutableElement overrider,
                  ExecutableElement overridden,
                  TypeElement type)
```
    Tests whether one method, as a member of a given type, overrides another method. When a non-abstract method overrides an abstract one, the former is also said to implement the latter.
    In the simplest and most typical usage, the value of the type parameter will simply be the class or interface directly enclosing overrider (the possibly-overriding method). For example, suppose m1 represents the method String.hashCode and m2 represents Object.hashCode. We can then ask whether m1 overrides m2 within the class String (it does):
    assert elements.overrides(m1, m2, elements.getTypeElement("java.lang.String"));
    A more interesting case can be illustrated by the following example in which a method in type A does not override a like-named method in type B:
    class A { public void m() {} }
    interface B { void m(); }
    ...
    m1 = ...; // A.m
    m2 = ...; // B.m
    assert ! elements.overrides(m1, m2, elements.getTypeElement("A"));
    When viewed as a member of a third type C, however, the method in A does override the one in B:
    class C extends A implements B {}
    ...
    assert elements.overrides(m1, m2, elements.getTypeElement("C"));
    
    参数:
    
    overrider - the first method, possible overrider
    
    overridden - the second method, possibly being overridden
    
    type - the type of which the first method is a member
    
    返回:
    
    true if and only if the first method overrides the second
  - getConstantExpression
```
String getConstantExpression(Object value)
```
    Returns the text of a constant expression representing a primitive value or a string. The text returned is in a form suitable for representing the value in source code.
    
    参数:
    
    value - a primitive value or string
    
    返回:
    
    the text of a constant expression
    
    抛出:
    
    IllegalArgumentException - if the argument is not a primitive value or string
    
    另请参阅:
    
    VariableElement.getConstantValue()
  - printElements
```
void printElements(Writer w,
                   Element... elements)
```
    Prints a representation of the elements to the given writer in the specified order. The main purpose of this method is for diagnostics. The exact format of the output is not specified and is subject to change.
    
    参数:
    
    w - the writer to print the output to
    
    elements - the elements to print
  - getName
```
Name getName(CharSequence cs)
```
    Return a name with the same sequence of characters as the argument.
    
    参数:
    
    cs - the character sequence to return as a name
    
    返回:
    
    a name with the same sequence of characters as the argument
  - isFunctionalInterface
```
boolean isFunctionalInterface(TypeElement type)
```
    Returns true if the type element is a functional interface, false otherwise.
    
    参数:
    
    type - the type element being examined
    
    返回:
    
    true if the element is a functional interface, false otherwise
    
    从以下版本开始:
    
    1.8

接口 Elements

方法概要

方法详细资料

getPackageElement

getTypeElement

getElementValuesWithDefaults

getDocComment

isDeprecated

getBinaryName

getPackageOf

getAllMembers

getAllAnnotationMirrors

hides

overrides

getConstantExpression

printElements

getName

isFunctionalInterface