src/share/classes/javax/lang/model/util/SimpleElementVisitor7.java

Print this page




  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 package javax.lang.model.util;
  27 
  28 import javax.lang.model.element.*;
  29 import javax.annotation.processing.SupportedSourceVersion;
  30 import static javax.lang.model.element.ElementKind.*;
  31 import javax.lang.model.SourceVersion;
  32 import static javax.lang.model.SourceVersion.*;
  33 
  34 /**
  35  * A simple visitor of program elements with default behavior
  36  * appropriate for the {@link SourceVersion#RELEASE_7 RELEASE_7}
  37  * source version.
  38  *
  39  * Visit methods corresponding to {@code RELEASE_7} language
  40  * constructs call {@link #defaultAction}, passing their arguments to
  41  * {@code defaultAction}'s corresponding parameters.

  42  *
  43  * <p> Methods in this class may be overridden subject to their
  44  * general contract.  Note that annotating methods in concrete
  45  * subclasses with {@link java.lang.Override @Override} will help
  46  * ensure that methods are overridden as intended.
  47  *
  48  * <p> <b>WARNING:</b> The {@code ElementVisitor} interface
  49  * implemented by this class may have methods added to it in the
  50  * future to accommodate new, currently unknown, language structures
  51  * added to future versions of the Java&trade; programming language.
  52  * Therefore, methods whose names begin with {@code "visit"} may be
  53  * added to this class in the future; to avoid incompatibilities,
  54  * classes which extend this class should not declare any instance
  55  * methods with names beginning with {@code "visit"}.
  56  *
  57  * <p>When such a new visit method is added, the default
  58  * implementation in this class will be to call the {@link
  59  * #visitUnknown visitUnknown} method.  A new simple element visitor
  60  * class will also be introduced to correspond to the new language
  61  * level; this visitor will have different default behavior for the


  72  */
  73 @SupportedSourceVersion(RELEASE_7)
  74 public class SimpleElementVisitor7<R, P> extends SimpleElementVisitor6<R, P> {
  75     /**
  76      * Constructor for concrete subclasses; uses {@code null} for the
  77      * default value.
  78      */
  79     protected SimpleElementVisitor7(){
  80         super(null);
  81     }
  82 
  83     /**
  84      * Constructor for concrete subclasses; uses the argument for the
  85      * default value.
  86      *
  87      * @param defaultValue the value to assign to {@link #DEFAULT_VALUE}
  88      */
  89     protected SimpleElementVisitor7(R defaultValue){
  90         super(defaultValue);
  91     }












  92 }


  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 package javax.lang.model.util;
  27 
  28 import javax.lang.model.element.*;
  29 import javax.annotation.processing.SupportedSourceVersion;
  30 import static javax.lang.model.element.ElementKind.*;
  31 import javax.lang.model.SourceVersion;
  32 import static javax.lang.model.SourceVersion.*;
  33 
  34 /**
  35  * A simple visitor of program elements with default behavior
  36  * appropriate for the {@link SourceVersion#RELEASE_7 RELEASE_7}
  37  * source version.
  38  *
  39  * Visit methods corresponding to {@code RELEASE_7} and earlier
  40  * language constructs call {@link #defaultAction defaultAction},
  41  * passing their arguments to {@code defaultAction}'s corresponding
  42  * parameters.
  43  *
  44  * <p> Methods in this class may be overridden subject to their
  45  * general contract.  Note that annotating methods in concrete
  46  * subclasses with {@link java.lang.Override @Override} will help
  47  * ensure that methods are overridden as intended.
  48  *
  49  * <p> <b>WARNING:</b> The {@code ElementVisitor} interface
  50  * implemented by this class may have methods added to it in the
  51  * future to accommodate new, currently unknown, language structures
  52  * added to future versions of the Java&trade; programming language.
  53  * Therefore, methods whose names begin with {@code "visit"} may be
  54  * added to this class in the future; to avoid incompatibilities,
  55  * classes which extend this class should not declare any instance
  56  * methods with names beginning with {@code "visit"}.
  57  *
  58  * <p>When such a new visit method is added, the default
  59  * implementation in this class will be to call the {@link
  60  * #visitUnknown visitUnknown} method.  A new simple element visitor
  61  * class will also be introduced to correspond to the new language
  62  * level; this visitor will have different default behavior for the


  73  */
  74 @SupportedSourceVersion(RELEASE_7)
  75 public class SimpleElementVisitor7<R, P> extends SimpleElementVisitor6<R, P> {
  76     /**
  77      * Constructor for concrete subclasses; uses {@code null} for the
  78      * default value.
  79      */
  80     protected SimpleElementVisitor7(){
  81         super(null);
  82     }
  83 
  84     /**
  85      * Constructor for concrete subclasses; uses the argument for the
  86      * default value.
  87      *
  88      * @param defaultValue the value to assign to {@link #DEFAULT_VALUE}
  89      */
  90     protected SimpleElementVisitor7(R defaultValue){
  91         super(defaultValue);
  92     }
  93 
  94     /**
  95      * This implementation calls {@code defaultAction}.
  96      *
  97      * @param e {@inheritDoc}
  98      * @param p {@inheritDoc}
  99      * @return  the result of {@code defaultAction}
 100      */
 101     @Override
 102     public R visitVariable(VariableElement e, P p) {
 103         return defaultAction(e, p);
 104     }
 105 }