1 /*

     2  * Copyright (c) 2015, 2017, Oracle and/or its affiliates. All rights reserved.

     3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.

     4  *

     5  * This code is free software; you can redistribute it and/or modify it

     6  * under the terms of the GNU General Public License version 2 only, as

     7  * published by the Free Software Foundation.  Oracle designates this

     8  * particular file as subject to the "Classpath" exception as provided

     9  * by Oracle in the LICENSE file that accompanied this code.

    10  *

    11  * This code is distributed in the hope that it will be useful, but WITHOUT

    12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or

    13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License

    14  * version 2 for more details (a copy is included in the LICENSE file that

    15  * accompanied this code).

    16  *

    17  * You should have received a copy of the GNU General Public License version

    18  * 2 along with this work; if not, write to the Free Software Foundation,

    19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.

    20  *

    21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA

    22  * or visit www.oracle.com if you need additional information or have any

    23  * questions.

    24  */

    25 

    26 package jdk.internal.misc;

    27 

    28 import java.lang.invoke.MethodType;

    29 import java.util.Map;

    30 

    31 public interface JavaLangInvokeAccess {

    32     /**

    33      * Create a new MemberName instance. Used by {@code StackFrameInfo}.

    34      */

    35     Object newMemberName();

    36 

    37     /**

    38      * Returns the name for the given MemberName. Used by {@code StackFrameInfo}.

    39      */

    40     String getName(Object mname);

    41 

    42     /**

    43      * Returns the {@code MethodType} for the given MemberName.

    44      * Used by {@code StackFrameInfo}.

    45      */

    46     MethodType getMethodType(Object mname);

    47 

    48     /**

    49      * Returns the descriptor for the given MemberName.

    50      * Used by {@code StackFrameInfo}.

    51      */

    52     String getMethodDescriptor(Object mname);

    53 

    54     /**

    55      * Returns {@code true} if the given MemberName is a native method.

    56      * Used by {@code StackFrameInfo}.

    57      */

    58     boolean isNative(Object mname);

    59 

    60     /**

    61      * Returns the declaring class for the given MemberName.

    62      * Used by {@code StackFrameInfo}.

    63      */

    64     Class<?> getDeclaringClass(Object mname);

    65 

    66     /**

    67      * Returns a {@code byte[]} representation of a class implementing

    68      * DirectMethodHandle of each pairwise combination of {@code MethodType} and

    69      * an {@code int} representing method type.  Used by

    70      * GenerateJLIClassesPlugin to generate such a class during the jlink phase.

    71      */

    72     byte[] generateDirectMethodHandleHolderClassBytes(String className,

    73             MethodType[] methodTypes, int[] types);

    74 

    75     /**

    76      * Returns a {@code byte[]} representation of a class implementing

    77      * DelegatingMethodHandles of each {@code MethodType} kind in the

    78      * {@code methodTypes} argument.  Used by GenerateJLIClassesPlugin to

    79      * generate such a class during the jlink phase.

    80      */

    81     byte[] generateDelegatingMethodHandleHolderClassBytes(String className,

    82             MethodType[] methodTypes);

    83 

    84     /**

    85      * Returns a {@code byte[]} representation of {@code BoundMethodHandle}

    86      * species class implementing the signature defined by {@code types}. Used

    87      * by GenerateJLIClassesPlugin to enable generation of such classes during

    88      * the jlink phase. Should do some added validation since this string may be

    89      * user provided.

    90      */

    91     Map.Entry<String, byte[]> generateConcreteBMHClassBytes(

    92             final String types);

    93 

    94     /**

    95      * Returns a {@code byte[]} representation of a class implementing

    96      * the zero and identity forms of all {@code LambdaForm.BasicType}s.

    97      */

    98     byte[] generateBasicFormsClassBytes(final String className);

    99 

   100     /**

   101      * Returns a {@code byte[]} representation of a class implementing

   102      * the invoker forms for the set of supplied {@code invokerMethodTypes}

   103      * and {@code callSiteMethodTypes}.

   104      */

   105     byte[] generateInvokersHolderClassBytes(String className,

   106             MethodType[] invokerMethodTypes,

   107             MethodType[] callSiteMethodTypes);

   108 

   109 }