src/jdk/internal/dynalink/beans/DynamicMethod.java

Wed, 03 Jul 2013 12:39:28 +0200

author
attila
date
Wed, 03 Jul 2013 12:39:28 +0200
changeset 404
18d467e94150
parent 101
f8221ce53c2e
child 952
6d5471a497fb
child 962
ac62e33a99b0
permissions
-rw-r--r--

8010946: AccessControl.doPrivileged is broken when called from js script
Reviewed-by: jlaskey, sundar

attila@90 1 /*
attila@90 2 * Copyright (c) 2010, 2013, Oracle and/or its affiliates. All rights reserved.
attila@90 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
attila@90 4 *
attila@90 5 * This code is free software; you can redistribute it and/or modify it
attila@90 6 * under the terms of the GNU General Public License version 2 only, as
attila@90 7 * published by the Free Software Foundation. Oracle designates this
attila@90 8 * particular file as subject to the "Classpath" exception as provided
attila@90 9 * by Oracle in the LICENSE file that accompanied this code.
attila@90 10 *
attila@90 11 * This code is distributed in the hope that it will be useful, but WITHOUT
attila@90 12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
attila@90 13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
attila@90 14 * version 2 for more details (a copy is included in the LICENSE file that
attila@90 15 * accompanied this code).
attila@90 16 *
attila@90 17 * You should have received a copy of the GNU General Public License version
attila@90 18 * 2 along with this work; if not, write to the Free Software Foundation,
attila@90 19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
attila@90 20 *
attila@90 21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
attila@90 22 * or visit www.oracle.com if you need additional information or have any
attila@90 23 * questions.
attila@90 24 */
attila@90 25
attila@90 26 /*
attila@90 27 * This file is available under and governed by the GNU General Public
attila@90 28 * License version 2 only, as published by the Free Software Foundation.
attila@90 29 * However, the following notice accompanied the original version of this
attila@90 30 * file, and Oracle licenses the original version of this file under the BSD
attila@90 31 * license:
attila@90 32 */
attila@90 33 /*
attila@90 34 Copyright 2009-2013 Attila Szegedi
attila@90 35
attila@90 36 Licensed under both the Apache License, Version 2.0 (the "Apache License")
attila@90 37 and the BSD License (the "BSD License"), with licensee being free to
attila@90 38 choose either of the two at their discretion.
attila@90 39
attila@90 40 You may not use this file except in compliance with either the Apache
attila@90 41 License or the BSD License.
attila@90 42
attila@90 43 If you choose to use this file in compliance with the Apache License, the
attila@90 44 following notice applies to you:
attila@90 45
attila@90 46 You may obtain a copy of the Apache License at
attila@90 47
attila@90 48 http://www.apache.org/licenses/LICENSE-2.0
attila@90 49
attila@90 50 Unless required by applicable law or agreed to in writing, software
attila@90 51 distributed under the License is distributed on an "AS IS" BASIS,
attila@90 52 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
attila@90 53 implied. See the License for the specific language governing
attila@90 54 permissions and limitations under the License.
attila@90 55
attila@90 56 If you choose to use this file in compliance with the BSD License, the
attila@90 57 following notice applies to you:
attila@90 58
attila@90 59 Redistribution and use in source and binary forms, with or without
attila@90 60 modification, are permitted provided that the following conditions are
attila@90 61 met:
attila@90 62 * Redistributions of source code must retain the above copyright
attila@90 63 notice, this list of conditions and the following disclaimer.
attila@90 64 * Redistributions in binary form must reproduce the above copyright
attila@90 65 notice, this list of conditions and the following disclaimer in the
attila@90 66 documentation and/or other materials provided with the distribution.
attila@90 67 * Neither the name of the copyright holder nor the names of
attila@90 68 contributors may be used to endorse or promote products derived from
attila@90 69 this software without specific prior written permission.
attila@90 70
attila@90 71 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
attila@90 72 IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
attila@90 73 TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
attila@90 74 PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER
attila@90 75 BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
attila@90 76 CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
attila@90 77 SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
attila@90 78 BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
attila@90 79 WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
attila@90 80 OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
attila@90 81 ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
attila@90 82 */
attila@90 83
attila@90 84 package jdk.internal.dynalink.beans;
attila@90 85
attila@90 86 import java.lang.invoke.MethodHandle;
attila@404 87 import jdk.internal.dynalink.CallSiteDescriptor;
attila@90 88 import jdk.internal.dynalink.linker.LinkerServices;
attila@90 89
attila@90 90 /**
attila@90 91 * Represents a single dynamic method. A "dynamic" method can be bound to a single Java method, or can be bound to all
attila@90 92 * overloaded methods of the same name on a class. Getting an invocation of a dynamic method bound to multiple
attila@90 93 * overloaded methods will perform overload resolution (actually, it will perform partial overloaded resolution at link
attila@90 94 * time, but if that fails to identify exactly one target method, it will generate a method handle that will perform the
attila@90 95 * rest of the overload resolution at invocation time for actual argument types).
attila@90 96 *
attila@90 97 * @author Attila Szegedi
attila@90 98 */
attila@90 99 abstract class DynamicMethod {
attila@90 100 private final String name;
attila@90 101
attila@90 102 DynamicMethod(String name) {
attila@90 103 this.name = name;
attila@90 104 }
attila@90 105
attila@90 106 String getName() {
attila@90 107 return name;
attila@90 108 }
attila@90 109
attila@90 110 /**
attila@90 111 * Creates an invocation for the dynamic method. If the method is overloaded, it will perform overloaded method
attila@90 112 * resolution based on the specified method type. The resulting resolution can either identify a single method to be
attila@90 113 * invoked among the overloads, or it can identify multiple ones. In the latter case, the returned method handle
attila@90 114 * will perform further overload resolution among these candidates at every invocation. If the method to be invoked
attila@90 115 * is a variable arguments (vararg) method, it will pack the extra arguments in an array before the invocation of
attila@90 116 * the underlying method if it is not already done.
attila@90 117 *
attila@404 118 * @param callSiteDescriptor the descriptor of the call site
attila@90 119 * @param linkerServices linker services. Used for language-specific type conversions.
attila@90 120 * @return an invocation suitable for calling the method from the specified call site.
attila@90 121 */
attila@404 122 abstract MethodHandle getInvocation(CallSiteDescriptor callSiteDescriptor, LinkerServices linkerServices);
attila@90 123
attila@90 124 /**
attila@404 125 * Returns a single dynamic method representing a single underlying Java method (possibly selected among several
attila@90 126 * overloads) with formal parameter types exactly matching the passed signature.
attila@90 127 * @param paramTypes the comma-separated list of requested parameter type names. The names will match both
attila@90 128 * qualified and unqualified type names.
attila@404 129 * @return a single dynamic method representing a single underlying Java method, or null if none of the Java methods
attila@90 130 * behind this dynamic method exactly match the requested parameter types.
attila@90 131 */
attila@404 132 abstract SingleDynamicMethod getMethodForExactParamTypes(String paramTypes);
attila@90 133
attila@90 134 /**
attila@404 135 * True if this dynamic method already contains a method with an identical signature as the passed in method.
attila@404 136 * @param method the method to check
attila@404 137 * @return true if it already contains an equivalent method.
attila@90 138 */
attila@404 139 abstract boolean contains(SingleDynamicMethod method);
attila@90 140
attila@90 141 static String getClassAndMethodName(Class<?> clazz, String name) {
attila@90 142 final String clazzName = clazz.getCanonicalName();
attila@90 143 return (clazzName == null ? clazz.getName() : clazzName) + "." + name;
attila@90 144 }
attila@90 145
attila@90 146 @Override
attila@90 147 public String toString() {
attila@90 148 return "[" + getClass().getName() + " " + getName() + "]";
attila@90 149 }
attila@101 150 }

mercurial