dynalink/beans/SingleDynamicMethod.java

8  * particular file as subject to the "Classpath" exception as provided
18  * 2 along with this work; if not, write to the Free Software Foundation,
37    and the BSD License (the "BSD License"), with licensee being free to
43    If you choose to use this file in compliance with the Apache License, the
44    following notice applies to you:
50        Unless required by applicable law or agreed to in writing, software
56    If you choose to use this file in compliance with the BSD License, the
57    following notice applies to you:
68          contributors may be used to endorse or promote products derived from
97  * Base class for dynamic methods that dispatch to a single target Java method or constructor. Handles adaptation of the
98  * target method to a call site type (including mapping variable arity methods to a call site signature with different
121      * Given a specified call site descriptor, returns a method handle to this method's target. The target
124      * @param desc the call site descriptor to use.
125      * @return the handle to this method's target method.
160      * Given a method handle and a call site type, adapts the method handle to the call site type. Performs type
162      * collector, matches it to the arity of the call site. The type of the return value is only changed if it can be
165      * @param target the method handle to adapt
187                 // If vararg, add a zero-length array of the expected type as the last argument to signify no variable
210                 // to the method, introducing necessary conversions. Also, preserve it being a variable arity method.
216             // will be used when the incoming argument can't be converted to the vararg array type (the "vararg packer"
223             // Do we have a custom conversion that can potentially convert the call site type to an array?
226                 // Call site signature guarantees the argument can definitely not be converted to an array (i.e. it is
227                 // primitive), and no conversion can help with it either. Link immediately to a vararg-packing method
232             // This method handle employs language-specific conversions to convert the last argument into an array of
238             // This method handle determines whether the value can be converted to the array of vararg type using a
248             // a vararg array when it can, otherwise falls back to the vararg packer.
256                         // Yes: just pass it to the method
258                         // No: either go through a custom conversion, or if it is not possible, go directly to the
263             // Just do the custom conversion with fallback to the vararg packer logic.
273     private static boolean canConvertTo(final LinkerServices linkerServices, final Class<?> to, final Object obj) {
274         return obj == null ? false : linkerServices.canConvert(obj.getClass(), to);
280      * for which it is necessary when later passed to linkerServices.convertArguments().