langtools/src/jdk.compiler/share/classes/com/sun/tools/javac/code/Attribute.java
author jlahoda
Wed, 27 Aug 2014 07:44:00 +0200
changeset 26266 2d24bda701dc
parent 25874 83c19f00452c
child 26532 aa84b6606229
permissions -rw-r--r--
8056061: Mark implementations of public interfaces with an annotation Summary: Adding @DefinedBy annotation to mark methods that implement public API methods; annotating the methods; adding a coding rules analyzer to enforce all such methods are annotated. Reviewed-by: jjg, mcimadamore, jfranck Contributed-by: jan.lahoda@oracle.com, jonathan.gibbons@oracle.com
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
10
06bc494ca11e Initial load
duke
parents:
diff changeset
     1
/*
15385
ee1eebe7e210 8006775: JSR 308: Compiler changes in JDK8
jjg
parents: 14961
diff changeset
     2
 * Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved.
10
06bc494ca11e Initial load
duke
parents:
diff changeset
     3
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
06bc494ca11e Initial load
duke
parents:
diff changeset
     4
 *
06bc494ca11e Initial load
duke
parents:
diff changeset
     5
 * This code is free software; you can redistribute it and/or modify it
06bc494ca11e Initial load
duke
parents:
diff changeset
     6
 * under the terms of the GNU General Public License version 2 only, as
5520
86e4b9a9da40 6943119: Rebrand source copyright notices
ohair
parents: 3149
diff changeset
     7
 * published by the Free Software Foundation.  Oracle designates this
10
06bc494ca11e Initial load
duke
parents:
diff changeset
     8
 * particular file as subject to the "Classpath" exception as provided
5520
86e4b9a9da40 6943119: Rebrand source copyright notices
ohair
parents: 3149
diff changeset
     9
 * by Oracle in the LICENSE file that accompanied this code.
10
06bc494ca11e Initial load
duke
parents:
diff changeset
    10
 *
06bc494ca11e Initial load
duke
parents:
diff changeset
    11
 * This code is distributed in the hope that it will be useful, but WITHOUT
06bc494ca11e Initial load
duke
parents:
diff changeset
    12
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
06bc494ca11e Initial load
duke
parents:
diff changeset
    13
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
06bc494ca11e Initial load
duke
parents:
diff changeset
    14
 * version 2 for more details (a copy is included in the LICENSE file that
06bc494ca11e Initial load
duke
parents:
diff changeset
    15
 * accompanied this code).
06bc494ca11e Initial load
duke
parents:
diff changeset
    16
 *
06bc494ca11e Initial load
duke
parents:
diff changeset
    17
 * You should have received a copy of the GNU General Public License version
06bc494ca11e Initial load
duke
parents:
diff changeset
    18
 * 2 along with this work; if not, write to the Free Software Foundation,
06bc494ca11e Initial load
duke
parents:
diff changeset
    19
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
06bc494ca11e Initial load
duke
parents:
diff changeset
    20
 *
5520
86e4b9a9da40 6943119: Rebrand source copyright notices
ohair
parents: 3149
diff changeset
    21
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
86e4b9a9da40 6943119: Rebrand source copyright notices
ohair
parents: 3149
diff changeset
    22
 * or visit www.oracle.com if you need additional information or have any
86e4b9a9da40 6943119: Rebrand source copyright notices
ohair
parents: 3149
diff changeset
    23
 * questions.
10
06bc494ca11e Initial load
duke
parents:
diff changeset
    24
 */
06bc494ca11e Initial load
duke
parents:
diff changeset
    25
06bc494ca11e Initial load
duke
parents:
diff changeset
    26
package com.sun.tools.javac.code;
06bc494ca11e Initial load
duke
parents:
diff changeset
    27
06bc494ca11e Initial load
duke
parents:
diff changeset
    28
import java.util.LinkedHashMap;
06bc494ca11e Initial load
duke
parents:
diff changeset
    29
import java.util.Map;
06bc494ca11e Initial load
duke
parents:
diff changeset
    30
import javax.lang.model.element.AnnotationMirror;
06bc494ca11e Initial load
duke
parents:
diff changeset
    31
import javax.lang.model.element.AnnotationValue;
06bc494ca11e Initial load
duke
parents:
diff changeset
    32
import javax.lang.model.element.AnnotationValueVisitor;
06bc494ca11e Initial load
duke
parents:
diff changeset
    33
import javax.lang.model.type.DeclaredType;
06bc494ca11e Initial load
duke
parents:
diff changeset
    34
import com.sun.tools.javac.code.Symbol.*;
06bc494ca11e Initial load
duke
parents:
diff changeset
    35
import com.sun.tools.javac.util.*;
26266
2d24bda701dc 8056061: Mark implementations of public interfaces with an annotation
jlahoda
parents: 25874
diff changeset
    36
import com.sun.tools.javac.util.DefinedBy.Api;
10
06bc494ca11e Initial load
duke
parents:
diff changeset
    37
06bc494ca11e Initial load
duke
parents:
diff changeset
    38
/** An annotation value.
06bc494ca11e Initial load
duke
parents:
diff changeset
    39
 *
5847
1908176fd6e3 6944312: Potential rebranding issues in openjdk/langtools repository sources
jjg
parents: 5520
diff changeset
    40
 *  <p><b>This is NOT part of any supported API.
1908176fd6e3 6944312: Potential rebranding issues in openjdk/langtools repository sources
jjg
parents: 5520
diff changeset
    41
 *  If you write code that depends on this, you do so at your own risk.
10
06bc494ca11e Initial load
duke
parents:
diff changeset
    42
 *  This code and its internal interfaces are subject to change or
06bc494ca11e Initial load
duke
parents:
diff changeset
    43
 *  deletion without notice.</b>
06bc494ca11e Initial load
duke
parents:
diff changeset
    44
 */
06bc494ca11e Initial load
duke
parents:
diff changeset
    45
