src/jdk.dynalink/share/classes/jdk/dynalink/linker/MethodTypeConversionStrategy.java
author jlaskey
Thu, 21 Jun 2018 08:58:59 -0300
changeset 50695 36ca515343e0
parent 47216 71c04702a3d5
permissions -rw-r--r--
8203637: Fix Sources Reviewed-by: hannesw, sundar
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
27360
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
     1
/*
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
     2
 * Copyright (c) 2014, Oracle and/or its affiliates. All rights reserved.
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
     3
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
     4
 *
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
     5
 * This code is free software; you can redistribute it and/or modify it
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
     6
 * under the terms of the GNU General Public License version 2 only, as
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
     7
 * published by the Free Software Foundation.  Oracle designates this
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
     8
 * particular file as subject to the "Classpath" exception as provided
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
     9
 * by Oracle in the LICENSE file that accompanied this code.
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    10
 *
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    11
 * This code is distributed in the hope that it will be useful, but WITHOUT
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    12
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    13
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    14
 * version 2 for more details (a copy is included in the LICENSE file that
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    15
 * accompanied this code).
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    16
 *
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    17
 * You should have received a copy of the GNU General Public License version
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    18
 * 2 along with this work; if not, write to the Free Software Foundation,
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    19
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    20
 *
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    21
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    22
 * or visit www.oracle.com if you need additional information or have any
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    23
 * questions.
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    24
 */
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    25
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    26
/*
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    27
 * This file is available under and governed by the GNU General Public
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    28
 * License version 2 only, as published by the Free Software Foundation.
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    29
 * However, the following notice accompanied the original version of this
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    30
 * file, and Oracle licenses the original version of this file under the BSD
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    31
 * license:
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    32
 */
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    33
/*
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    34
   Copyright 2014 Attila Szegedi
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    35
50695
36ca515343e0 8203637: Fix Sources
jlaskey
parents: 47216
diff changeset
    36
   Redistribution and use in source and binary forms, with or without
36ca515343e0 8203637: Fix Sources
jlaskey
parents: 47216
diff changeset
    37
   modification, are permitted provided that the following conditions are
36ca515343e0 8203637: Fix Sources
jlaskey
parents: 47216
diff changeset
    38
   met:
36ca515343e0 8203637: Fix Sources
jlaskey
parents: 47216
diff changeset
    39
   * Redistributions of source code must retain the above copyright
36ca515343e0 8203637: Fix Sources
jlaskey
parents: 47216
diff changeset
    40
     notice, this list of conditions and the following disclaimer.
36ca515343e0 8203637: Fix Sources
jlaskey
parents: 47216
diff changeset
    41
   * Redistributions in binary form must reproduce the above copyright
36ca515343e0 8203637: Fix Sources
jlaskey
parents: 47216
diff changeset
    42
     notice, this list of conditions and the following disclaimer in the
36ca515343e0 8203637: Fix Sources
jlaskey
parents: 47216
diff changeset
    43
     documentation and/or other materials provided with the distribution.
36ca515343e0 8203637: Fix Sources
jlaskey
parents: 47216
diff changeset
    44
   * Neither the name of the copyright holder nor the names of
36ca515343e0 8203637: Fix Sources
jlaskey
parents: 47216
diff changeset
    45
     contributors may be used to endorse or promote products derived from
36ca515343e0 8203637: Fix Sources
jlaskey
parents: 47216
diff changeset
    46
     this software without specific prior written permission.
27360
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    47
50695
36ca515343e0 8203637: Fix Sources
jlaskey
parents: 47216
diff changeset
    48
   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
36ca515343e0 8203637: Fix Sources
jlaskey
parents: 47216
diff changeset
    49
   IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
36ca515343e0 8203637: Fix Sources
jlaskey
parents: 47216
diff changeset
    50
   TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
36ca515343e0 8203637: Fix Sources
jlaskey
parents: 47216
diff changeset
    51
   PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER
36ca515343e0 8203637: Fix Sources
jlaskey
parents: 47216
diff changeset
    52
   BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
36ca515343e0 8203637: Fix Sources
jlaskey
parents: 47216
diff changeset
    53
   CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
36ca515343e0 8203637: Fix Sources
jlaskey
parents: 47216
diff changeset
    54
   SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
36ca515343e0 8203637: Fix Sources
jlaskey
parents: 47216
diff changeset
    55
   BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
36ca515343e0 8203637: Fix Sources
jlaskey
parents: 47216
diff changeset
    56
   WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
36ca515343e0 8203637: Fix Sources
jlaskey
parents: 47216
diff changeset
    57
   OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
36ca515343e0 8203637: Fix Sources
jlaskey
parents: 47216
diff changeset
    58
   ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27360
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    59
*/
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    60
34447
ec4c069f9436 8141338: Move jdk.internal.dynalink package to jdk.dynalink
attila
parents: 33339
diff changeset
    61
package jdk.dynalink.linker;
27360
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    62
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    63
import java.lang.invoke.MethodHandle;
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    64
import java.lang.invoke.MethodType;
34447
ec4c069f9436 8141338: Move jdk.internal.dynalink package to jdk.dynalink
attila
parents: 33339
diff changeset
    65
import jdk.dynalink.DynamicLinkerFactory;
27360
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    66
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    67
/**
33333
0bad500ce4e0 8139590: Improve Dynalink JavaDoc
attila
parents: 27360
diff changeset
    68
 * Interface for objects representing a strategy for converting a method handle
33339
334cd3ebfa5e 8139888: Improve Dynalink JavaDoc some more
attila
parents: 33333
diff changeset
    69
 * to a new type. Typical usage is for customizing a language runtime's handling
334cd3ebfa5e 8139888: Improve Dynalink JavaDoc some more
attila
parents: 33333
diff changeset
    70
 * of
334cd3ebfa5e 8139888: Improve Dynalink JavaDoc some more
attila
parents: 33333
diff changeset
    71
 * {@link DynamicLinkerFactory#setAutoConversionStrategy(MethodTypeConversionStrategy)
334cd3ebfa5e 8139888: Improve Dynalink JavaDoc some more
attila
parents: 33333
diff changeset
    72
 * method invocation conversions}.
27360
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    73
 */
33333
0bad500ce4e0 8139590: Improve Dynalink JavaDoc
attila
parents: 27360
diff changeset
    74
@FunctionalInterface
27360
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    75
public interface MethodTypeConversionStrategy {
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    76
    /**
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    77
     * Converts a method handle to a new type.
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    78
     * @param target target method handle
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    79
     * @param newType new type
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    80
     * @return target converted to the new type.
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    81
     */
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    82
    public MethodHandle asType(final MethodHandle target, final MethodType newType);
a19c14022fa4 8059443: NPE when unboxing return values
attila
parents:
diff changeset
    83
}