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

8198889: Clarify the throwing of exceptions from ConstantBootstraps.invoke

Browse source 
Reviewed-by: mchung
This commit is contained in:
Paul Sandoz 2018-03-14 12:39:57 -07:00
parent 64bf300bf6
commit 0628437ecc
1 changed files with 12 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

19
src/java.base/share/classes/java/lang/invoke/ConstantBootstraps.java
View file

@ -104,10 +104,10 @@ public final class ConstantBootstraps {
*
* @param lookup the lookup context describing the class performing the
* operation (normally stacked by the JVM)
* @param type the {@code Class} object describing the enum type for which
* a constant is to be returned
* @param name the name of the constant to return, which must exactly match
* an enum constant in the specified type.
* @param type the {@code Class} object describing the enum type for which
* a constant is to be returned
* @param <E> The enum type for which a constant value is to be returned
* @return the enum constant of the specified enum type with the
* specified name
@ -208,20 +208,25 @@ public final class ConstantBootstraps {
/**
* Returns the result of invoking a method handle with the provided
* arguments.
* <p>
* This method behaves as if the method handle to be invoked is the result
* of adapting the given method handle, via {@link MethodHandle#asType}, to
* adjust the return type to the desired type.
*
* @param lookup unused
* @param name unused
* @param type the type of the value to be returned, which must be
* @param type the desired type of the value to be returned, which must be
* compatible with the return type of the method handle
* @param handle the method handle to be invoked
* @param args the arguments to pass to the method handle, as if with
* {@link MethodHandle#invokeWithArguments}. Each argument may be
* {@code null}.
* @return the result of invoking the method handle
* @throws WrongMethodTypeException if the handle's return type cannot be
* adjusted to the desired type
* @throws ClassCastException if an argument cannot be converted by
* reference casting
* @throws WrongMethodTypeException if the handle's method type cannot be
* adjusted to take the given number of arguments, or if the handle's return
* type cannot be adjusted to the desired type
* @throws ClassCastException if an argument or the result produced by
* invoking the handle cannot be converted by reference casting
* @throws Throwable anything thrown by the method handle invocation
*/
public static Object invoke(MethodHandles.Lookup lookup, String name, Class<?> type,