jdk/dynalink/TypeConverterFactory.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
185      * @param factories the {@link GuardingTypeConverterFactory} instances to compose.
188      * conversions to a method handle, it still needs to effect
192      * However, sometimes language runtimes will want to customize even those conversions for their own call
197      * is invoked, the custom language conversions will already have been applied to the method handle, so by
199      * only be ones that can be subjected to method invocation conversions. Can be null, in which case no
218      * Similar to {@link MethodHandle#asType(MethodType)} except it also hooks in method handles produced by
275         // Give change to automatic conversion strategy, if one is present.
297      * will succeed at runtime (notably, if the "from" or "to" types are sufficiently generic), but returning false
301      * @param to the target type for the conversion
304     boolean canConvert(final Class<?> from, final Class<?> to) {
305         return canAutoConvert(from, to) || canConvert.get(from).get(to);
309      * Determines which of the two type conversions from a source type to the two target types is preferred. This is
310      * used for dynamic overloaded method resolution. If the source type is convertible to exactly one target type with
336      * Determines whether it's safe to perform an automatic conversion between the source and target class.
339      * @param toType convert to this class
340      * @return true if it's safe to let MethodHandles.convertArguments() to handle this conversion.
366      * if you have a piece of your program that is written in Java, and you need to reuse existing type conversion
368      * @param sourceType the type to convert from
369      * @param targetType the type to convert to
387                 // Something held on to this supplier and tried to invoke it
421         // lookup, so we must presume the created converter is sensitive to the