diff -r 000000000000 -r 959103a6100f src/share/classes/javax/lang/model/element/Element.java --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/src/share/classes/javax/lang/model/element/Element.java Wed Apr 27 01:34:52 2016 +0800 @@ -0,0 +1,246 @@ +/* + * Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved. + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * This code is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License version 2 only, as + * published by the Free Software Foundation. Oracle designates this + * particular file as subject to the "Classpath" exception as provided + * by Oracle in the LICENSE file that accompanied this code. + * + * This code is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License + * version 2 for more details (a copy is included in the LICENSE file that + * accompanied this code). + * + * You should have received a copy of the GNU General Public License version + * 2 along with this work; if not, write to the Free Software Foundation, + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. + * + * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA + * or visit www.oracle.com if you need additional information or have any + * questions. + */ + +package javax.lang.model.element; + + +import java.lang.annotation.Annotation; +import java.lang.annotation.AnnotationTypeMismatchException; +import java.lang.annotation.IncompleteAnnotationException; +import java.util.List; +import java.util.Set; + +import javax.lang.model.type.*; +import javax.lang.model.util.*; + + +/** + * Represents a program element such as a package, class, or method. + * Each element represents a static, language-level construct + * (and not, for example, a runtime construct of the virtual machine). + * + *
Elements should be compared using the {@link #equals(Object)} + * method. There is no guarantee that any particular element will + * always be represented by the same object. + * + *
To implement operations based on the class of an {@code + * Element} object, either use a {@linkplain ElementVisitor visitor} or + * use the result of the {@link #getKind} method. Using {@code + * instanceof} is not necessarily a reliable idiom for + * determining the effective class of an object in this modeling + * hierarchy since an implementation may choose to have a single object + * implement multiple {@code Element} subinterfaces. + * + * @author Joseph D. Darcy + * @author Scott Seligman + * @author Peter von der Ahé + * @see Elements + * @see TypeMirror + * @since 1.6 + */ +public interface Element extends javax.lang.model.AnnotatedConstruct { + /** + * Returns the type defined by this element. + * + *
A generic element defines a family of types, not just one.
+ * If this is a generic element, a prototypical type is
+ * returned. This is the element's invocation on the
+ * type variables corresponding to its own formal type parameters.
+ * For example,
+ * for the generic class element {@code C Note that elements of certain kinds can be isolated using
+ * methods in {@link ElementFilter}.
+ *
+ * @return the enclosed elements, or an empty list if none
+ * @see PackageElement#getEnclosedElements
+ * @see TypeElement#getEnclosedElements
+ * @see Elements#getAllMembers
+ * @jls 8.8.9 Default Constructor
+ * @jls 8.9 Enums
+ */
+ List extends Element> getEnclosedElements();
+
+ /**
+ * Returns {@code true} if the argument represents the same
+ * element as {@code this}, or {@code false} otherwise.
+ *
+ * Note that the identity of an element involves implicit state
+ * not directly accessible from the element's methods, including
+ * state about the presence of unrelated types. Element objects
+ * created by different implementations of these interfaces should
+ * not be expected to be equal even if "the same"
+ * element is being modeled; this is analogous to the inequality
+ * of {@code Class} objects for the same class file loaded through
+ * different class loaders.
+ *
+ * @param obj the object to be compared with this element
+ * @return {@code true} if the specified object represents the same
+ * element as this
+ */
+ @Override
+ boolean equals(Object obj);
+
+ /**
+ * Obeys the general contract of {@link Object#hashCode Object.hashCode}.
+ *
+ * @see #equals
+ */
+ @Override
+ int hashCode();
+
+
+ /**
+ * {@inheritDoc}
+ *
+ * To get inherited annotations as well, use {@link
+ * Elements#getAllAnnotationMirrors(Element)
+ * getAllAnnotationMirrors}.
+ *
+ * @since 1.6
+ */
+ @Override
+ List extends AnnotationMirror> getAnnotationMirrors();
+
+ /**
+ * {@inheritDoc}
+ * @since 1.6
+ */
+ @Override
+ A getAnnotation(Class annotationType);
+
+ /**
+ * Applies a visitor to this element.
+ *
+ * @param the type of the additional parameter to the visitor's methods
+ * @param v the visitor operating on this element
+ * @param p additional parameter to the visitor
+ * @return a visitor-specified result
+ */
+
+ *
+ *
+ * @return the enclosing element, or {@code null} if there is none
+ * @see Elements#getPackageOf
+ */
+ Element getEnclosingElement();
+
+ /**
+ * Returns the elements that are, loosely speaking, directly
+ * enclosed by this element.
+ *
+ * A {@linkplain TypeElement#getEnclosedElements class or
+ * interface} is considered to enclose the fields, methods,
+ * constructors, and member types that it directly declares.
+ *
+ * A {@linkplain PackageElement#getEnclosedElements package}
+ * encloses the top-level classes and interfaces within it, but is
+ * not considered to enclose subpackages.
+ *
+ * Other kinds of elements are not currently considered to enclose
+ * any elements; however, that may change as this API or the
+ * programming language evolves.
+ *
+ *