/* * Copyright (c) 2010, 2011, Oracle and/or its affiliates. All rights reserved. * ORACLE PROPRIETARY/CONFIDENTIAL. Use is subject to license terms. * * * * * * * * * * * * * * * * * * * * */ package javax.lang.model.util; import javax.lang.model.element.*; import static javax.lang.model.element.ElementKind.*; import javax.annotation.processing.SupportedSourceVersion; import static javax.lang.model.SourceVersion.*; import javax.lang.model.SourceVersion; /** * A visitor of program elements based on their {@linkplain * ElementKind kind} with default behavior appropriate for the {@link * SourceVersion#RELEASE_7 RELEASE_7} source version. For {@linkplain * Element elements} XYZ that may have more than one * kind, the visitXYZ methods in this class delegate * to the visitXYZKind method corresponding to the * first argument's kind. The visitXYZKind methods * call {@link #defaultAction defaultAction}, passing their arguments * to {@code defaultAction}'s corresponding parameters. * *
Methods in this class may be overridden subject to their * general contract. Note that annotating methods in concrete * subclasses with {@link java.lang.Override @Override} will help * ensure that methods are overridden as intended. * *
WARNING: The {@code ElementVisitor} interface * implemented by this class may have methods added to it or the * {@code ElementKind} {@code enum} used in this case may have * constants added to it in the future to accommodate new, currently * unknown, language structures added to future versions of the * Java™ programming language. Therefore, methods whose names * begin with {@code "visit"} may be added to this class in the * future; to avoid incompatibilities, classes which extend this class * should not declare any instance methods with names beginning with * {@code "visit"}. * *
When such a new visit method is added, the default
* implementation in this class will be to call the {@link
* #visitUnknown visitUnknown} method. A new abstract element kind
* visitor class will also be introduced to correspond to the new
* language level; this visitor will have different default behavior
* for the visit method in question. When the new visitor is
* introduced, all or portions of this visitor may be deprecated.
*
* @param the type of the additional parameter to this visitor's
* methods. Use {@code Void} for visitors that do not need an
* additional parameter.
*
* @see ElementKindVisitor6
* @since 1.7
*/
@SupportedSourceVersion(RELEASE_7)
public class ElementKindVisitor7