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

Wed, 27 Apr 2016 01:34:52 +0800

author
aoqi
date
Wed, 27 Apr 2016 01:34:52 +0800
changeset 0
959103a6100f
child 2525
2eb010b6cb22
permissions
-rw-r--r--

Initial load
http://hg.openjdk.java.net/jdk8u/jdk8u/langtools/
changeset: 2573:53ca196be1ae
tag: jdk8u25-b17

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

mercurial