stan/jdk-24
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

8278953: Clarify Class.getDeclaredConstructor specification

Browse Source 
Reviewed-by: mchung, alanb
This commit is contained in:
Joe Darcy 2021-12-21 00:25:56 +00:00
parent 8549d8b569
commit 517967284c
1 changed files with 16 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
src/java.base/share/classes/java/lang/Class.java
View File

@ -2080,6 +2080,7 @@ public final class Class<T> implements java.io.Serializable,
* s.checkPackageAccess()} denies access to the package * s.checkPackageAccess()} denies access to the package
* of this class. * of this class.
* *
* @see #getDeclaredConstructors()
* @since 1.1 * @since 1.1
*/ */
@CallerSensitive @CallerSensitive
@ -2279,7 +2280,9 @@ public final class Class<T> implements java.io.Serializable,
* @param parameterTypes the parameter array * @param parameterTypes the parameter array
* @return the {@code Constructor} object of the public constructor that * @return the {@code Constructor} object of the public constructor that
* matches the specified {@code parameterTypes} * matches the specified {@code parameterTypes}
* @throws NoSuchMethodException if a matching method is not found. * @throws NoSuchMethodException if a matching constructor is not found,
* including when this {@code Class} object represents
* an interface, a primitive type, an array class, or void.
* @throws SecurityException * @throws SecurityException
* If a security manager, <i>s</i>, is present and * If a security manager, <i>s</i>, is present and
* the caller's class loader is not the same as or an * the caller's class loader is not the same as or an
@ -2288,6 +2291,7 @@ public final class Class<T> implements java.io.Serializable,
* s.checkPackageAccess()} denies access to the package * s.checkPackageAccess()} denies access to the package
* of this class. * of this class.
* *
* @see #getDeclaredConstructor(Class<?>[])
* @since 1.1 * @since 1.1
*/ */
@CallerSensitive @CallerSensitive
@ -2536,21 +2540,20 @@ public final class Class<T> implements java.io.Serializable,
return copyMethods(privateGetDeclaredMethods(false)); return copyMethods(privateGetDeclaredMethods(false));
} }
/** /**
* Returns an array of {@code Constructor} objects reflecting all the * Returns an array of {@code Constructor} objects reflecting all the
* constructors declared by the class represented by this * constructors implicitly or explicitly declared by the class represented by this
* {@code Class} object. These are public, protected, default * {@code Class} object. These are public, protected, default
* (package) access, and private constructors. The elements in the array * (package) access, and private constructors. The elements in the array
* returned are not sorted and are not in any particular order. If the * returned are not sorted and are not in any particular order. If the
* class has a default constructor, it is included in the returned array. * class has a default constructor (JLS {@jls 8.8.9}), it is included in the returned array.
* If a record class has a canonical constructor (JLS {@jls
* 8.10.4.1}, {@jls 8.10.4.2}), it is included in the returned array.
*
* This method returns an array of length 0 if this {@code Class} * This method returns an array of length 0 if this {@code Class}
* object represents an interface, a primitive type, an array class, or * object represents an interface, a primitive type, an array class, or
* void. * void.
* *
* <p> See <cite>The Java Language Specification</cite>,
* section {@jls 8.2}.
*
* @return the array of {@code Constructor} objects representing all the * @return the array of {@code Constructor} objects representing all the
* declared constructors of this class * declared constructors of this class
* @throws SecurityException * @throws SecurityException
@ -2575,6 +2578,7 @@ public final class Class<T> implements java.io.Serializable,
* </ul> * </ul>
* *
* @since 1.1 * @since 1.1
* @see #getConstructors()
* @jls 8.8 Constructor Declarations * @jls 8.8 Constructor Declarations
*/ */
@CallerSensitive @CallerSensitive
@ -2736,7 +2740,7 @@ public final class Class<T> implements java.io.Serializable,
/** /**
* Returns a {@code Constructor} object that reflects the specified * Returns a {@code Constructor} object that reflects the specified
* constructor of the class or interface represented by this * constructor of the class represented by this
* {@code Class} object. The {@code parameterTypes} parameter is * {@code Class} object. The {@code parameterTypes} parameter is
* an array of {@code Class} objects that identify the constructor's * an array of {@code Class} objects that identify the constructor's
* formal parameter types, in declared order. * formal parameter types, in declared order.
@ -2748,7 +2752,9 @@ public final class Class<T> implements java.io.Serializable,
* @param parameterTypes the parameter array * @param parameterTypes the parameter array
* @return The {@code Constructor} object for the constructor with the * @return The {@code Constructor} object for the constructor with the
* specified parameter list * specified parameter list
* @throws NoSuchMethodException if a matching method is not found. * @throws NoSuchMethodException if a matching constructor is not found,
* including when this {@code Class} object represents
* an interface, a primitive type, an array class, or void.
* @throws SecurityException * @throws SecurityException
* If a security manager, <i>s</i>, is present and any of the * If a security manager, <i>s</i>, is present and any of the
* following conditions is met: * following conditions is met:
@ -2770,6 +2776,7 @@ public final class Class<T> implements java.io.Serializable,
* *
* </ul> * </ul>
* *
* @see #getConstructor(Class<?>[])
* @since 1.1 * @since 1.1
*/ */
@CallerSensitive @CallerSensitive