语言

MethodHandle.AsVarargsCollector(Class) 方法

定义

使 变量 arity 适配器能够接受任意数量的尾随位置参数并将其收集到数组参数中。

[Android.Runtime.Register("asVarargsCollector", "(Ljava/lang/Class;)Ljava/lang/invoke/MethodHandle;", "GetAsVarargsCollector_Ljava_lang_Class_Handler", ApiSince=26)]
public virtual Java.Lang.Invoke.MethodHandle? AsVarargsCollector(Java.Lang.Class? arrayType);
[<Android.Runtime.Register("asVarargsCollector", "(Ljava/lang/Class;)Ljava/lang/invoke/MethodHandle;", "GetAsVarargsCollector_Ljava_lang_Class_Handler", ApiSince=26)>]
abstract member AsVarargsCollector : Java.Lang.Class -> Java.Lang.Invoke.MethodHandle
override this.AsVarargsCollector : Java.Lang.Class -> Java.Lang.Invoke.MethodHandle

参数

arrayType
Class

通常 Object[],将收集参数的数组参数的类型

返回

在调用原始方法句柄之前,新方法句柄可将任意数量的尾随参数收集到数组中

特性

注解

使 变量 arity 适配器能够接受任意数量的尾随位置参数并将其收集到数组参数中。

适配器的类型和行为将与目标的类型和行为相同,但某些 invoke 和 asType 请求可能会导致将尾随位置参数收集到目标的尾随参数中。 此外,适配器的 MethodType#lastParameterType 最后一个参数类型也将是 arrayType,即使目标具有不同的最后一个参数类型。

如果方法句柄已具有可变 arity 并且其尾随参数类型与 this 相同,则此转换可能会返回arrayType。

使用 #invokeExact invokeExact 调用时,适配器将调用目标,且不更改参数。 (注意: 此行为不同于 #asCollector 固定 arity 收集器,因为它接受整个不确定长度数组,而不是固定数量的参数。

如果调用方类型与适配器相同,则调用方类型与适配器相同时,适配器会将目标调用为 <a0/>。 (这是类型匹配时的正常行为 invoke 。

否则,如果调用方和适配器 arity 相同,并且调用者的尾随参数类型与适配器的尾随参数类型相同或可赋值,则参数和返回值将成对转换,就像在 #asType asType 固定 arity 方法句柄上一样。

否则,差异不同,或者适配器的尾随参数类型无法从相应的调用方类型分配。 在这种情况下,适配器将原始尾随自变量位置中的所有尾随自变量替换为新的类型 arrayType数组,其元素构成替换的参数(按顺序排列)。

调用方类型必须至少提供足够的参数和正确的类型,以满足目标在尾随数组参数之前的位置参数的要求。 因此,调用方必须至少 N-1 提供参数,其中是 N 目标的 arity。 此外,必须存在从传入参数到目标参数的转换。 与其他使用普通 invoke一样,如果未满足这些基本要求,可能会引发 a WrongMethodTypeException 。

在所有情况下,目标最终返回的内容均由适配器保持不变。

在最后一种情况下,目标方法句柄与 #asCollector 固定 arity 收集器暂时适应调用方类型所需的 arity 一样。 (与上asCollector一样,如果数组长度为零,可以使用共享常量而不是新数组。如果隐含调用asCollector将引发或IllegalArgumentExceptionWrongMethodTypeException,则对变量 arity 适配器的调用必须引发 WrongMethodTypeException。)

该行为 #asType asType 还专用于变量 arity 适配器,为了保持纯实的固定性,inexact invoke 始终等效于 asType 调整目标类型的调用,后跟 invokeExact。 因此,变量 arity 适配器通过生成固定 arity 收集器来响应 asType 请求,前提是适配器和请求的类型在 arity 或尾随参数类型中有所不同。 生成的固定 arity 收集器按成对转换进一步调整其类型(如有必要),就像由另一个应用程序一样调整为所请求的类型 asType。

当通过执行 ldc 常量指令 CONSTANT_MethodHandle 来获取方法句柄,并且目标方法被标记为可变 arity 方法(使用修饰符位 0x0080),则方法句柄将接受多个 arities,就好像方法句柄常量是通过调用 asVarargsCollector方法创建的。

若要创建收集适配器,该适配器收集预先确定的参数数,并且其类型反映此预先确定的数字,请改用 #asCollector asCollector 。

没有方法句柄转换会生成具有可变 arity 的新方法句柄,除非它们记录为这样做。 因此,除了asVarargsCollector和,所有withVarargs方法都将MethodHandle返回具有固定 arity 的方法句柄,除非指定方法句柄返回其原始操作数(例如MethodHandles方法句asType柄自己的类型)。

调用 asVarargsCollector 已具有可变 arity 的方法句柄将生成具有相同类型和行为的方法句柄。 它可能(或不能)返回原始变量 arity 方法句柄。

下面是列表生成变量 arity 方法句柄的示例: <blockquote>

{@code
            MethodHandle deepToString = publicLookup()
              .findStatic(Arrays.class, "deepToString", methodType(String.class, Object[].class));
            MethodHandle ts1 = deepToString.asVarargsCollector(Object[].class);
            assertEquals("[won]",   (String) ts1.invokeExact(    new Object[]{"won"}));
            assertEquals("[won]",   (String) ts1.invoke(         new Object[]{"won"}));
            assertEquals("[won]",   (String) ts1.invoke(                      "won" ));
            assertEquals("[[won]]", (String) ts1.invoke((Object) new Object[]{"won"}));
            // findStatic of Arrays.asList(...) produces a variable arity method handle:
            MethodHandle asList = publicLookup()
              .findStatic(Arrays.class, "asList", methodType(List.class, Object[].class));
            assertEquals(methodType(List.class, Object[].class), asList.type());
            assert(asList.isVarargsCollector());
            assertEquals("[]", asList.invoke().toString());
            assertEquals("[1]", asList.invoke(1).toString());
            assertEquals("[two, too]", asList.invoke("two", "too").toString());
            String[] argv = { "three", "thee", "tee" };
            assertEquals("[three, thee, tee]", asList.invoke(argv).toString());
            assertEquals("[three, thee, tee]", asList.invoke((Object[])argv).toString());
            List ls = (List) asList.invoke((Object)argv);
            assertEquals(1, ls.size());
            assertEquals("[three, thee, tee]", Arrays.toString((Object[])ls.get(0)));
            }

</blockquote>

讨论:这些规则设计为变量 arity 方法Java规则的动态类型变体。 在这两种情况下,变量 arity 方法或方法句柄的调用方都可以传递零个或多个位置参数,或者传递任何长度的预收集数组。 用户应了解最终参数的特殊角色,以及类型匹配在该最终参数上的效果,这决定了单个尾随参数是解释为整个数组还是要收集的数组的单个元素。 请注意,尾随参数的动态类型对此决定没有影响,仅调用站点的符号类型描述符与方法句柄的类型描述符之间的比较。

Java文档java.lang.invoke.MethodHandle.asVarargsCollector(java.lang.Class<?>)。

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

适用于