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

Tue, 09 Oct 2012 19:10:00 -0700

author
jjg
date
Tue, 09 Oct 2012 19:10:00 -0700
changeset 1357
c75be5bc5283
parent 1054
111bbf1ad913
child 1522
09f65aad4759
permissions
-rw-r--r--

8000663: clean up langtools imports
Reviewed-by: darcy

     1 /*
     2  * Copyright (c) 2010, 2012, Oracle and/or its affiliates. All rights reserved.
     3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
     4  *
     5  * This code is free software; you can redistribute it and/or modify it
     6  * under the terms of the GNU General Public License version 2 only, as
     7  * published by the Free Software Foundation.  Oracle designates this
     8  * particular file as subject to the "Classpath" exception as provided
     9  * by Oracle in the LICENSE file that accompanied this code.
    10  *
    11  * This code is distributed in the hope that it will be useful, but WITHOUT
    12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
    13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
    14  * version 2 for more details (a copy is included in the LICENSE file that
    15  * accompanied this code).
    16  *
    17  * You should have received a copy of the GNU General Public License version
    18  * 2 along with this work; if not, write to the Free Software Foundation,
    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  */
    26 package javax.lang.model.util;
    28 import javax.annotation.processing.SupportedSourceVersion;
    29 import javax.lang.model.SourceVersion;
    30 import static javax.lang.model.SourceVersion.*;
    32 /**
    33  * A simple visitor for annotation values with default behavior
    34  * appropriate for the {@link SourceVersion#RELEASE_7 RELEASE_7}
    35  * source version.  Visit methods call {@link #defaultAction
    36  * defaultAction} passing their arguments to {@code defaultAction}'s
    37  * corresponding parameters.
    38  *
    39  * <p> Methods in this class may be overridden subject to their
    40  * general contract.  Note that annotating methods in concrete
    41  * subclasses with {@link java.lang.Override @Override} will help
    42  * ensure that methods are overridden as intended.
    43  *
    44  * <p> <b>WARNING:</b> The {@code AnnotationValueVisitor} interface
    45  * implemented by this class may have methods added to it in the
    46  * future to accommodate new, currently unknown, language structures
    47  * added to future versions of the Java&trade; programming language.
    48  * Therefore, methods whose names begin with {@code "visit"} may be
    49  * added to this class in the future; to avoid incompatibilities,
    50  * classes which extend this class should not declare any instance
    51  * methods with names beginning with {@code "visit"}.
    52  *
    53  * <p>When such a new visit method is added, the default
    54  * implementation in this class will be to call the {@link
    55  * #visitUnknown visitUnknown} method.  A new simple annotation
    56  * value visitor class will also be introduced to correspond to the
    57  * new language level; this visitor will have different default
    58  * behavior for the visit method in question.  When the new visitor is
    59  * introduced, all or portions of this visitor may be deprecated.
    60  *
    61  * @param <R> the return type of this visitor's methods
    62  * @param <P> the type of the additional parameter to this visitor's methods.
    63  *
    64  * @see SimpleAnnotationValueVisitor6
    65  * @see SimpleAnnotationValueVisitor8
    66  * @since 1.7
    67  */
    68 @SupportedSourceVersion(RELEASE_7)
    69 public class SimpleAnnotationValueVisitor7<R, P> extends SimpleAnnotationValueVisitor6<R, P> {
    70     /**
    71      * Constructor for concrete subclasses; uses {@code null} for the
    72      * default value.
    73      */
    74     protected SimpleAnnotationValueVisitor7() {
    75         super(null);
    76     }
    78     /**
    79      * Constructor for concrete subclasses; uses the argument for the
    80      * default value.
    81      *
    82      * @param defaultValue the value to assign to {@link #DEFAULT_VALUE}
    83      */
    84     protected SimpleAnnotationValueVisitor7(R defaultValue) {
    85         super(defaultValue);
    86     }
    87 }

mercurial