jdk/src/java.base/share/classes/java/lang/reflect/Executable.java
author darcy
Tue, 10 Feb 2015 11:34:13 -0800
changeset 28864 6a1e63fb3fa9
parent 28431 a5c817e7ddb5
child 32834 e1dca5fe4de3
permissions -rw-r--r--
8072843: Typo in the description of the j.l.r.Executable.getAnnotatedReceiverType Reviewed-by: lancea
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
10127
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
     1
/*
28431
a5c817e7ddb5 8068736: Avoid synchronization on Executable/Field.declaredAnnotations
redestad
parents: 27491
diff changeset
     2
 * Copyright (c) 2012, 2015, Oracle and/or its affiliates. All rights reserved.
10127
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
     3
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
     4
 *
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
     5
 * This code is free software; you can redistribute it and/or modify it
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
     6
 * under the terms of the GNU General Public License version 2 only, as
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
     7
 * published by the Free Software Foundation.  Oracle designates this
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
     8
 * particular file as subject to the "Classpath" exception as provided
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
     9
 * by Oracle in the LICENSE file that accompanied this code.
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    10
 *
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    11
 * This code is distributed in the hope that it will be useful, but WITHOUT
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    12
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    13
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    14
 * version 2 for more details (a copy is included in the LICENSE file that
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    15
 * accompanied this code).
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    16
 *
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    17
 * You should have received a copy of the GNU General Public License version
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    18
 * 2 along with this work; if not, write to the Free Software Foundation,
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    19
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    20
 *
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    21
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    22
 * or visit www.oracle.com if you need additional information or have any
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    23
 * questions.
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    24
 */
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    25
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    26
package java.lang.reflect;
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    27
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    28
import java.lang.annotation.*;
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    29
import java.util.Map;
14676
985410ec95e3 7154390: Add support for repeating annotations in j.l.r.AnnotatedElement
jfranck
parents: 14342
diff changeset
    30
import java.util.Objects;
10127
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    31
import sun.reflect.annotation.AnnotationParser;
14676
985410ec95e3 7154390: Add support for repeating annotations in j.l.r.AnnotatedElement
jfranck
parents: 14342
diff changeset
    32
import sun.reflect.annotation.AnnotationSupport;
15510
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
    33
import sun.reflect.annotation.TypeAnnotationParser;
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
    34