public abstract class Attribute implements AnnotationValue {
06bc494ca11e Initial load
duke
parents:
diff changeset
    46
06bc494ca11e Initial load
duke
parents:
diff changeset
    47
    /** The type of the annotation element. */
06bc494ca11e Initial load
duke
parents:
diff changeset
    48
    public Type type;
06bc494ca11e Initial load
duke
parents:
diff changeset
    49
06bc494ca11e Initial load
duke
parents:
diff changeset
    50
    public Attribute(Type type) {
06bc494ca11e Initial load
duke
parents:
diff changeset
    51
        this.type = type;
06bc494ca11e Initial load
duke
parents:
diff changeset
    52
    }
06bc494ca11e Initial load
duke
parents:
diff changeset
    53
06bc494ca11e Initial load
duke
parents:
diff changeset
    54
    public abstract void accept(Visitor v);
06bc494ca11e Initial load
duke
parents:
diff changeset
    55
26266
2d24bda701dc 8056061: Mark implementations of public interfaces with an annotation
jlahoda
parents: 25874
diff changeset
    56
    @DefinedBy(Api.LANGUAGE_MODEL)
10
06bc494ca11e Initial load
duke
parents:
diff changeset
    57
    public Object getValue() {
06bc494ca11e Initial load
duke
parents:
diff changeset
    58
        throw new UnsupportedOperationException();
06bc494ca11e Initial load
duke
parents:
diff changeset
    59
    }
06bc494ca11e Initial load
duke
parents:
diff changeset
    60
26266
2d24bda701dc 8056061: Mark implementations of public interfaces with an annotation
jlahoda
parents: 25874
diff changeset
    61
    @DefinedBy(Api.LANGUAGE_MODEL)
10
06bc494ca11e Initial load
duke
parents:
diff changeset
    62
    public <R, P> R accept(AnnotationValueVisitor<R, P> v, P p) {
06bc494ca11e Initial load
duke
parents:
diff changeset
    63
        throw new UnsupportedOperationException();
06bc494ca11e Initial load
duke
parents:
diff changeset
    64
    }
06bc494ca11e Initial load
duke
parents:
diff changeset
    65
14961
e731935052af 8005098: Provide isSynthesized() information on Attribute.Compound
jfranck
parents: 14359
diff changeset
    66
    public boolean isSynthesized() {
e731935052af 8005098: Provide isSynthesized() information on Attribute.Compound
jfranck
parents: 14359
diff changeset
    67
        return false;
e731935052af 8005098: Provide isSynthesized() information on Attribute.Compound
jfranck
parents: 14359
diff changeset
    68
    }
10
06bc494ca11e Initial load
duke
parents:
diff changeset
    69
22163
3651128c74eb 8030244: Update langtools to use Diamond
briangoetz
parents: 21041
diff changeset
    70
    public TypeAnnotationPosition getPosition() { return null; }
21010
5ffe0d8a5e24 8008762: Type annotation on inner class in anonymous class show up as regular type annotations
emc
parents: 19507
diff changeset
    71
10
06bc494ca11e Initial load
duke
parents:
diff changeset
    72
    /** The value for an annotation element of primitive type or String. */
06bc494ca11e Initial load
duke
parents:
diff changeset
    73
    public static class Constant extends Attribute {
06bc494ca11e Initial load
duke
parents:
diff changeset
    74
        public final Object value;
06bc494ca11e Initial load
duke
parents:
diff changeset
    75
        public void accept(Visitor v) { v.visitConstant(this); }
06bc494ca11e Initial load
duke
parents:
diff changeset
    76
        public Constant(Type type, Object value) {
06bc494ca11e Initial load
duke
parents:
diff changeset
    77
            super(type);
06bc494ca11e Initial load
duke
parents:
diff changeset
    78
            this.value = value;
06bc494ca11e Initial load
duke
parents:
diff changeset
    79
        }
26266
2d24bda701dc 8056061: Mark implementations of public interfaces with an annotation
jlahoda
parents: 25874
diff changeset
    80
        @DefinedBy(Api.LANGUAGE_MODEL)
10
06bc494ca11e Initial load
duke
parents:
diff changeset
    81
        public String toString() {
06bc494ca11e Initial load
duke
parents:
diff changeset
    82
            return Constants.format(value, type);
06bc494ca11e Initial load
duke
parents:
diff changeset
    83
        }
26266
2d24bda701dc 8056061: Mark implementations of public interfaces with an annotation
jlahoda
parents: 25874
diff changeset
    84
        @DefinedBy(Api.LANGUAGE_MODEL)
10
06bc494ca11e Initial load
duke
parents:
diff changeset
    85
        public Object getValue() {
06bc494ca11e Initial load
duke
parents:
diff changeset
    86
            return Constants.decode(value, type);
06bc494ca11e Initial load
duke
parents:
diff changeset
    87
        }
26266
2d24bda701dc 8056061: Mark implementations of public interfaces with an annotation
jlahoda
parents: 25874
diff changeset
    88
        @DefinedBy(Api.LANGUAGE_MODEL)
10
06bc494ca11e Initial load
duke
parents:
diff changeset
    89
        public <R, P> R accept(AnnotationValueVisitor<R, P> v, P p) {
06bc494ca11e Initial load
duke
parents:
diff changeset
    90
            if (value instanceof String)
06bc494ca11e Initial load
duke
parents:
diff changeset
    91
                return v.visitString((String) value, p);
06bc494ca11e Initial load
duke
parents:
diff changeset
    92
            if (value instanceof Integer) {
06bc494ca11e Initial load
duke
parents:
diff changeset
    93
                int i = (Integer) value;
18646
e628560a86d1 8017104: javac should have a class for primitive types that inherits from Type
vromero
parents: 17578
diff changeset
    94
                switch (type.getTag()) {
10
06bc494ca11e Initial load
duke
parents:
diff changeset
    95
                case BOOLEAN:   return v.visitBoolean(i != 0, p);
06bc494ca11e Initial load
duke
parents:
diff changeset
    96
                case CHAR:      return v.visitChar((char) i, p);
06bc494ca11e Initial load
duke
parents:
diff changeset
    97
                case BYTE:      return v.visitByte((byte) i, p);
06bc494ca11e Initial load
duke
parents:
diff changeset
    98
                case SHORT:     return v.visitShort((short) i, p);
06bc494ca11e Initial load
duke
parents:
diff changeset
    99
                case INT:       return v.visitInt(i, p);
06bc494ca11e Initial load
duke
parents:
diff changeset
   100
                }
06bc494ca11e Initial load
duke
parents:
diff changeset
   101
            }
18646
e628560a86d1 8017104: javac should have a class for primitive types that inherits from Type
vromero
parents: 17578
diff changeset
   102
            switch (type.getTag()) {
10
06bc494ca11e Initial load
duke
parents:
diff changeset
   103
            case LONG:          return v.visitLong((Long) value, p);
06bc494ca11e Initial load
duke
parents:
diff changeset
   104
            case FLOAT:         return v.visitFloat((Float) value, p);
06bc494ca11e Initial load
duke
parents:
diff changeset
   105
            case DOUBLE:        return v.visitDouble((Double) value, p);
06bc494ca11e Initial load
duke
parents:
diff changeset
   106
            }
06bc494ca11e Initial load
duke
parents:
diff changeset
   107
            throw new AssertionError("Bad annotation element value: " + value);
06bc494ca11e Initial load
duke
parents:
diff changeset
   108
        }
06bc494ca11e Initial load
duke
parents:
diff changeset
   109
    }
06bc494ca11e Initial load
duke
parents:
diff changeset
   110
06bc494ca11e Initial load
duke
parents:
diff changeset
   111
    /** The value for an annotation element of type java.lang.Class,
06bc494ca11e Initial load
duke
parents:
diff changeset
   112
     *  represented as a ClassSymbol.
06bc494ca11e Initial load
duke
parents:
diff changeset
   113
     */
06bc494ca11e Initial load
duke
parents:
diff changeset
   114
    public static class Class extends Attribute {
13689
4d519199a6aa 7151010: Add compiler support for repeating annotations
jfranck
parents: 8032
diff changeset
   115
        public final Type classType;
10
06bc494ca11e Initial load
duke
parents:
diff changeset
   116
        public void accept(Visitor v) { v.visitClass(this); }
06bc494ca11e Initial load
duke
parents:
diff changeset
   117
        public Class(Types types, Type type) {
06bc494ca11e Initial load
duke
parents:
diff changeset
   118
            super(makeClassType(types, type));
13689
4d519199a6aa 7151010: Add compiler support for repeating annotations
jfranck
parents: 8032
diff changeset
   119
            this.classType = type;
10
06bc494ca11e Initial load
duke
parents:
diff changeset
   120
        }
06bc494ca11e Initial load
duke
parents:
diff changeset
   121
        static Type makeClassType(Types types, Type type) {
06bc494ca11e Initial load
duke
parents:
diff changeset
   122
            Type arg = type.isPrimitive()
06bc494ca11e Initial load
duke
parents:
diff changeset
   123
                ? types.boxedClass(type).type
06bc494ca11e Initial load
duke
parents:
diff changeset
   124
                : types.erasure(type);
06bc494ca11e Initial load
duke
parents:
diff changeset
   125
            return new Type.ClassType(types.syms.classType.getEnclosingType(),
06bc494ca11e Initial load
duke
parents:
diff changeset
   126
                                      List.of(arg),
24396
3c36c6afcbca 8040327: Eliminate AnnotatedType
emc
parents: 23798
diff changeset
   127
                                      types.syms.classType.tsym,
3c36c6afcbca 8040327: Eliminate AnnotatedType
emc
parents: 23798
diff changeset
   128
                                      Type.noAnnotations);
10
06bc494ca11e Initial load
duke
parents:
diff changeset
   129
        }
26266
2d24bda701dc 8056061: Mark implementations of public interfaces with an annotation
jlahoda
parents: 25874
diff changeset
   130
        @DefinedBy(Api.LANGUAGE_MODEL)
10
06bc494ca11e Initial load
duke
parents:
diff changeset
   131
        public String toString() {
13689
4d519199a6aa 7151010: Add compiler support for repeating annotations
jfranck
parents: 8032
diff changeset
   132
            return classType + ".class";
10
06bc494ca11e Initial load
duke
parents:
diff changeset
   133
        }
26266
2d24bda701dc 8056061: Mark implementations of public interfaces with an annotation
jlahoda
parents: 25874
diff changeset
   134
        @DefinedBy(Api.LANGUAGE_MODEL)
10
06bc494ca11e Initial load
duke
parents:
diff changeset
   135
        public Type getValue() {
13689
4d519199a6aa 7151010: Add compiler support for repeating annotations
jfranck
parents: 8032
diff changeset
   136
            return classType;
10
06bc494ca11e Initial load
duke
parents:
diff changeset
   137
        }
26266
2d24bda701dc 8056061: Mark implementations of public interfaces with an annotation
jlahoda
parents: 25874
diff changeset
   138
        @DefinedBy(Api.LANGUAGE_MODEL)
10
06bc494ca11e Initial load
duke
parents:
diff changeset
   139
        public <R, P> R accept(AnnotationValueVisitor<R, P> v, P p) {
13689
4d519199a6aa 7151010: Add compiler support for repeating annotations
jfranck
parents: 8032
diff changeset
   140
            return v.visitType(classType, p);
10
06bc494ca11e Initial load
duke
parents:
diff changeset
   141
        }
06bc494ca11e Initial load
duke
parents:
diff changeset
   142
    }
06bc494ca11e Initial load
duke
parents:
diff changeset
   143
06bc494ca11e Initial load
duke
parents:
diff changeset
   144
    /** A compound annotation element value, the type of which is an
06bc494ca11e Initial load
duke
parents:
diff changeset
   145
     *  attribute interface.
06bc494ca11e Initial load
duke
parents:
diff changeset
   146
     */
06bc494ca11e Initial load
duke
parents:
diff changeset
   147
    public static class Compound extends Attribute implements AnnotationMirror {
06bc494ca11e Initial load
duke
parents:
diff changeset
   148
        /** The attributes values, as pairs.  Each pair contains a
06bc494ca11e Initial load
duke
parents:
diff changeset
   149
         *  reference to the accessing method in the attribute interface
06bc494ca11e Initial load
duke
parents:
diff changeset
   150
         *  and the value to be returned when that method is called to
06bc494ca11e Initial load
duke
parents:
diff changeset
   151
         *  access this attribute.
06bc494ca11e Initial load
duke
parents:
diff changeset
   152
         */
06bc494ca11e Initial load
duke
parents:
diff changeset
   153
        public final List<Pair<MethodSymbol,Attribute>> values;
24895
dd091d389fbf 8027262: Determine location for type annotations earlier in compiler pipeline
emc
parents: 24396
diff changeset
   154
        public final TypeAnnotationPosition position;
14961
e731935052af 8005098: Provide isSynthesized() information on Attribute.Compound
jfranck
parents: 14359
diff changeset
   155
e731935052af 8005098: Provide isSynthesized() information on Attribute.Compound
jfranck
parents: 14359
diff changeset
   156
        private boolean synthesized = false;
e731935052af 8005098: Provide isSynthesized() information on Attribute.Compound
jfranck
parents: 14359
diff changeset
   157
e731935052af 8005098: Provide isSynthesized() information on Attribute.Compound
jfranck
parents: 14359
diff changeset
   158
        @Override
e731935052af 8005098: Provide isSynthesized() information on Attribute.Compound
jfranck
parents: 14359
diff changeset
   159
        public boolean isSynthesized() {
e731935052af 8005098: Provide isSynthesized() information on Attribute.Compound
jfranck
parents: 14359
diff changeset
   160
            return synthesized;
e731935052af 8005098: Provide isSynthesized() information on Attribute.Compound
jfranck
parents: 14359
diff changeset
   161
        }
e731935052af 8005098: Provide isSynthesized() information on Attribute.Compound
jfranck
parents: 14359
diff changeset
   162
e731935052af 8005098: Provide isSynthesized() information on Attribute.Compound
jfranck
parents: 14359
diff changeset
   163
        public void setSynthesized(boolean synthesized) {
e731935052af 8005098: Provide isSynthesized() information on Attribute.Compound
jfranck
parents: 14359
diff changeset
   164
            this.synthesized = synthesized;
e731935052af 8005098: Provide isSynthesized() information on Attribute.Compound
jfranck
parents: 14359
diff changeset
   165
        }
e731935052af 8005098: Provide isSynthesized() information on Attribute.Compound
jfranck
parents: 14359
diff changeset
   166
10
06bc494ca11e Initial load
duke
parents:
diff changeset
   167
        public Compound(Type type,
23798
ca0f80391182 8035768: Move TypeAnnotationPosition from Attribute.Compound to Attribute.TypeCompound
emc
parents: 22163
diff changeset
   168
                        List<Pair<MethodSymbol,Attribute>> values,
ca0f80391182 8035768: Move TypeAnnotationPosition from Attribute.Compound to Attribute.TypeCompound
emc
parents: 22163
diff changeset
   169
                        TypeAnnotationPosition position) {
10
06bc494ca11e Initial load
duke
parents:
diff changeset
   170
            super(type);
06bc494ca11e Initial load
duke
parents:
diff changeset
   171
            this.values = values;
23798
ca0f80391182 8035768: Move TypeAnnotationPosition from Attribute.Compound to Attribute.TypeCompound
emc
parents: 22163
diff changeset
   172
            this.position = position;
10
06bc494ca11e Initial load
duke
parents:
diff changeset
   173
        }
23798
ca0f80391182 8035768: Move TypeAnnotationPosition from Attribute.Compound to Attribute.TypeCompound
emc
parents: 22163
diff changeset
   174
ca0f80391182 8035768: Move TypeAnnotationPosition from Attribute.Compound to Attribute.TypeCompound
emc
parents: 22163
diff changeset
   175
        public Compound(Type type,
ca0f80391182 8035768: Move TypeAnnotationPosition from Attribute.Compound to Attribute.TypeCompound
emc
parents: 22163
diff changeset
   176
                        List<Pair<MethodSymbol,Attribute>> values) {
ca0f80391182 8035768: Move TypeAnnotationPosition from Attribute.Compound to Attribute.TypeCompound
emc
parents: 22163
diff changeset
   177
            this(type, values, null);
ca0f80391182 8035768: Move TypeAnnotationPosition from Attribute.Compound to Attribute.TypeCompound
emc
parents: 22163
diff changeset
   178
        }
ca0f80391182 8035768: Move TypeAnnotationPosition from Attribute.Compound to Attribute.TypeCompound
emc
parents: 22163
diff changeset
   179
ca0f80391182 8035768: Move TypeAnnotationPosition from Attribute.Compound to Attribute.TypeCompound
emc
parents: 22163
diff changeset
   180
        @Override
ca0f80391182 8035768: Move TypeAnnotationPosition from Attribute.Compound to Attribute.TypeCompound
emc
parents: 22163
diff changeset
   181
        public TypeAnnotationPosition getPosition() {
ca0f80391182 8035768: Move TypeAnnotationPosition from Attribute.Compound to Attribute.TypeCompound
emc
parents: 22163
diff changeset
   182
            return position;
ca0f80391182 8035768: Move TypeAnnotationPosition from Attribute.Compound to Attribute.TypeCompound
emc
parents: 22163
diff changeset
   183
        }
ca0f80391182 8035768: Move TypeAnnotationPosition from Attribute.Compound to Attribute.TypeCompound
emc
parents: 22163
diff changeset
   184
10
06bc494ca11e Initial load
duke
parents:
diff changeset
   185
        public void accept(Visitor v) { v.visitCompound(this); }
06bc494ca11e Initial load
duke
parents:
diff changeset
   186
06bc494ca11e Initial load
duke
parents:
diff changeset
   187
        /**
06bc494ca11e Initial load
duke
parents:
diff changeset
   188
         * Returns a string representation of this annotation.
06bc494ca11e Initial load
duke
parents:
diff changeset
   189
         * String is of one of the forms:
06bc494ca11e Initial load
duke
parents:
diff changeset
   190
         *     @com.example.foo(name1=val1, name2=val2)
06bc494ca11e Initial load
duke
parents:
diff changeset
   191
         *     @com.example.foo(val)
06bc494ca11e Initial load
duke
parents:
diff changeset
   192
         *     @com.example.foo
06bc494ca11e Initial load
duke
parents:
diff changeset
   193
         * Omit parens for marker annotations, and omit "value=" when allowed.
06bc494ca11e Initial load
duke
parents:
diff changeset
   194
         */
26266
2d24bda701dc 8056061: Mark implementations of public interfaces with an annotation
jlahoda
parents: 25874
diff changeset
   195
        @DefinedBy(Api.LANGUAGE_MODEL)
10
06bc494ca11e Initial load
duke
parents:
diff changeset
   196
        public String toString() {
06bc494ca11e Initial load
duke
parents:
diff changeset
   197
            StringBuilder buf = new StringBuilder();
06bc494ca11e Initial load
duke
parents:
diff changeset
   198
            buf.append("@");
06bc494ca11e Initial load
duke
parents:
diff changeset
   199
            buf.append(type);
06bc494ca11e Initial load
duke
parents:
diff changeset
   200
            int len = values.length();
06bc494ca11e Initial load
duke
parents:
diff changeset
   201
            if (len > 0) {
06bc494ca11e Initial load
duke
parents:
diff changeset
   202
                buf.append('(');
06bc494ca11e Initial load
duke
parents:
diff changeset
   203
                boolean first = true;
06bc494ca11e Initial load
duke
parents:
diff changeset
   204
                for (Pair<MethodSymbol, Attribute> value : values) {
06bc494ca11e Initial load
duke
parents:
diff changeset
   205
                    if (!first) buf.append(", ");
06bc494ca11e Initial load
duke
parents:
diff changeset
   206
                    first = false;
06bc494ca11e Initial load
duke
parents:
diff changeset
   207
06bc494ca11e Initial load
duke
parents:
diff changeset
   208
                    Name name = value.fst.name;
1260
a772ba9ba43d 6574134: Allow for alternative implementation of Name Table with garbage collection of name bytes
jjg
parents: 1206
diff changeset
   209
                    if (len > 1 || name != name.table.names.value) {
10
06bc494ca11e Initial load
duke
parents:
diff changeset
   210
                        buf.append(name);
06bc494ca11e Initial load
duke
parents:
diff changeset
   211
                        buf.append('=');
06bc494ca11e Initial load
duke
parents:
diff changeset
   212
                    }
06bc494ca11e Initial load
duke
parents:
diff changeset
   213
                    buf.append(value.snd);
06bc494ca11e Initial load
duke
parents:
diff changeset
   214
                }
06bc494ca11e Initial load
duke
parents:
diff changeset
   215
                buf.append(')');
06bc494ca11e Initial load
duke
parents:
diff changeset
   216
            }
06bc494ca11e Initial load
duke
parents:
diff changeset
   217
            return buf.toString();
06bc494ca11e Initial load
duke
parents:
diff changeset
   218
        }
06bc494ca11e Initial load
duke
parents:
diff changeset
   219
06bc494ca11e Initial load
duke
parents:
diff changeset
   220
        public Attribute member(Name member) {
21010
5ffe0d8a5e24 8008762: Type annotation on inner class in anonymous class show up as regular type annotations
emc
parents: 19507
diff changeset
   221
            Pair<MethodSymbol,Attribute> res = getElemPair(member);
5ffe0d8a5e24 8008762: Type annotation on inner class in anonymous class show up as regular type annotations
emc
parents: 19507
diff changeset
   222
            return res == null ? null : res.snd;
5ffe0d8a5e24 8008762: Type annotation on inner class in anonymous class show up as regular type annotations
emc
parents: 19507
diff changeset
   223
        }
5ffe0d8a5e24 8008762: Type annotation on inner class in anonymous class show up as regular type annotations
emc
parents: 19507
diff changeset
   224
5ffe0d8a5e24 8008762: Type annotation on inner class in anonymous class show up as regular type annotations
emc
parents: 19507
diff changeset
   225
        private Pair<MethodSymbol, Attribute> getElemPair(Name member) {
10
06bc494ca11e Initial load
duke
parents:
diff changeset
   226
            for (Pair<MethodSymbol,Attribute> pair : values)
21010
5ffe0d8a5e24 8008762: Type annotation on inner class in anonymous class show up as regular type annotations
emc
parents: 19507
diff changeset
   227
                if (pair.fst.name == member) return pair;
10
06bc494ca11e Initial load
duke
parents:
diff changeset
   228
            return null;
06bc494ca11e Initial load
duke
parents:
diff changeset
   229
        }
06bc494ca11e Initial load
duke
parents:
diff changeset
   230
26266
2d24bda701dc 8056061: Mark implementations of public interfaces with an annotation
jlahoda
parents: 25874
diff changeset
   231
        @DefinedBy(Api.LANGUAGE_MODEL)
10
06bc494ca11e Initial load
duke
parents:
diff changeset
   232
        public Attribute.Compound getValue() {
06bc494ca11e Initial load
duke
parents:
diff changeset
   233
            return this;
06bc494ca11e Initial load
duke
parents:
diff changeset
   234
        }
06bc494ca11e Initial load
duke
parents:
diff changeset
   235
26266
2d24bda701dc 8056061: Mark implementations of public interfaces with an annotation
jlahoda
parents: 25874
diff changeset
   236
        @DefinedBy(Api.LANGUAGE_MODEL)
10
06bc494ca11e Initial load
duke
parents:
diff changeset
   237
        public <R, P> R accept(AnnotationValueVisitor<R, P> v, P p) {
06bc494ca11e Initial load
duke
parents:
diff changeset
   238
            return v.visitAnnotation(this, p);
06bc494ca11e Initial load
duke
parents:
diff changeset
   239
        }
06bc494ca11e Initial load
duke
parents:
diff changeset
   240
26266
2d24bda701dc 8056061: Mark implementations of public interfaces with an annotation
jlahoda
parents: 25874
diff changeset
   241
        @DefinedBy(Api.LANGUAGE_MODEL)
10
06bc494ca11e Initial load
duke
parents:
diff changeset
   242
        public DeclaredType getAnnotationType() {
06bc494ca11e Initial load
duke
parents:
diff changeset
   243
            return (DeclaredType) type;
06bc494ca11e Initial load
duke
parents:
diff changeset
   244
        }
06bc494ca11e Initial load
duke
parents:
diff changeset
   245
26266
2d24bda701dc 8056061: Mark implementations of public interfaces with an annotation
jlahoda
parents: 25874
diff changeset
   246
        @DefinedBy(Api.LANGUAGE_MODEL)
10
06bc494ca11e Initial load
duke
parents:
diff changeset
   247
        public Map<MethodSymbol, Attribute> getElementValues() {
22163
3651128c74eb 8030244: Update langtools to use Diamond
briangoetz
parents: 21041
diff changeset
   248
            Map<MethodSymbol, Attribute> valmap = new LinkedHashMap<>();
10
06bc494ca11e Initial load
duke
parents:
diff changeset
   249
            for (Pair<MethodSymbol, Attribute> value : values)
06bc494ca11e Initial load
duke
parents:
diff changeset
   250
                valmap.put(value.fst, value.snd);
06bc494ca11e Initial load
duke
parents:
diff changeset
   251
            return valmap;
06bc494ca11e Initial load
duke
parents:
diff changeset
   252
        }
24895
dd091d389fbf 8027262: Determine location for type annotations earlier in compiler pipeline
emc
parents: 24396
diff changeset
   253
dd091d389fbf 8027262: Determine location for type annotations earlier in compiler pipeline
emc
parents: 24396
diff changeset
   254
        public TypeCompound toTypeCompound() {
dd091d389fbf 8027262: Determine location for type annotations earlier in compiler pipeline
emc
parents: 24396
diff changeset
   255
            // It is safe to alias the position.
dd091d389fbf 8027262: Determine location for type annotations earlier in compiler pipeline
emc
parents: 24396
diff changeset
   256
            return new TypeCompound(this, this.position);
dd091d389fbf 8027262: Determine location for type annotations earlier in compiler pipeline
emc
parents: 24396
diff changeset
   257
        }
dd091d389fbf 8027262: Determine location for type annotations earlier in compiler pipeline
emc
parents: 24396
diff changeset
   258
10
06bc494ca11e Initial load
duke
parents:
diff changeset
   259
    }
06bc494ca11e Initial load
duke
parents:
diff changeset
   260
15385
ee1eebe7e210 8006775: JSR 308: Compiler changes in JDK8
jjg
parents: 14961
diff changeset
   261
    public static class TypeCompound extends Compound {
ee1eebe7e210 8006775: JSR 308: Compiler changes in JDK8
jjg
parents: 14961
diff changeset
   262
        public TypeCompound(Compound compound,
23798
ca0f80391182 8035768: Move TypeAnnotationPosition from Attribute.Compound to Attribute.TypeCompound
emc
parents: 22163
diff changeset
   263
                             TypeAnnotationPosition position) {
ca0f80391182 8035768: Move TypeAnnotationPosition from Attribute.Compound to Attribute.TypeCompound
emc
parents: 22163
diff changeset
   264
            super(compound.type, compound.values, position);
17578
46ac954e4a84 8013852: update reference impl for type-annotations
jjg
parents: 15385
diff changeset
   265
        }
46ac954e4a84 8013852: update reference impl for type-annotations
jjg
parents: 15385
diff changeset
   266
23798
ca0f80391182 8035768: Move TypeAnnotationPosition from Attribute.Compound to Attribute.TypeCompound
emc
parents: 22163
diff changeset
   267
        public TypeCompound(Type type,
ca0f80391182 8035768: Move TypeAnnotationPosition from Attribute.Compound to Attribute.TypeCompound
emc
parents: 22163
diff changeset
   268
                             List<Pair<MethodSymbol,Attribute>> values,
ca0f80391182 8035768: Move TypeAnnotationPosition from Attribute.Compound to Attribute.TypeCompound
emc
parents: 22163
diff changeset
   269
                             TypeAnnotationPosition position) {
ca0f80391182 8035768: Move TypeAnnotationPosition from Attribute.Compound to Attribute.TypeCompound
emc
parents: 22163
diff changeset
   270
            super(type, values, position);
17578
46ac954e4a84 8013852: update reference impl for type-annotations
jjg
parents: 15385
diff changeset
   271
        }
15385
ee1eebe7e210 8006775: JSR 308: Compiler changes in JDK8
jjg
parents: 14961
diff changeset
   272
    }
ee1eebe7e210 8006775: JSR 308: Compiler changes in JDK8
jjg
parents: 14961
diff changeset
   273
10
06bc494ca11e Initial load
duke
parents:
diff changeset
   274
    /** The value for an annotation element of an array type.
06bc494ca11e Initial load
duke
parents:
diff changeset
   275
     */
06bc494ca11e Initial load
duke
parents:
diff changeset
   276
    public static class Array extends Attribute {
06bc494ca11e Initial load
duke
parents:
diff changeset
   277
        public final Attribute[] values;
06bc494ca11e Initial load
duke
parents:
diff changeset
   278
        public Array(Type type, Attribute[] values) {
06bc494ca11e Initial load
duke
parents:
diff changeset
   279
            super(type);
06bc494ca11e Initial load
duke
parents:
diff changeset
   280
            this.values = values;
06bc494ca11e Initial load
duke
parents:
diff changeset
   281
        }
13689
4d519199a6aa 7151010: Add compiler support for repeating annotations
jfranck
parents: 8032
diff changeset
   282
4d519199a6aa 7151010: Add compiler support for repeating annotations
jfranck
parents: 8032
diff changeset
   283
        public Array(Type type, List<Attribute> values) {
4d519199a6aa 7151010: Add compiler support for repeating annotations
jfranck
parents: 8032
diff changeset
   284
            super(type);
4d519199a6aa 7151010: Add compiler support for repeating annotations
jfranck
parents: 8032
diff changeset
   285
            this.values = values.toArray(new Attribute[values.size()]);
4d519199a6aa 7151010: Add compiler support for repeating annotations
jfranck
parents: 8032
diff changeset
   286
        }
4d519199a6aa 7151010: Add compiler support for repeating annotations
jfranck
parents: 8032
diff changeset
   287
10
06bc494ca11e Initial load
duke
parents:
diff changeset
   288
        public void accept(Visitor v) { v.visitArray(this); }
26266
2d24bda701dc 8056061: Mark implementations of public interfaces with an annotation
jlahoda
parents: 25874
diff changeset
   289
        @DefinedBy(Api.LANGUAGE_MODEL)
10
06bc494ca11e Initial load
duke
parents:
diff changeset
   290
        public String toString() {
06bc494ca11e Initial load
duke
parents:
diff changeset
   291
            StringBuilder buf = new StringBuilder();
06bc494ca11e Initial load
duke
parents:
diff changeset
   292
            buf.append('{');
06bc494ca11e Initial load
duke
parents:
diff changeset
   293
            boolean first = true;
06bc494ca11e Initial load
duke
parents:
diff changeset
   294
            for (Attribute value : values) {
06bc494ca11e Initial load
duke
parents:
diff changeset
   295
                if (!first)
06bc494ca11e Initial load
duke
parents:
diff changeset
   296
                    buf.append(", ");
06bc494ca11e Initial load
duke
parents:
diff changeset
   297
                first = false;
06bc494ca11e Initial load
duke
parents:
diff changeset
   298
                buf.append(value);
06bc494ca11e Initial load
duke
parents:
diff changeset
   299
            }
06bc494ca11e Initial load
duke
parents:
diff changeset
   300
            buf.append('}');
06bc494ca11e Initial load
duke
parents:
diff changeset
   301
            return buf.toString();
06bc494ca11e Initial load
duke
parents:
diff changeset
   302
        }
26266
2d24bda701dc 8056061: Mark implementations of public interfaces with an annotation
jlahoda
parents: 25874
diff changeset
   303
        @DefinedBy(Api.LANGUAGE_MODEL)
10
06bc494ca11e Initial load
duke
parents:
diff changeset
   304
        public List<Attribute> getValue() {
06bc494ca11e Initial load
duke
parents:
diff changeset
   305
            return List.from(values);
06bc494ca11e Initial load
duke
parents:
diff changeset
   306
        }
26266
2d24bda701dc 8056061: Mark implementations of public interfaces with an annotation
jlahoda
parents: 25874
diff changeset
   307
        @DefinedBy(Api.LANGUAGE_MODEL)
10
06bc494ca11e Initial load
duke
parents:
diff changeset
   308
        public <R, P> R accept(AnnotationValueVisitor<R, P> v, P p) {
06bc494ca11e Initial load
duke
parents:
diff changeset
   309
            return v.visitArray(getValue(), p);
06bc494ca11e Initial load
duke
parents:
diff changeset
   310
        }
21010
5ffe0d8a5e24 8008762: Type annotation on inner class in anonymous class show up as regular type annotations
emc
parents: 19507
diff changeset
   311
5ffe0d8a5e24 8008762: Type annotation on inner class in anonymous class show up as regular type annotations
emc
parents: 19507
diff changeset
   312
        @Override
5ffe0d8a5e24 8008762: Type annotation on inner class in anonymous class show up as regular type annotations
emc
parents: 19507
diff changeset
   313
        public TypeAnnotationPosition getPosition() {
5ffe0d8a5e24 8008762: Type annotation on inner class in anonymous class show up as regular type annotations
emc
parents: 19507
diff changeset
   314
            if (values.length != 0)
5ffe0d8a5e24 8008762: Type annotation on inner class in anonymous class show up as regular type annotations
emc
parents: 19507
diff changeset
   315
                return values[0].getPosition();
5ffe0d8a5e24 8008762: Type annotation on inner class in anonymous class show up as regular type annotations
emc
parents: 19507
diff changeset
   316
            else
5ffe0d8a5e24 8008762: Type annotation on inner class in anonymous class show up as regular type annotations
emc
parents: 19507
diff changeset
   317
                return null;
5ffe0d8a5e24 8008762: Type annotation on inner class in anonymous class show up as regular type annotations
emc
parents: 19507
diff changeset
   318
        }
10
06bc494ca11e Initial load
duke
parents:
diff changeset
   319
    }
06bc494ca11e Initial load
duke
parents:
diff changeset
   320
06bc494ca11e Initial load
duke
parents:
diff changeset
   321
    /** The value for an annotation element of an enum type.
06bc494ca11e Initial load
duke
parents:
diff changeset
   322
     */
06bc494ca11e Initial load
duke
parents:
diff changeset
   323
    public static class Enum extends Attribute {
06bc494ca11e Initial load
duke
parents:
diff changeset
   324
        public VarSymbol value;
06bc494ca11e Initial load
duke
parents:
diff changeset
   325
        public Enum(Type type, VarSymbol value) {
06bc494ca11e Initial load
duke
parents:
diff changeset
   326
            super(type);
8032
e1aa25ccdabb 6396503: javac should not require assertions enabled
jjg
parents: 8031
diff changeset
   327
            this.value = Assert.checkNonNull(value);
10
06bc494ca11e Initial load
duke
parents:
diff changeset
   328
        }
06bc494ca11e Initial load
duke
parents:
diff changeset
   329
        public void accept(Visitor v) { v.visitEnum(this); }
26266
2d24bda701dc 8056061: Mark implementations of public interfaces with an annotation
jlahoda
parents: 25874
diff changeset
   330
        @DefinedBy(Api.LANGUAGE_MODEL)
10
06bc494ca11e Initial load
duke
parents:
diff changeset
   331
        public String toString() {
06bc494ca11e Initial load
duke
parents:
diff changeset
   332
            return value.enclClass() + "." + value;     // qualified name
06bc494ca11e Initial load
duke
parents:
diff changeset
   333
        }
26266
2d24bda701dc 8056061: Mark implementations of public interfaces with an annotation
jlahoda
parents: 25874
diff changeset
   334
        @DefinedBy(Api.LANGUAGE_MODEL)
10
06bc494ca11e Initial load
duke
parents:
diff changeset
   335
        public VarSymbol getValue() {
06bc494ca11e Initial load
duke
parents:
diff changeset
   336
            return value;
06bc494ca11e Initial load
duke
parents:
diff changeset
   337
        }
26266
2d24bda701dc 8056061: Mark implementations of public interfaces with an annotation
jlahoda
parents: 25874
diff changeset
   338
        @DefinedBy(Api.LANGUAGE_MODEL)
10
06bc494ca11e Initial load
duke
parents:
diff changeset
   339
        public <R, P> R accept(AnnotationValueVisitor<R, P> v, P p) {
06bc494ca11e Initial load
duke
parents:
diff changeset
   340
            return v.visitEnumConstant(value, p);
06bc494ca11e Initial load
duke
parents:
diff changeset
   341
        }
06bc494ca11e Initial load
duke
parents:
diff changeset
   342
    }
06bc494ca11e Initial load
duke
parents:
diff changeset
   343
06bc494ca11e Initial load
duke
parents:
diff changeset
   344
    public static class Error extends Attribute {
06bc494ca11e Initial load
duke
parents:
diff changeset
   345
        public Error(Type type) {
06bc494ca11e Initial load
duke
parents:
diff changeset
   346
            super(type);
06bc494ca11e Initial load
duke
parents:
diff changeset
   347
        }
06bc494ca11e Initial load
duke
parents:
diff changeset
   348
        public void accept(Visitor v) { v.visitError(this); }
26266
2d24bda701dc 8056061: Mark implementations of public interfaces with an annotation
jlahoda
parents: 25874
diff changeset
   349
        @DefinedBy(Api.LANGUAGE_MODEL)
10
06bc494ca11e Initial load
duke
parents:
diff changeset
   350
        public String toString() {
06bc494ca11e Initial load
duke
parents:
diff changeset
   351
            return "<error>";
06bc494ca11e Initial load
duke
parents:
diff changeset
   352
        }
26266
2d24bda701dc 8056061: Mark implementations of public interfaces with an annotation
jlahoda
parents: 25874
diff changeset
   353
        @DefinedBy(Api.LANGUAGE_MODEL)
10
06bc494ca11e Initial load
duke
parents:
diff changeset
   354
        public String getValue() {
06bc494ca11e Initial load
duke
parents:
diff changeset
   355
            return toString();
06bc494ca11e Initial load
duke
parents:
diff changeset
   356
        }
26266
2d24bda701dc 8056061: Mark implementations of public interfaces with an annotation
jlahoda
parents: 25874
diff changeset
   357
        @DefinedBy(Api.LANGUAGE_MODEL)
10
06bc494ca11e Initial load
duke
parents:
diff changeset
   358
        public <R, P> R accept(AnnotationValueVisitor<R, P> v, P p) {
06bc494ca11e Initial load
duke
parents:
diff changeset
   359
            return v.visitString(toString(), p);
06bc494ca11e Initial load
duke
parents:
diff changeset
   360
        }
06bc494ca11e Initial load
duke
parents:
diff changeset
   361
    }
06bc494ca11e Initial load
duke
parents:
diff changeset
   362
19507
323f001d6be1 8019243: AnnotationTypeMismatchException instead of MirroredTypeException
jfranck
parents: 18646
diff changeset
   363
    public static class UnresolvedClass extends Error {
323f001d6be1 8019243: AnnotationTypeMismatchException instead of MirroredTypeException
jfranck
parents: 18646
diff changeset
   364
        public Type classType;
323f001d6be1 8019243: AnnotationTypeMismatchException instead of MirroredTypeException
jfranck
parents: 18646
diff changeset
   365
        public UnresolvedClass(Type type, Type classType) {
323f001d6be1 8019243: AnnotationTypeMismatchException instead of MirroredTypeException
jfranck
parents: 18646
diff changeset
   366
            super(type);
323f001d6be1 8019243: AnnotationTypeMismatchException instead of MirroredTypeException
jfranck
parents: 18646
diff changeset
   367
            this.classType = classType;
323f001d6be1 8019243: AnnotationTypeMismatchException instead of MirroredTypeException
jfranck
parents: 18646
diff changeset
   368
        }
323f001d6be1 8019243: AnnotationTypeMismatchException instead of MirroredTypeException
jfranck
parents: 18646
diff changeset
   369
    }
323f001d6be1 8019243: AnnotationTypeMismatchException instead of MirroredTypeException
jfranck
parents: 18646
diff changeset
   370
10
06bc494ca11e Initial load
duke
parents:
diff changeset
   371
    /** A visitor type for dynamic dispatch on the kind of attribute value. */
06bc494ca11e Initial load
duke
parents:
diff changeset
   372
    public static interface Visitor {
06bc494ca11e Initial load
duke
parents:
diff changeset
   373
        void visitConstant(Attribute.Constant value);
06bc494ca11e Initial load
duke
parents:
diff changeset
   374
        void visitClass(Attribute.Class clazz);
06bc494ca11e Initial load
duke
parents:
diff changeset
   375
        void visitCompound(Attribute.Compound compound);
06bc494ca11e Initial load
duke
parents:
diff changeset
   376
        void visitArray(Attribute.Array array);
06bc494ca11e Initial load
duke
parents:
diff changeset
   377
        void visitEnum(Attribute.Enum e);
06bc494ca11e Initial load
duke
parents:
diff changeset
   378
        void visitError(Attribute.Error e);
06bc494ca11e Initial load
duke
parents:
diff changeset
   379
    }
6575
ae1798028008 6960424: new option -Xpkginfo for better control of when package-info.class is generated
jjg
parents: 5847
diff changeset
   380
ae1798028008 6960424: new option -Xpkginfo for better control of when package-info.class is generated
jjg
parents: 5847
diff changeset
   381
    /** A mirror of java.lang.annotation.RetentionPolicy. */
ae1798028008 6960424: new option -Xpkginfo for better control of when package-info.class is generated
jjg
parents: 5847
diff changeset
   382
    public static enum RetentionPolicy {
ae1798028008 6960424: new option -Xpkginfo for better control of when package-info.class is generated
jjg
parents: 5847
diff changeset
   383
        SOURCE,
ae1798028008 6960424: new option -Xpkginfo for better control of when package-info.class is generated
jjg
parents: 5847
diff changeset
   384
        CLASS,
ae1798028008 6960424: new option -Xpkginfo for better control of when package-info.class is generated
jjg
parents: 5847
diff changeset
   385
        RUNTIME
ae1798028008 6960424: new option -Xpkginfo for better control of when package-info.class is generated
jjg
parents: 5847
diff changeset
   386
    }
10
06bc494ca11e Initial load
duke
parents:
diff changeset
   387
}