archive/jdk
1
0
Fork 0
mirror of https://github.com/openjdk/jdk.git synced 2025-08-27 14:54:52 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

8262807: Note assumptions of core reflection modeling and parameter handling

Browse source 
Reviewed-by: rriggs
This commit is contained in:
Joe Darcy 2021-03-17 21:58:48 +00:00
parent 26234b5333
commit 99b39aadbd
4 changed files with 93 additions and 39 deletions
Download patch file Download diff file Expand all files Collapse all files

48
src/java.base/share/classes/java/lang/reflect/Executable.java
View file

@ -201,8 +201,8 @@ public abstract class Executable extends AccessibleObject
public abstract String getName();
/**
* Returns the Java language {@linkplain Modifier modifiers} for
* the executable represented by this object.
* {@return the Java language {@linkplain Modifier modifiers} for
* the executable represented by this object}
*/
public abstract int getModifiers();
@ -257,13 +257,20 @@ public abstract class Executable extends AccessibleObject
}
/**
* Returns an array of {@code Type} objects that represent the formal
* parameter types, in declaration order, of the executable represented by
* this object. Returns an array of length 0 if the
* underlying executable takes no parameters.
* Note that the constructors of some inner classes
* may have an implicitly declared parameter in addition to
* explicitly declared ones.
* Returns an array of {@code Type} objects that represent the
* formal parameter types, in declaration order, of the executable
* represented by this object. An array of length 0 is returned if the
* underlying executable takes no parameters. Note that the
* constructors of some inner classes may have an implicitly
* declared parameter in addition to explicitly declared ones.
* Also note that as a <a
* href="{@docRoot}/java.base/java/lang/reflect/package-summary.html#LanguageJvmModel">modeling
* artifact</a>, the number of returned parameters can differ
* depending on whether or not generic information is present. If
* generic information is present, only parameters explicitly
* present in the source will be returned; if generic information
* is not present, implicit and synthetic parameters may be
* returned as well.
*
* <p>If a formal parameter type is a parameterized type,
* the {@code Type} object returned for it must accurately reflect
@ -340,19 +347,17 @@ public abstract class Executable extends AccessibleObject
}
/**
* Returns an array of {@code Parameter} objects that represent
* {@return an array of {@code Parameter} objects representing
* all the parameters to the underlying executable represented by
* this object. Returns an array of length 0 if the executable
* this object} An array of length 0 is returned if the executable
* has no parameters.
*
* <p>The parameters of the underlying executable do not necessarily
* have unique names, or names that are legal identifiers in the
* Java programming language (JLS 3.8).
* Java programming language (JLS {@jls 3.8}).
*
* @throws MalformedParametersException if the class file contains
* a MethodParameters attribute that is improperly formatted.
* @return an array of {@code Parameter} objects representing all
* the parameters to the executable this object represents.
*/
public Parameter[] getParameters() {
// TODO: This may eventually need to be guarded by security
@ -492,19 +497,14 @@ public abstract class Executable extends AccessibleObject
}
/**
* Returns a string describing this {@code Executable}, including
* any type parameters.
* @return a string describing this {@code Executable}, including
* any type parameters
* {@return a string describing this {@code Executable}, including
* any type parameters}
*/
public abstract String toGenericString();
/**
* Returns {@code true} if this executable was declared to take a
* variable number of arguments; returns {@code false} otherwise.
*
* @return {@code true} if an only if this executable was declared
* to take a variable number of arguments.
* {@return {@code true} if this executable was declared to take a
* variable number of arguments; returns {@code false} otherwise}
*/
public boolean isVarArgs() {
return (getModifiers() & Modifier.VARARGS) != 0;
@ -672,7 +672,7 @@ public abstract class Executable extends AccessibleObject
* by this {@code Executable} object.
*
* The receiver type of a method/constructor is available only if the
* method/constructor has a receiver parameter (JLS 8.4.1). If this {@code
* method/constructor has a receiver parameter (JLS {@jls 8.4.1}). If this {@code
* Executable} object <em>represents an instance method or represents a
* constructor of an inner member class</em>, and the
* method/constructor <em>either</em> has no receiver parameter or has a