import sun.reflect.annotation.TypeAnnotation;
10127
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    35
import sun.reflect.generics.repository.ConstructorRepository;
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    36
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    37
/**
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    38
 * A shared superclass for the common functionality of {@link Method}
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    39
 * and {@link Constructor}.
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    40
 *
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    41
 * @since 1.8
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    42
 */
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    43
public abstract class Executable extends AccessibleObject
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    44
    implements Member, GenericDeclaration {
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    45
    /*
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    46
     * Only grant package-visibility to the constructor.
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    47
     */
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    48
    Executable() {}
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    49
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    50
    /**
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    51
     * Accessor method to allow code sharing
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    52
     */
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    53
    abstract byte[] getAnnotationBytes();
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    54
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    55
    /**
26455
195a6f3e0cd0 8054987: (reflect) Add sharing of annotations between instances of Executable
jfranck
parents: 25991
diff changeset
    56
     * Accessor method to allow code sharing
195a6f3e0cd0 8054987: (reflect) Add sharing of annotations between instances of Executable
jfranck
parents: 25991
diff changeset
    57
     */
195a6f3e0cd0 8054987: (reflect) Add sharing of annotations between instances of Executable
jfranck
parents: 25991
diff changeset
    58
    abstract Executable getRoot();
195a6f3e0cd0 8054987: (reflect) Add sharing of annotations between instances of Executable
jfranck
parents: 25991
diff changeset
    59
195a6f3e0cd0 8054987: (reflect) Add sharing of annotations between instances of Executable
jfranck
parents: 25991
diff changeset
    60
    /**
10127
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    61
     * Does the Executable have generic information.
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    62
     */
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    63
    abstract boolean hasGenericInformation();
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    64
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    65
    abstract ConstructorRepository getGenericInfo();
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    66
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    67
    boolean equalParamTypes(Class<?>[] params1, Class<?>[] params2) {
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    68
        /* Avoid unnecessary cloning */
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    69
        if (params1.length == params2.length) {
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    70
            for (int i = 0; i < params1.length; i++) {
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    71
                if (params1[i] != params2[i])
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    72
                    return false;
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    73
            }
10142
43c81972df7b 7073296: Executable.equalParamTypes() incorrectly returns true when the number of params differs.
mduigou
parents: 10127
diff changeset
    74
            return true;
10127
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    75
        }
10142
43c81972df7b 7073296: Executable.equalParamTypes() incorrectly returns true when the number of params differs.
mduigou
parents: 10127
diff changeset
    76
        return false;
10127
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    77
    }
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    78
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    79
    Annotation[][] parseParameterAnnotations(byte[] parameterAnnotations) {
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    80
        return AnnotationParser.parseParameterAnnotations(
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    81
               parameterAnnotations,
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    82
               sun.misc.SharedSecrets.getJavaLangAccess().
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    83
               getConstantPool(getDeclaringClass()),
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    84
               getDeclaringClass());
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    85
    }
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    86
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    87
    void separateWithCommas(Class<?>[] types, StringBuilder sb) {
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    88
        for (int j = 0; j < types.length; j++) {
16743
b0b34102bb4c 6298888: Add toGenericString to j.l.Class and getTypeName to j.l.reflect.Type
darcy
parents: 16729
diff changeset
    89
            sb.append(types[j].getTypeName());
10127
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    90
            if (j < (types.length - 1))
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    91
                sb.append(",");
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    92
        }
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    93
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    94
    }
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    95
16729
3b26e313ad81 8004979: java.lang.reflect.Modifier.toString should include "default"
darcy
parents: 16058
diff changeset
    96
    void printModifiersIfNonzero(StringBuilder sb, int mask, boolean isDefault) {
10127
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
    97
        int mod = getModifiers() & mask;
16729
3b26e313ad81 8004979: java.lang.reflect.Modifier.toString should include "default"
darcy
parents: 16058
diff changeset
    98
3b26e313ad81 8004979: java.lang.reflect.Modifier.toString should include "default"
darcy
parents: 16058
diff changeset
    99
        if (mod != 0 && !isDefault) {
10127
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   100
            sb.append(Modifier.toString(mod)).append(' ');
16729
3b26e313ad81 8004979: java.lang.reflect.Modifier.toString should include "default"
darcy
parents: 16058
diff changeset
   101
        } else {
3b26e313ad81 8004979: java.lang.reflect.Modifier.toString should include "default"
darcy
parents: 16058
diff changeset
   102
            int access_mod = mod & Modifier.ACCESS_MODIFIERS;
3b26e313ad81 8004979: java.lang.reflect.Modifier.toString should include "default"
darcy
parents: 16058
diff changeset
   103
            if (access_mod != 0)
3b26e313ad81 8004979: java.lang.reflect.Modifier.toString should include "default"
darcy
parents: 16058
diff changeset
   104
                sb.append(Modifier.toString(access_mod)).append(' ');
3b26e313ad81 8004979: java.lang.reflect.Modifier.toString should include "default"
darcy
parents: 16058
diff changeset
   105
            if (isDefault)
3b26e313ad81 8004979: java.lang.reflect.Modifier.toString should include "default"
darcy
parents: 16058
diff changeset
   106
                sb.append("default ");
3b26e313ad81 8004979: java.lang.reflect.Modifier.toString should include "default"
darcy
parents: 16058
diff changeset
   107
            mod = (mod & ~Modifier.ACCESS_MODIFIERS);
3b26e313ad81 8004979: java.lang.reflect.Modifier.toString should include "default"
darcy
parents: 16058
diff changeset
   108
            if (mod != 0)
3b26e313ad81 8004979: java.lang.reflect.Modifier.toString should include "default"
darcy
parents: 16058
diff changeset
   109
                sb.append(Modifier.toString(mod)).append(' ');
10127
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   110
        }
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   111
    }
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   112
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   113
    String sharedToString(int modifierMask,
16729
3b26e313ad81 8004979: java.lang.reflect.Modifier.toString should include "default"
darcy
parents: 16058
diff changeset
   114
                          boolean isDefault,
10127
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   115
                          Class<?>[] parameterTypes,
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   116
                          Class<?>[] exceptionTypes) {
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   117
        try {
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   118
            StringBuilder sb = new StringBuilder();
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   119
16729
3b26e313ad81 8004979: java.lang.reflect.Modifier.toString should include "default"
darcy
parents: 16058
diff changeset
   120
            printModifiersIfNonzero(sb, modifierMask, isDefault);
10127
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   121
            specificToStringHeader(sb);
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   122
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   123
            sb.append('(');
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   124
            separateWithCommas(parameterTypes, sb);
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   125
            sb.append(')');
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   126
            if (exceptionTypes.length > 0) {
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   127
                sb.append(" throws ");
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   128
                separateWithCommas(exceptionTypes, sb);
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   129
            }
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   130
            return sb.toString();
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   131
        } catch (Exception e) {
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   132
            return "<" + e + ">";
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   133
        }
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   134
    }
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   135
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   136
    /**
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   137
     * Generate toString header information specific to a method or
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   138
     * constructor.
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   139
     */
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   140
    abstract void specificToStringHeader(StringBuilder sb);
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   141
16729
3b26e313ad81 8004979: java.lang.reflect.Modifier.toString should include "default"
darcy
parents: 16058
diff changeset
   142
    String sharedToGenericString(int modifierMask, boolean isDefault) {
10127
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   143
        try {
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   144
            StringBuilder sb = new StringBuilder();
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   145
16729
3b26e313ad81 8004979: java.lang.reflect.Modifier.toString should include "default"
darcy
parents: 16058
diff changeset
   146
            printModifiersIfNonzero(sb, modifierMask, isDefault);
10127
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   147
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   148
            TypeVariable<?>[] typeparms = getTypeParameters();
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   149
            if (typeparms.length > 0) {
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   150
                boolean first = true;
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   151
                sb.append('<');
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   152
                for(TypeVariable<?> typeparm: typeparms) {
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   153
                    if (!first)
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   154
                        sb.append(',');
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   155
                    // Class objects can't occur here; no need to test
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   156
                    // and call Class.getName().
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   157
                    sb.append(typeparm.toString());
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   158
                    first = false;
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   159
                }
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   160
                sb.append("> ");
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   161
            }
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   162
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   163
            specificToGenericStringHeader(sb);
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   164
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   165
            sb.append('(');
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   166
            Type[] params = getGenericParameterTypes();
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   167
            for (int j = 0; j < params.length; j++) {
16743
b0b34102bb4c 6298888: Add toGenericString to j.l.Class and getTypeName to j.l.reflect.Type
darcy
parents: 16729
diff changeset
   168
                String param = params[j].getTypeName();
10127
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   169
                if (isVarArgs() && (j == params.length - 1)) // replace T[] with T...
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   170
                    param = param.replaceFirst("\\[\\]$", "...");
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   171
                sb.append(param);
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   172
                if (j < (params.length - 1))
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   173
                    sb.append(',');
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   174
            }
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   175
            sb.append(')');
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   176
            Type[] exceptions = getGenericExceptionTypes();
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   177
            if (exceptions.length > 0) {
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   178
                sb.append(" throws ");
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   179
                for (int k = 0; k < exceptions.length; k++) {
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   180
                    sb.append((exceptions[k] instanceof Class)?
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   181
                              ((Class)exceptions[k]).getName():
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   182
                              exceptions[k].toString());
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   183
                    if (k < (exceptions.length - 1))
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   184
                        sb.append(',');
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   185
                }
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   186
            }
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   187
            return sb.toString();
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   188
        } catch (Exception e) {
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   189
            return "<" + e + ">";
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   190
        }
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   191
    }
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   192
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   193
    /**
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   194
     * Generate toGenericString header information specific to a
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   195
     * method or constructor.
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   196
     */
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   197
    abstract void specificToGenericStringHeader(StringBuilder sb);
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   198
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   199
    /**
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   200
     * Returns the {@code Class} object representing the class or interface
11996
19e65c956b22 7149626: (reflect) Improve javadoc of java.lang.reflect.Executable
darcy
parents: 10342
diff changeset
   201
     * that declares the executable represented by this object.
10127
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   202
     */
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   203
    public abstract Class<?> getDeclaringClass();
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   204
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   205
    /**
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   206
     * Returns the name of the executable represented by this object.
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   207
     */
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   208
    public abstract String getName();
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   209
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   210
    /**
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   211
     * Returns the Java language {@linkplain Modifier modifiers} for
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   212
     * the executable represented by this object.
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   213
     */
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   214
    public abstract int getModifiers();
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   215
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   216
    /**
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   217
     * Returns an array of {@code TypeVariable} objects that represent the
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   218
     * type variables declared by the generic declaration represented by this
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   219
     * {@code GenericDeclaration} object, in declaration order.  Returns an
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   220
     * array of length 0 if the underlying generic declaration declares no type
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   221
     * variables.
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   222
     *
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   223
     * @return an array of {@code TypeVariable} objects that represent
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   224
     *     the type variables declared by this generic declaration
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   225
     * @throws GenericSignatureFormatError if the generic
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   226
     *     signature of this generic declaration does not conform to
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   227
     *     the format specified in
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   228
     *     <cite>The Java&trade; Virtual Machine Specification</cite>
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   229
     */
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   230
    public abstract TypeVariable<?>[] getTypeParameters();
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   231
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   232
    /**
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   233
     * Returns an array of {@code Class} objects that represent the formal
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   234
     * parameter types, in declaration order, of the executable
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   235
     * represented by this object.  Returns an array of length
11996
19e65c956b22 7149626: (reflect) Improve javadoc of java.lang.reflect.Executable
darcy
parents: 10342
diff changeset
   236
     * 0 if the underlying executable takes no parameters.
10127
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   237
     *
11996
19e65c956b22 7149626: (reflect) Improve javadoc of java.lang.reflect.Executable
darcy
parents: 10342
diff changeset
   238
     * @return the parameter types for the executable this object
10127
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   239
     * represents
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   240
     */
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   241
    public abstract Class<?>[] getParameterTypes();
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   242
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   243
    /**
17177
59a964c1d518 8012937: Correct errors in javadoc comments.
emc
parents: 16743
diff changeset
   244
     * Returns the number of formal parameters (whether explicitly
59a964c1d518 8012937: Correct errors in javadoc comments.
emc
parents: 16743
diff changeset
   245
     * declared or implicitly declared or neither) for the executable
15294
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   246
     * represented by this object.
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   247
     *
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   248
     * @return The number of formal parameters for the executable this
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   249
     * object represents
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   250
     */
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   251
    public int getParameterCount() {
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   252
        throw new AbstractMethodError();
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   253
    }
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   254
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   255
    /**
10127
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   256
     * Returns an array of {@code Type} objects that represent the formal
11996
19e65c956b22 7149626: (reflect) Improve javadoc of java.lang.reflect.Executable
darcy
parents: 10342
diff changeset
   257
     * parameter types, in declaration order, of the executable represented by
19e65c956b22 7149626: (reflect) Improve javadoc of java.lang.reflect.Executable
darcy
parents: 10342
diff changeset
   258
     * this object. Returns an array of length 0 if the
19e65c956b22 7149626: (reflect) Improve javadoc of java.lang.reflect.Executable
darcy
parents: 10342
diff changeset
   259
     * underlying executable takes no parameters.
10127
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   260
     *
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   261
     * <p>If a formal parameter type is a parameterized type,
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   262
     * the {@code Type} object returned for it must accurately reflect
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   263
     * the actual type parameters used in the source code.
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   264
     *
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   265
     * <p>If a formal parameter type is a type variable or a parameterized
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   266
     * type, it is created. Otherwise, it is resolved.
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   267
     *
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   268
     * @return an array of {@code Type}s that represent the formal
11996
19e65c956b22 7149626: (reflect) Improve javadoc of java.lang.reflect.Executable
darcy
parents: 10342
diff changeset
   269
     *     parameter types of the underlying executable, in declaration order
10127
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   270
     * @throws GenericSignatureFormatError
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   271
     *     if the generic method signature does not conform to the format
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   272
     *     specified in
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   273
     *     <cite>The Java&trade; Virtual Machine Specification</cite>
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   274
     * @throws TypeNotPresentException if any of the parameter
11996
19e65c956b22 7149626: (reflect) Improve javadoc of java.lang.reflect.Executable
darcy
parents: 10342
diff changeset
   275
     *     types of the underlying executable refers to a non-existent type
10127
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   276
     *     declaration
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   277
     * @throws MalformedParameterizedTypeException if any of
11996
19e65c956b22 7149626: (reflect) Improve javadoc of java.lang.reflect.Executable
darcy
parents: 10342
diff changeset
   278
     *     the underlying executable's parameter types refer to a parameterized
10127
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   279
     *     type that cannot be instantiated for any reason
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   280
     */
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   281
    public Type[] getGenericParameterTypes() {
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   282
        if (hasGenericInformation())
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   283
            return getGenericInfo().getParameterTypes();
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   284
        else
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   285
            return getParameterTypes();
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   286
    }
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   287
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   288
    /**
27491
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   289
     * Behaves like {@code getGenericParameterTypes}, but returns type
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   290
     * information for all parameters, including synthetic parameters.
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   291
     */
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   292
    Type[] getAllGenericParameterTypes() {
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   293
        final boolean genericInfo = hasGenericInformation();
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   294
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   295
        // Easy case: we don't have generic parameter information.  In
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   296
        // this case, we just return the result of
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   297
        // getParameterTypes().
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   298
        if (!genericInfo) {
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   299
            return getParameterTypes();
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   300
        } else {
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   301
            final boolean realParamData = hasRealParameterData();
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   302
            final Type[] genericParamTypes = getGenericParameterTypes();
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   303
            final Type[] nonGenericParamTypes = getParameterTypes();
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   304
            final Type[] out = new Type[nonGenericParamTypes.length];
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   305
            final Parameter[] params = getParameters();
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   306
            int fromidx = 0;
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   307
            // If we have real parameter data, then we use the
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   308
            // synthetic and mandate flags to our advantage.
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   309
            if (realParamData) {
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   310
                for (int i = 0; i < out.length; i++) {
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   311
                    final Parameter param = params[i];
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   312
                    if (param.isSynthetic() || param.isImplicit()) {
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   313
                        // If we hit a synthetic or mandated parameter,
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   314
                        // use the non generic parameter info.
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   315
                        out[i] = nonGenericParamTypes[i];
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   316
                    } else {
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   317
                        // Otherwise, use the generic parameter info.
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   318
                        out[i] = genericParamTypes[fromidx];
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   319
                        fromidx++;
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   320
                    }
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   321
                }
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   322
            } else {
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   323
                // Otherwise, use the non-generic parameter data.
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   324
                // Without method parameter reflection data, we have
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   325
                // no way to figure out which parameters are
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   326
                // synthetic/mandated, thus, no way to match up the
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   327
                // indexes.
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   328
                return genericParamTypes.length == nonGenericParamTypes.length ?
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   329
                    genericParamTypes : nonGenericParamTypes;
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   330
            }
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   331
            return out;
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   332
        }
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   333
    }
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   334
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   335
    /**
15294
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   336
     * Returns an array of {@code Parameter} objects that represent
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   337
     * all the parameters to the underlying executable represented by
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   338
     * this object.  Returns an array of length 0 if the executable
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   339
     * has no parameters.
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   340
     *
20506
d826dd5f8e10 8020981: Update methods of java.lang.reflect.Parameter to throw correct exceptions
emc
parents: 20482
diff changeset
   341
     * <p>The parameters of the underlying executable do not necessarily
15655
d9ab4d9ee4f2 8007405: Update java.lang.reflect API to replace SYNTHESIZED with MANDATED
alanb
parents: 15511
diff changeset
   342
     * have unique names, or names that are legal identifiers in the
d9ab4d9ee4f2 8007405: Update java.lang.reflect API to replace SYNTHESIZED with MANDATED
alanb
parents: 15511
diff changeset
   343
     * Java programming language (JLS 3.8).
d9ab4d9ee4f2 8007405: Update java.lang.reflect API to replace SYNTHESIZED with MANDATED
alanb
parents: 15511
diff changeset
   344
     *
20506
d826dd5f8e10 8020981: Update methods of java.lang.reflect.Parameter to throw correct exceptions
emc
parents: 20482
diff changeset
   345
     * @throws MalformedParametersException if the class file contains
d826dd5f8e10 8020981: Update methods of java.lang.reflect.Parameter to throw correct exceptions
emc
parents: 20482
diff changeset
   346
     * a MethodParameters attribute that is improperly formatted.
15294
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   347
     * @return an array of {@code Parameter} objects representing all
20506
d826dd5f8e10 8020981: Update methods of java.lang.reflect.Parameter to throw correct exceptions
emc
parents: 20482
diff changeset
   348
     * the parameters to the executable this object represents.
15294
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   349
     */
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   350
    public Parameter[] getParameters() {
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   351
        // TODO: This may eventually need to be guarded by security
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   352
        // mechanisms similar to those in Field, Method, etc.
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   353
        //
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   354
        // Need to copy the cached array to prevent users from messing
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   355
        // with it.  Since parameters are immutable, we can
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   356
        // shallow-copy.
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   357
        return privateGetParameters().clone();
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   358
    }
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   359
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   360
    private Parameter[] synthesizeAllParams() {
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   361
        final int realparams = getParameterCount();
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   362
        final Parameter[] out = new Parameter[realparams];
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   363
        for (int i = 0; i < realparams; i++)
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   364
            // TODO: is there a way to synthetically derive the
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   365
            // modifiers?  Probably not in the general case, since
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   366
            // we'd have no way of knowing about them, but there
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   367
            // may be specific cases.
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   368
            out[i] = new Parameter("arg" + i, 0, this, i);
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   369
        return out;
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   370
    }
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   371
20506
d826dd5f8e10 8020981: Update methods of java.lang.reflect.Parameter to throw correct exceptions
emc
parents: 20482
diff changeset
   372
    private void verifyParameters(final Parameter[] parameters) {
d826dd5f8e10 8020981: Update methods of java.lang.reflect.Parameter to throw correct exceptions
emc
parents: 20482
diff changeset
   373
        final int mask = Modifier.FINAL | Modifier.SYNTHETIC | Modifier.MANDATED;
d826dd5f8e10 8020981: Update methods of java.lang.reflect.Parameter to throw correct exceptions
emc
parents: 20482
diff changeset
   374
d826dd5f8e10 8020981: Update methods of java.lang.reflect.Parameter to throw correct exceptions
emc
parents: 20482
diff changeset
   375
        if (getParameterTypes().length != parameters.length)
d826dd5f8e10 8020981: Update methods of java.lang.reflect.Parameter to throw correct exceptions
emc
parents: 20482
diff changeset
   376
            throw new MalformedParametersException("Wrong number of parameters in MethodParameters attribute");
d826dd5f8e10 8020981: Update methods of java.lang.reflect.Parameter to throw correct exceptions
emc
parents: 20482
diff changeset
   377
d826dd5f8e10 8020981: Update methods of java.lang.reflect.Parameter to throw correct exceptions
emc
parents: 20482
diff changeset
   378
        for (Parameter parameter : parameters) {
d826dd5f8e10 8020981: Update methods of java.lang.reflect.Parameter to throw correct exceptions
emc
parents: 20482
diff changeset
   379
            final String name = parameter.getRealName();
d826dd5f8e10 8020981: Update methods of java.lang.reflect.Parameter to throw correct exceptions
emc
parents: 20482
diff changeset
   380
            final int mods = parameter.getModifiers();
d826dd5f8e10 8020981: Update methods of java.lang.reflect.Parameter to throw correct exceptions
emc
parents: 20482
diff changeset
   381
d826dd5f8e10 8020981: Update methods of java.lang.reflect.Parameter to throw correct exceptions
emc
parents: 20482
diff changeset
   382
            if (name != null) {
d826dd5f8e10 8020981: Update methods of java.lang.reflect.Parameter to throw correct exceptions
emc
parents: 20482
diff changeset
   383
                if (name.isEmpty() || name.indexOf('.') != -1 ||
d826dd5f8e10 8020981: Update methods of java.lang.reflect.Parameter to throw correct exceptions
emc
parents: 20482
diff changeset
   384
                    name.indexOf(';') != -1 || name.indexOf('[') != -1 ||
d826dd5f8e10 8020981: Update methods of java.lang.reflect.Parameter to throw correct exceptions
emc
parents: 20482
diff changeset
   385
                    name.indexOf('/') != -1) {
d826dd5f8e10 8020981: Update methods of java.lang.reflect.Parameter to throw correct exceptions
emc
parents: 20482
diff changeset
   386
                    throw new MalformedParametersException("Invalid parameter name \"" + name + "\"");
d826dd5f8e10 8020981: Update methods of java.lang.reflect.Parameter to throw correct exceptions
emc
parents: 20482
diff changeset
   387
                }
d826dd5f8e10 8020981: Update methods of java.lang.reflect.Parameter to throw correct exceptions
emc
parents: 20482
diff changeset
   388
            }
d826dd5f8e10 8020981: Update methods of java.lang.reflect.Parameter to throw correct exceptions
emc
parents: 20482
diff changeset
   389
d826dd5f8e10 8020981: Update methods of java.lang.reflect.Parameter to throw correct exceptions
emc
parents: 20482
diff changeset
   390
            if (mods != (mods & mask)) {
d826dd5f8e10 8020981: Update methods of java.lang.reflect.Parameter to throw correct exceptions
emc
parents: 20482
diff changeset
   391
                throw new MalformedParametersException("Invalid parameter modifiers");
d826dd5f8e10 8020981: Update methods of java.lang.reflect.Parameter to throw correct exceptions
emc
parents: 20482
diff changeset
   392
            }
d826dd5f8e10 8020981: Update methods of java.lang.reflect.Parameter to throw correct exceptions
emc
parents: 20482
diff changeset
   393
        }
d826dd5f8e10 8020981: Update methods of java.lang.reflect.Parameter to throw correct exceptions
emc
parents: 20482
diff changeset
   394
    }
d826dd5f8e10 8020981: Update methods of java.lang.reflect.Parameter to throw correct exceptions
emc
parents: 20482
diff changeset
   395
15294
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   396
    private Parameter[] privateGetParameters() {
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   397
        // Use tmp to avoid multiple writes to a volatile.
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   398
        Parameter[] tmp = parameters;
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   399
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   400
        if (tmp == null) {
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   401
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   402
            // Otherwise, go to the JVM to get them
20506
d826dd5f8e10 8020981: Update methods of java.lang.reflect.Parameter to throw correct exceptions
emc
parents: 20482
diff changeset
   403
            try {
d826dd5f8e10 8020981: Update methods of java.lang.reflect.Parameter to throw correct exceptions
emc
parents: 20482
diff changeset
   404
                tmp = getParameters0();
d826dd5f8e10 8020981: Update methods of java.lang.reflect.Parameter to throw correct exceptions
emc
parents: 20482
diff changeset
   405
            } catch(IllegalArgumentException e) {
d826dd5f8e10 8020981: Update methods of java.lang.reflect.Parameter to throw correct exceptions
emc
parents: 20482
diff changeset
   406
                // Rethrow ClassFormatErrors
d826dd5f8e10 8020981: Update methods of java.lang.reflect.Parameter to throw correct exceptions
emc
parents: 20482
diff changeset
   407
                throw new MalformedParametersException("Invalid constant pool index");
d826dd5f8e10 8020981: Update methods of java.lang.reflect.Parameter to throw correct exceptions
emc
parents: 20482
diff changeset
   408
            }
15294
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   409
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   410
            // If we get back nothing, then synthesize parameters
18775
fa61a37ed42b 8016285: Add java.lang.reflect.Parameter.isNamePresent()
emc
parents: 18546
diff changeset
   411
            if (tmp == null) {
fa61a37ed42b 8016285: Add java.lang.reflect.Parameter.isNamePresent()
emc
parents: 18546
diff changeset
   412
                hasRealParameterData = false;
15294
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   413
                tmp = synthesizeAllParams();
18775
fa61a37ed42b 8016285: Add java.lang.reflect.Parameter.isNamePresent()
emc
parents: 18546
diff changeset
   414
            } else {
fa61a37ed42b 8016285: Add java.lang.reflect.Parameter.isNamePresent()
emc
parents: 18546
diff changeset
   415
                hasRealParameterData = true;
20506
d826dd5f8e10 8020981: Update methods of java.lang.reflect.Parameter to throw correct exceptions
emc
parents: 20482
diff changeset
   416
                verifyParameters(tmp);
18775
fa61a37ed42b 8016285: Add java.lang.reflect.Parameter.isNamePresent()
emc
parents: 18546
diff changeset
   417
            }
15294
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   418
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   419
            parameters = tmp;
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   420
        }
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   421
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   422
        return tmp;
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   423
    }
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   424
18775
fa61a37ed42b 8016285: Add java.lang.reflect.Parameter.isNamePresent()
emc
parents: 18546
diff changeset
   425
    boolean hasRealParameterData() {
fa61a37ed42b 8016285: Add java.lang.reflect.Parameter.isNamePresent()
emc
parents: 18546
diff changeset
   426
        // If this somehow gets called before parameters gets
fa61a37ed42b 8016285: Add java.lang.reflect.Parameter.isNamePresent()
emc
parents: 18546
diff changeset
   427
        // initialized, force it into existence.
fa61a37ed42b 8016285: Add java.lang.reflect.Parameter.isNamePresent()
emc
parents: 18546
diff changeset
   428
        if (parameters == null) {
fa61a37ed42b 8016285: Add java.lang.reflect.Parameter.isNamePresent()
emc
parents: 18546
diff changeset
   429
            privateGetParameters();
fa61a37ed42b 8016285: Add java.lang.reflect.Parameter.isNamePresent()
emc
parents: 18546
diff changeset
   430
        }
fa61a37ed42b 8016285: Add java.lang.reflect.Parameter.isNamePresent()
emc
parents: 18546
diff changeset
   431
        return hasRealParameterData;
fa61a37ed42b 8016285: Add java.lang.reflect.Parameter.isNamePresent()
emc
parents: 18546
diff changeset
   432
    }
fa61a37ed42b 8016285: Add java.lang.reflect.Parameter.isNamePresent()
emc
parents: 18546
diff changeset
   433
fa61a37ed42b 8016285: Add java.lang.reflect.Parameter.isNamePresent()
emc
parents: 18546
diff changeset
   434
    private transient volatile boolean hasRealParameterData;
15294
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   435
    private transient volatile Parameter[] parameters;
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   436
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   437
    private native Parameter[] getParameters0();
21361
6e4ef4e0097f 8023651: j.l.r.Constructor.getAnnotatedReceiverType() and j.l.r.Constructor.getAnnotatedReturnType() for inner classes return incorrect result
jfranck
parents: 21316
diff changeset
   438
    native byte[] getTypeAnnotationBytes0();
20482
6dc1f81f522c 8009719: core reflection should get type annotation data from the VM lazily
jfranck
parents: 20481
diff changeset
   439
6dc1f81f522c 8009719: core reflection should get type annotation data from the VM lazily
jfranck
parents: 20481
diff changeset
   440
    // Needed by reflectaccess
6dc1f81f522c 8009719: core reflection should get type annotation data from the VM lazily
jfranck
parents: 20481
diff changeset
   441
    byte[] getTypeAnnotationBytes() {
6dc1f81f522c 8009719: core reflection should get type annotation data from the VM lazily
jfranck
parents: 20481
diff changeset
   442
        return getTypeAnnotationBytes0();
6dc1f81f522c 8009719: core reflection should get type annotation data from the VM lazily
jfranck
parents: 20481
diff changeset
   443
    }
15294
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   444
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   445
    /**
10127
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   446
     * Returns an array of {@code Class} objects that represent the
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   447
     * types of exceptions declared to be thrown by the underlying
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   448
     * executable represented by this object.  Returns an array of
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   449
     * length 0 if the executable declares no exceptions in its {@code
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   450
     * throws} clause.
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   451
     *
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   452
     * @return the exception types declared as being thrown by the
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   453
     * executable this object represents
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   454
     */
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   455
    public abstract Class<?>[] getExceptionTypes();
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   456
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   457
    /**
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   458
     * Returns an array of {@code Type} objects that represent the
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   459
     * exceptions declared to be thrown by this executable object.
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   460
     * Returns an array of length 0 if the underlying executable declares
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   461
     * no exceptions in its {@code throws} clause.
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   462
     *
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   463
     * <p>If an exception type is a type variable or a parameterized
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   464
     * type, it is created. Otherwise, it is resolved.
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   465
     *
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   466
     * @return an array of Types that represent the exception types
11996
19e65c956b22 7149626: (reflect) Improve javadoc of java.lang.reflect.Executable
darcy
parents: 10342
diff changeset
   467
     *     thrown by the underlying executable
10127
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   468
     * @throws GenericSignatureFormatError
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   469
     *     if the generic method signature does not conform to the format
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   470
     *     specified in
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   471
     *     <cite>The Java&trade; Virtual Machine Specification</cite>
11996
19e65c956b22 7149626: (reflect) Improve javadoc of java.lang.reflect.Executable
darcy
parents: 10342
diff changeset
   472
     * @throws TypeNotPresentException if the underlying executable's
10127
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   473
     *     {@code throws} clause refers to a non-existent type declaration
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   474
     * @throws MalformedParameterizedTypeException if
11996
19e65c956b22 7149626: (reflect) Improve javadoc of java.lang.reflect.Executable
darcy
parents: 10342
diff changeset
   475
     *     the underlying executable's {@code throws} clause refers to a
10127
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   476
     *     parameterized type that cannot be instantiated for any reason
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   477
     */
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   478
    public Type[] getGenericExceptionTypes() {
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   479
        Type[] result;
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   480
        if (hasGenericInformation() &&
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   481
            ((result = getGenericInfo().getExceptionTypes()).length > 0))
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   482
            return result;
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   483
        else
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   484
            return getExceptionTypes();
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   485
    }
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   486
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   487
    /**
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   488
     * Returns a string describing this {@code Executable}, including
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   489
     * any type parameters.
18546
862067c6481c 8017550: Fix doclint issues in java.lang and subpackages
darcy
parents: 17450
diff changeset
   490
     * @return a string describing this {@code Executable}, including
862067c6481c 8017550: Fix doclint issues in java.lang and subpackages
darcy
parents: 17450
diff changeset
   491
     * any type parameters
10127
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   492
     */
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   493
    public abstract String toGenericString();
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   494
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   495
    /**
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   496
     * Returns {@code true} if this executable was declared to take a
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   497
     * variable number of arguments; returns {@code false} otherwise.
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   498
     *
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   499
     * @return {@code true} if an only if this executable was declared
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   500
     * to take a variable number of arguments.
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   501
     */
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   502
    public boolean isVarArgs()  {
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   503
        return (getModifiers() & Modifier.VARARGS) != 0;
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   504
    }
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   505
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   506
    /**
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   507
     * Returns {@code true} if this executable is a synthetic
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   508
     * construct; returns {@code false} otherwise.
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   509
     *
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   510
     * @return true if and only if this executable is a synthetic
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   511
     * construct as defined by
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   512
     * <cite>The Java&trade; Language Specification</cite>.
14910
337380568515 8005097: Tie isSynthetic javadoc to the JLS
darcy
parents: 14676
diff changeset
   513
     * @jls 13.1 The Form of a Binary
10127
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   514
     */
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   515
    public boolean isSynthetic() {
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   516
        return Modifier.isSynthetic(getModifiers());
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   517
    }
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   518
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   519
    /**
19838
e2815bcfacf0 6962494: Update documentation on Executable.getParameterAnnotations()
emc
parents: 18775
diff changeset
   520
     * Returns an array of arrays of {@code Annotation}s that
e2815bcfacf0 6962494: Update documentation on Executable.getParameterAnnotations()
emc
parents: 18775
diff changeset
   521
     * represent the annotations on the formal parameters, in
e2815bcfacf0 6962494: Update documentation on Executable.getParameterAnnotations()
emc
parents: 18775
diff changeset
   522
     * declaration order, of the {@code Executable} represented by
e2815bcfacf0 6962494: Update documentation on Executable.getParameterAnnotations()
emc
parents: 18775
diff changeset
   523
     * this object.  Synthetic and mandated parameters (see
e2815bcfacf0 6962494: Update documentation on Executable.getParameterAnnotations()
emc
parents: 18775
diff changeset
   524
     * explanation below), such as the outer "this" parameter to an
e2815bcfacf0 6962494: Update documentation on Executable.getParameterAnnotations()
emc
parents: 18775
diff changeset
   525
     * inner class constructor will be represented in the returned
e2815bcfacf0 6962494: Update documentation on Executable.getParameterAnnotations()
emc
parents: 18775
diff changeset
   526
     * array.  If the executable has no parameters (meaning no formal,
e2815bcfacf0 6962494: Update documentation on Executable.getParameterAnnotations()
emc
parents: 18775
diff changeset
   527
     * no synthetic, and no mandated parameters), a zero-length array
e2815bcfacf0 6962494: Update documentation on Executable.getParameterAnnotations()
emc
parents: 18775
diff changeset
   528
     * will be returned.  If the {@code Executable} has one or more
e2815bcfacf0 6962494: Update documentation on Executable.getParameterAnnotations()
emc
parents: 18775
diff changeset
   529
     * parameters, a nested array of length zero is returned for each
e2815bcfacf0 6962494: Update documentation on Executable.getParameterAnnotations()
emc
parents: 18775
diff changeset
   530
     * parameter with no annotations. The annotation objects contained
e2815bcfacf0 6962494: Update documentation on Executable.getParameterAnnotations()
emc
parents: 18775
diff changeset
   531
     * in the returned arrays are serializable.  The caller of this
e2815bcfacf0 6962494: Update documentation on Executable.getParameterAnnotations()
emc
parents: 18775
diff changeset
   532
     * method is free to modify the returned arrays; it will have no
e2815bcfacf0 6962494: Update documentation on Executable.getParameterAnnotations()
emc
parents: 18775
diff changeset
   533
     * effect on the arrays returned to other callers.
10127
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   534
     *
19838
e2815bcfacf0 6962494: Update documentation on Executable.getParameterAnnotations()
emc
parents: 18775
diff changeset
   535
     * A compiler may add extra parameters that are implicitly
e2815bcfacf0 6962494: Update documentation on Executable.getParameterAnnotations()
emc
parents: 18775
diff changeset
   536
     * declared in source ("mandated"), as well as parameters that
e2815bcfacf0 6962494: Update documentation on Executable.getParameterAnnotations()
emc
parents: 18775
diff changeset
   537
     * are neither implicitly nor explicitly declared in source
e2815bcfacf0 6962494: Update documentation on Executable.getParameterAnnotations()
emc
parents: 18775
diff changeset
   538
     * ("synthetic") to the parameter list for a method.  See {@link
e2815bcfacf0 6962494: Update documentation on Executable.getParameterAnnotations()
emc
parents: 18775
diff changeset
   539
     * java.lang.reflect.Parameter} for more information.
e2815bcfacf0 6962494: Update documentation on Executable.getParameterAnnotations()
emc
parents: 18775
diff changeset
   540
     *
e2815bcfacf0 6962494: Update documentation on Executable.getParameterAnnotations()
emc
parents: 18775
diff changeset
   541
     * @see java.lang.reflect.Parameter
e2815bcfacf0 6962494: Update documentation on Executable.getParameterAnnotations()
emc
parents: 18775
diff changeset
   542
     * @see java.lang.reflect.Parameter#getAnnotations
e2815bcfacf0 6962494: Update documentation on Executable.getParameterAnnotations()
emc
parents: 18775
diff changeset
   543
     * @return an array of arrays that represent the annotations on
e2815bcfacf0 6962494: Update documentation on Executable.getParameterAnnotations()
emc
parents: 18775
diff changeset
   544
     *    the formal and implicit parameters, in declaration order, of
e2815bcfacf0 6962494: Update documentation on Executable.getParameterAnnotations()
emc
parents: 18775
diff changeset
   545
     *    the executable represented by this object
10127
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   546
     */
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   547
    public abstract Annotation[][] getParameterAnnotations();
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   548
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   549
    Annotation[][] sharedGetParameterAnnotations(Class<?>[] parameterTypes,
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   550
                                                 byte[] parameterAnnotations) {
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   551
        int numParameters = parameterTypes.length;
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   552
        if (parameterAnnotations == null)
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   553
            return new Annotation[numParameters][0];
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   554
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   555
        Annotation[][] result = parseParameterAnnotations(parameterAnnotations);
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   556
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   557
        if (result.length != numParameters)
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   558
            handleParameterNumberMismatch(result.length, numParameters);
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   559
        return result;
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   560
    }
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   561
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   562
    abstract void handleParameterNumberMismatch(int resultLength, int numParameters);
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   563
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   564
    /**
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   565
     * {@inheritDoc}
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   566
     * @throws NullPointerException  {@inheritDoc}
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   567
     */
10342
ca0984bc9d32 7077389: Reflection classes do not build with javac -Xlint:all -Werror
jjg
parents: 10142
diff changeset
   568
    public <T extends Annotation> T getAnnotation(Class<T> annotationClass) {
14676
985410ec95e3 7154390: Add support for repeating annotations in j.l.r.AnnotatedElement
jfranck
parents: 14342
diff changeset
   569
        Objects.requireNonNull(annotationClass);
15511
8f45487ac694 8005712: Simplify support for repeating annotations in j.l.r.AnnotatedElement
jfranck
parents: 15510
diff changeset
   570
        return annotationClass.cast(declaredAnnotations().get(annotationClass));
14676
985410ec95e3 7154390: Add support for repeating annotations in j.l.r.AnnotatedElement
jfranck
parents: 14342
diff changeset
   571
    }
10127
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   572
14676
985410ec95e3 7154390: Add support for repeating annotations in j.l.r.AnnotatedElement
jfranck
parents: 14342
diff changeset
   573
    /**
985410ec95e3 7154390: Add support for repeating annotations in j.l.r.AnnotatedElement
jfranck
parents: 14342
diff changeset
   574
     * {@inheritDoc}
985410ec95e3 7154390: Add support for repeating annotations in j.l.r.AnnotatedElement
jfranck
parents: 14342
diff changeset
   575
     * @throws NullPointerException {@inheritDoc}
985410ec95e3 7154390: Add support for repeating annotations in j.l.r.AnnotatedElement
jfranck
parents: 14342
diff changeset
   576
     */
15659
e575dab44ff5 8007278: Rename j.l.r.AnnotatedElement.getAnnotations(Class) to getAnnotationsByType(Class)
jfranck
parents: 15655
diff changeset
   577
    @Override
e575dab44ff5 8007278: Rename j.l.r.AnnotatedElement.getAnnotations(Class) to getAnnotationsByType(Class)
jfranck
parents: 15655
diff changeset
   578
    public <T extends Annotation> T[] getAnnotationsByType(Class<T> annotationClass) {
14676
985410ec95e3 7154390: Add support for repeating annotations in j.l.r.AnnotatedElement
jfranck
parents: 14342
diff changeset
   579
        Objects.requireNonNull(annotationClass);
985410ec95e3 7154390: Add support for repeating annotations in j.l.r.AnnotatedElement
jfranck
parents: 14342
diff changeset
   580
21316
ca0a7cd228c9 8004912: Repeating annotations - getAnnotationsByType(Class<T>) is not working as expected for few inheritance scenarios
alundblad
parents: 20506
diff changeset
   581
        return AnnotationSupport.getDirectlyAndIndirectlyPresent(declaredAnnotations(), annotationClass);
10127
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   582
    }
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   583
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   584
    /**
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   585
     * {@inheritDoc}
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   586
     */
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   587
    public Annotation[] getDeclaredAnnotations()  {
15511
8f45487ac694 8005712: Simplify support for repeating annotations in j.l.r.AnnotatedElement
jfranck
parents: 15510
diff changeset
   588
        return AnnotationParser.toArray(declaredAnnotations());
10127
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   589
    }
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   590
28431
a5c817e7ddb5 8068736: Avoid synchronization on Executable/Field.declaredAnnotations
redestad
parents: 27491
diff changeset
   591
    private transient volatile Map<Class<? extends Annotation>, Annotation> declaredAnnotations;
10127
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   592
28431
a5c817e7ddb5 8068736: Avoid synchronization on Executable/Field.declaredAnnotations
redestad
parents: 27491
diff changeset
   593
    private Map<Class<? extends Annotation>, Annotation> declaredAnnotations() {
a5c817e7ddb5 8068736: Avoid synchronization on Executable/Field.declaredAnnotations
redestad
parents: 27491
diff changeset
   594
        Map<Class<? extends Annotation>, Annotation> declAnnos;
a5c817e7ddb5 8068736: Avoid synchronization on Executable/Field.declaredAnnotations
redestad
parents: 27491
diff changeset
   595
        if ((declAnnos = declaredAnnotations) == null) {
a5c817e7ddb5 8068736: Avoid synchronization on Executable/Field.declaredAnnotations
redestad
parents: 27491
diff changeset
   596
            synchronized (this) {
a5c817e7ddb5 8068736: Avoid synchronization on Executable/Field.declaredAnnotations
redestad
parents: 27491
diff changeset
   597
                if ((declAnnos = declaredAnnotations) == null) {
a5c817e7ddb5 8068736: Avoid synchronization on Executable/Field.declaredAnnotations
redestad
parents: 27491
diff changeset
   598
                    Executable root = getRoot();
a5c817e7ddb5 8068736: Avoid synchronization on Executable/Field.declaredAnnotations
redestad
parents: 27491
diff changeset
   599
                    if (root != null) {
a5c817e7ddb5 8068736: Avoid synchronization on Executable/Field.declaredAnnotations
redestad
parents: 27491
diff changeset
   600
                        declAnnos = root.declaredAnnotations();
a5c817e7ddb5 8068736: Avoid synchronization on Executable/Field.declaredAnnotations
redestad
parents: 27491
diff changeset
   601
                    } else {
a5c817e7ddb5 8068736: Avoid synchronization on Executable/Field.declaredAnnotations
redestad
parents: 27491
diff changeset
   602
                        declAnnos = AnnotationParser.parseAnnotations(
a5c817e7ddb5 8068736: Avoid synchronization on Executable/Field.declaredAnnotations
redestad
parents: 27491
diff changeset
   603
                                getAnnotationBytes(),
a5c817e7ddb5 8068736: Avoid synchronization on Executable/Field.declaredAnnotations
redestad
parents: 27491
diff changeset
   604
                                sun.misc.SharedSecrets.getJavaLangAccess().
a5c817e7ddb5 8068736: Avoid synchronization on Executable/Field.declaredAnnotations
redestad
parents: 27491
diff changeset
   605
                                        getConstantPool(getDeclaringClass()),
a5c817e7ddb5 8068736: Avoid synchronization on Executable/Field.declaredAnnotations
redestad
parents: 27491
diff changeset
   606
                                getDeclaringClass()
a5c817e7ddb5 8068736: Avoid synchronization on Executable/Field.declaredAnnotations
redestad
parents: 27491
diff changeset
   607
                        );
a5c817e7ddb5 8068736: Avoid synchronization on Executable/Field.declaredAnnotations
redestad
parents: 27491
diff changeset
   608
                    }
a5c817e7ddb5 8068736: Avoid synchronization on Executable/Field.declaredAnnotations
redestad
parents: 27491
diff changeset
   609
                    declaredAnnotations = declAnnos;
a5c817e7ddb5 8068736: Avoid synchronization on Executable/Field.declaredAnnotations
redestad
parents: 27491
diff changeset
   610
                }
26455
195a6f3e0cd0 8054987: (reflect) Add sharing of annotations between instances of Executable
jfranck
parents: 25991
diff changeset
   611
            }
10127
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   612
        }
28431
a5c817e7ddb5 8068736: Avoid synchronization on Executable/Field.declaredAnnotations
redestad
parents: 27491
diff changeset
   613
        return declAnnos;
10127
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   614
    }
15294
df55735ea03c 8004729: Add java.lang.reflect.Parameter and related changes for parameter reflection
robm
parents: 14910
diff changeset
   615
16058
5b8d8cec6280 8007808: Missing method: Executable.getAnnotatedReturnType()
jfranck
parents: 15659
diff changeset
   616
    /**
20481
2735b307d256 8007072: Update Core Reflection for Type Annotations to match latest spec
jfranck
parents: 19838
diff changeset
   617
     * Returns an {@code AnnotatedType} object that represents the use of a type to
17436
79483ba40c55 8013541: Revise javadoc for Executable.getAnnotatedReturnType()
jfranck
parents: 17177
diff changeset
   618
     * specify the return type of the method/constructor represented by this
16058
5b8d8cec6280 8007808: Missing method: Executable.getAnnotatedReturnType()
jfranck
parents: 15659
diff changeset
   619
     * Executable.
5b8d8cec6280 8007808: Missing method: Executable.getAnnotatedReturnType()
jfranck
parents: 15659
diff changeset
   620
     *
20481
2735b307d256 8007072: Update Core Reflection for Type Annotations to match latest spec
jfranck
parents: 19838
diff changeset
   621
     * If this {@code Executable} object represents a constructor, the {@code
2735b307d256 8007072: Update Core Reflection for Type Annotations to match latest spec
jfranck
parents: 19838
diff changeset
   622
     * AnnotatedType} object represents the type of the constructed object.
16058
5b8d8cec6280 8007808: Missing method: Executable.getAnnotatedReturnType()
jfranck
parents: 15659
diff changeset
   623
     *
20481
2735b307d256 8007072: Update Core Reflection for Type Annotations to match latest spec
jfranck
parents: 19838
diff changeset
   624
     * If this {@code Executable} object represents a method, the {@code
2735b307d256 8007072: Update Core Reflection for Type Annotations to match latest spec
jfranck
parents: 19838
diff changeset
   625
     * AnnotatedType} object represents the use of a type to specify the return
2735b307d256 8007072: Update Core Reflection for Type Annotations to match latest spec
jfranck
parents: 19838
diff changeset
   626
     * type of the method.
16058
5b8d8cec6280 8007808: Missing method: Executable.getAnnotatedReturnType()
jfranck
parents: 15659
diff changeset
   627
     *
20481
2735b307d256 8007072: Update Core Reflection for Type Annotations to match latest spec
jfranck
parents: 19838
diff changeset
   628
     * @return an object representing the return type of the method
2735b307d256 8007072: Update Core Reflection for Type Annotations to match latest spec
jfranck
parents: 19838
diff changeset
   629
     * or constructor represented by this {@code Executable}
16058
5b8d8cec6280 8007808: Missing method: Executable.getAnnotatedReturnType()
jfranck
parents: 15659
diff changeset
   630
     */
5b8d8cec6280 8007808: Missing method: Executable.getAnnotatedReturnType()
jfranck
parents: 15659
diff changeset
   631
    public abstract AnnotatedType getAnnotatedReturnType();
15510
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   632
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   633
    /* Helper for subclasses of Executable.
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   634
     *
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   635
     * Returns an AnnotatedType object that represents the use of a type to
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   636
     * specify the return type of the method/constructor represented by this
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   637
     * Executable.
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   638
     */
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   639
    AnnotatedType getAnnotatedReturnType0(Type returnType) {
20482
6dc1f81f522c 8009719: core reflection should get type annotation data from the VM lazily
jfranck
parents: 20481
diff changeset
   640
        return TypeAnnotationParser.buildAnnotatedType(getTypeAnnotationBytes0(),
17450
0f704861915e 8007073: Implement Core Reflection for Type Annotations on parameters
jfranck
parents: 17436
diff changeset
   641
                sun.misc.SharedSecrets.getJavaLangAccess().
0f704861915e 8007073: Implement Core Reflection for Type Annotations on parameters
jfranck
parents: 17436
diff changeset
   642
                        getConstantPool(getDeclaringClass()),
0f704861915e 8007073: Implement Core Reflection for Type Annotations on parameters
jfranck
parents: 17436
diff changeset
   643
                this,
0f704861915e 8007073: Implement Core Reflection for Type Annotations on parameters
jfranck
parents: 17436
diff changeset
   644
                getDeclaringClass(),
0f704861915e 8007073: Implement Core Reflection for Type Annotations on parameters
jfranck
parents: 17436
diff changeset
   645
                returnType,
0f704861915e 8007073: Implement Core Reflection for Type Annotations on parameters
jfranck
parents: 17436
diff changeset
   646
                TypeAnnotation.TypeAnnotationTarget.METHOD_RETURN);
15510
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   647
    }
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   648
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   649
    /**
20481
2735b307d256 8007072: Update Core Reflection for Type Annotations to match latest spec
jfranck
parents: 19838
diff changeset
   650
     * Returns an {@code AnnotatedType} object that represents the use of a
2735b307d256 8007072: Update Core Reflection for Type Annotations to match latest spec
jfranck
parents: 19838
diff changeset
   651
     * type to specify the receiver type of the method/constructor represented
25982
724303cf59ba 8044629: (reflect) Constructor.getAnnotatedReceiverType() returns wrong value
jfranck
parents: 24709
diff changeset
   652
     * by this {@code Executable} object.
15510
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   653
     *
25982
724303cf59ba 8044629: (reflect) Constructor.getAnnotatedReceiverType() returns wrong value
jfranck
parents: 24709
diff changeset
   654
     * The receiver type of a method/constructor is available only if the
724303cf59ba 8044629: (reflect) Constructor.getAnnotatedReceiverType() returns wrong value
jfranck
parents: 24709
diff changeset
   655
     * method/constructor has a receiver parameter (JLS 8.4.1). If this {@code
724303cf59ba 8044629: (reflect) Constructor.getAnnotatedReceiverType() returns wrong value
jfranck
parents: 24709
diff changeset
   656
     * Executable} object <em>represents an instance method or represents a
724303cf59ba 8044629: (reflect) Constructor.getAnnotatedReceiverType() returns wrong value
jfranck
parents: 24709
diff changeset
   657
     * constructor of an inner member class</em>, and the
724303cf59ba 8044629: (reflect) Constructor.getAnnotatedReceiverType() returns wrong value
jfranck
parents: 24709
diff changeset
   658
     * method/constructor <em>either</em> has no receiver parameter or has a
724303cf59ba 8044629: (reflect) Constructor.getAnnotatedReceiverType() returns wrong value
jfranck
parents: 24709
diff changeset
   659
     * receiver parameter with no annotations on its type, then the return
724303cf59ba 8044629: (reflect) Constructor.getAnnotatedReceiverType() returns wrong value
jfranck
parents: 24709
diff changeset
   660
     * value is an {@code AnnotatedType} object representing an element with no
20481
2735b307d256 8007072: Update Core Reflection for Type Annotations to match latest spec
jfranck
parents: 19838
diff changeset
   661
     * annotations.
15510
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   662
     *
25982
724303cf59ba 8044629: (reflect) Constructor.getAnnotatedReceiverType() returns wrong value
jfranck
parents: 24709
diff changeset
   663
     * If this {@code Executable} object represents a static method or
724303cf59ba 8044629: (reflect) Constructor.getAnnotatedReceiverType() returns wrong value
jfranck
parents: 24709
diff changeset
   664
     * represents a constructor of a top level, static member, local, or
28864
6a1e63fb3fa9 8072843: Typo in the description of the j.l.r.Executable.getAnnotatedReceiverType
darcy
parents: 28431
diff changeset
   665
     * anonymous class, then the return value is null.
15510
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   666
     *
20481
2735b307d256 8007072: Update Core Reflection for Type Annotations to match latest spec
jfranck
parents: 19838
diff changeset
   667
     * @return an object representing the receiver type of the method or
25982
724303cf59ba 8044629: (reflect) Constructor.getAnnotatedReceiverType() returns wrong value
jfranck
parents: 24709
diff changeset
   668
     * constructor represented by this {@code Executable} or {@code null} if
724303cf59ba 8044629: (reflect) Constructor.getAnnotatedReceiverType() returns wrong value
jfranck
parents: 24709
diff changeset
   669
     * this {@code Executable} can not have a receiver parameter
15510
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   670
     */
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   671
    public AnnotatedType getAnnotatedReceiverType() {
20481
2735b307d256 8007072: Update Core Reflection for Type Annotations to match latest spec
jfranck
parents: 19838
diff changeset
   672
        if (Modifier.isStatic(this.getModifiers()))
2735b307d256 8007072: Update Core Reflection for Type Annotations to match latest spec
jfranck
parents: 19838
diff changeset
   673
            return null;
20482
6dc1f81f522c 8009719: core reflection should get type annotation data from the VM lazily
jfranck
parents: 20481
diff changeset
   674
        return TypeAnnotationParser.buildAnnotatedType(getTypeAnnotationBytes0(),
17450
0f704861915e 8007073: Implement Core Reflection for Type Annotations on parameters
jfranck
parents: 17436
diff changeset
   675
                sun.misc.SharedSecrets.getJavaLangAccess().
0f704861915e 8007073: Implement Core Reflection for Type Annotations on parameters
jfranck
parents: 17436
diff changeset
   676
                        getConstantPool(getDeclaringClass()),
0f704861915e 8007073: Implement Core Reflection for Type Annotations on parameters
jfranck
parents: 17436
diff changeset
   677
                this,
0f704861915e 8007073: Implement Core Reflection for Type Annotations on parameters
jfranck
parents: 17436
diff changeset
   678
                getDeclaringClass(),
0f704861915e 8007073: Implement Core Reflection for Type Annotations on parameters
jfranck
parents: 17436
diff changeset
   679
                getDeclaringClass(),
0f704861915e 8007073: Implement Core Reflection for Type Annotations on parameters
jfranck
parents: 17436
diff changeset
   680
                TypeAnnotation.TypeAnnotationTarget.METHOD_RECEIVER);
15510
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   681
    }
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   682
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   683
    /**
20481
2735b307d256 8007072: Update Core Reflection for Type Annotations to match latest spec
jfranck
parents: 19838
diff changeset
   684
     * Returns an array of {@code AnnotatedType} objects that represent the use
2735b307d256 8007072: Update Core Reflection for Type Annotations to match latest spec
jfranck
parents: 19838
diff changeset
   685
     * of types to specify formal parameter types of the method/constructor
15510
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   686
     * represented by this Executable. The order of the objects in the array
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   687
     * corresponds to the order of the formal parameter types in the
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   688
     * declaration of the method/constructor.
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   689
     *
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   690
     * Returns an array of length 0 if the method/constructor declares no
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   691
     * parameters.
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   692
     *
18546
862067c6481c 8017550: Fix doclint issues in java.lang and subpackages
darcy
parents: 17450
diff changeset
   693
     * @return an array of objects representing the types of the
20481
2735b307d256 8007072: Update Core Reflection for Type Annotations to match latest spec
jfranck
parents: 19838
diff changeset
   694
     * formal parameters of the method or constructor represented by this
2735b307d256 8007072: Update Core Reflection for Type Annotations to match latest spec
jfranck
parents: 19838
diff changeset
   695
     * {@code Executable}
15510
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   696
     */
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   697
    public AnnotatedType[] getAnnotatedParameterTypes() {
20482
6dc1f81f522c 8009719: core reflection should get type annotation data from the VM lazily
jfranck
parents: 20481
diff changeset
   698
        return TypeAnnotationParser.buildAnnotatedTypes(getTypeAnnotationBytes0(),
17450
0f704861915e 8007073: Implement Core Reflection for Type Annotations on parameters
jfranck
parents: 17436
diff changeset
   699
                sun.misc.SharedSecrets.getJavaLangAccess().
0f704861915e 8007073: Implement Core Reflection for Type Annotations on parameters
jfranck
parents: 17436
diff changeset
   700
                        getConstantPool(getDeclaringClass()),
0f704861915e 8007073: Implement Core Reflection for Type Annotations on parameters
jfranck
parents: 17436
diff changeset
   701
                this,
0f704861915e 8007073: Implement Core Reflection for Type Annotations on parameters
jfranck
parents: 17436
diff changeset
   702
                getDeclaringClass(),
27491
1c0081281564 8055063: Parameter#toString() fails w/ AIOOBE for ctr of inner class w/ generic type
emc
parents: 26455
diff changeset
   703
                getAllGenericParameterTypes(),
17450
0f704861915e 8007073: Implement Core Reflection for Type Annotations on parameters
jfranck
parents: 17436
diff changeset
   704
                TypeAnnotation.TypeAnnotationTarget.METHOD_FORMAL_PARAMETER);
15510
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   705
    }
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   706
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   707
    /**
20481
2735b307d256 8007072: Update Core Reflection for Type Annotations to match latest spec
jfranck
parents: 19838
diff changeset
   708
     * Returns an array of {@code AnnotatedType} objects that represent the use
2735b307d256 8007072: Update Core Reflection for Type Annotations to match latest spec
jfranck
parents: 19838
diff changeset
   709
     * of types to specify the declared exceptions of the method/constructor
15510
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   710
     * represented by this Executable. The order of the objects in the array
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   711
     * corresponds to the order of the exception types in the declaration of
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   712
     * the method/constructor.
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   713
     *
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   714
     * Returns an array of length 0 if the method/constructor declares no
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   715
     * exceptions.
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   716
     *
18546
862067c6481c 8017550: Fix doclint issues in java.lang and subpackages
darcy
parents: 17450
diff changeset
   717
     * @return an array of objects representing the declared
20481
2735b307d256 8007072: Update Core Reflection for Type Annotations to match latest spec
jfranck
parents: 19838
diff changeset
   718
     * exceptions of the method or constructor represented by this {@code
2735b307d256 8007072: Update Core Reflection for Type Annotations to match latest spec
jfranck
parents: 19838
diff changeset
   719
     * Executable}
15510
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   720
     */
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   721
    public AnnotatedType[] getAnnotatedExceptionTypes() {
20482
6dc1f81f522c 8009719: core reflection should get type annotation data from the VM lazily
jfranck
parents: 20481
diff changeset
   722
        return TypeAnnotationParser.buildAnnotatedTypes(getTypeAnnotationBytes0(),
17450
0f704861915e 8007073: Implement Core Reflection for Type Annotations on parameters
jfranck
parents: 17436
diff changeset
   723
                sun.misc.SharedSecrets.getJavaLangAccess().
0f704861915e 8007073: Implement Core Reflection for Type Annotations on parameters
jfranck
parents: 17436
diff changeset
   724
                        getConstantPool(getDeclaringClass()),
0f704861915e 8007073: Implement Core Reflection for Type Annotations on parameters
jfranck
parents: 17436
diff changeset
   725
                this,
0f704861915e 8007073: Implement Core Reflection for Type Annotations on parameters
jfranck
parents: 17436
diff changeset
   726
                getDeclaringClass(),
0f704861915e 8007073: Implement Core Reflection for Type Annotations on parameters
jfranck
parents: 17436
diff changeset
   727
                getGenericExceptionTypes(),
0f704861915e 8007073: Implement Core Reflection for Type Annotations on parameters
jfranck
parents: 17436
diff changeset
   728
                TypeAnnotation.TypeAnnotationTarget.THROWS);
15510
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   729
    }
898d924a7efd 8004698: Implement Core Reflection for Type Annotations
jfranck
parents: 15294
diff changeset
   730
10127
c85d1ec57ee7 7007535: (reflect) Please generalize Constructor and Method
darcy
parents:
diff changeset
   731
}