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

Thu, 21 Feb 2013 16:57:21 +0100

author
lagergren
date
Thu, 21 Feb 2013 16:57:21 +0100
changeset 108
a971adb68f38
parent 102
4738de1bd57f
child 123
071e859b371e
permissions
-rw-r--r--

8008648: Lazy JIT scope and callee semantics bugfixes. Broke out wallclock timer.
Reviewed-by: attila, hannesw

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.beans.BeanInfo;
attila@90 87 import java.lang.invoke.MethodHandles;
attila@90 88 import jdk.internal.dynalink.CallSiteDescriptor;
attila@90 89 import jdk.internal.dynalink.DynamicLinkerFactory;
attila@90 90 import jdk.internal.dynalink.linker.GuardedInvocation;
attila@90 91 import jdk.internal.dynalink.linker.GuardingDynamicLinker;
attila@90 92 import jdk.internal.dynalink.linker.LinkRequest;
attila@90 93 import jdk.internal.dynalink.linker.LinkerServices;
attila@90 94 import jdk.internal.dynalink.linker.TypeBasedGuardingDynamicLinker;
attila@90 95
attila@90 96 /**
attila@90 97 * A linker for POJOs. Normally used as the ultimate fallback linker by the {@link DynamicLinkerFactory} so it is given
attila@90 98 * the chance to link calls to all objects that no other language runtime recognizes. Specifically, this linker will:
attila@90 99 * <ul>
attila@90 100 * <li>expose all public methods of form {@code setXxx()}, {@code getXxx()}, and {@code isXxx()} as property setters and
attila@90 101 * getters for {@code dyn:setProp} and {@code dyn:getProp} operations;</li>
attila@90 102 * <li>expose all property getters and setters declared by the class' {@link BeanInfo};</li>
attila@90 103 * <li>expose all public methods and methods declared by the class' {@link BeanInfo} for invocation through
attila@90 104 * {@code dyn:callMethod} operation;</li>
attila@90 105 * <li>expose all public methods and methods declared by the class' {@link BeanInfo} for retrieval for
attila@90 106 * {@code dyn:getMethod} operation; the methods thus retrieved can then be invoked using {@code dyn:call};</li>
attila@90 107 * <li>expose all public fields as properties, unless there are getters or setters for the properties of the same name;</li>
attila@90 108 * <li>expose {@code dyn:getLength}, {@code dyn:getElem} and {@code dyn:setElem} on native Java arrays, as well as
attila@90 109 * {@link java.util.List} and {@link java.util.Map} objects; ({@code dyn:getLength} works on any
attila@90 110 * {@link java.util.Collection});</li>
attila@90 111 * <li>expose a virtual property named {@code length} on Java arrays;</li>
attila@90 112 * <li>expose {@code dyn:new} on instances of {@link StaticClass} as calls to constructors, including those static class
attila@90 113 * objects that represent Java arrays (their constructors take a single {@code int} parameter representing the length of
attila@90 114 * the array to create);</li>
attila@90 115 * <li>expose static methods, fields, and properties of classes in a similar manner to how instance method, fields, and
attila@90 116 * properties are exposed, on {@link StaticClass} objects.</li>
attila@90 117 * <li>expose a virtual property named {@code static} on instances of {@link java.lang.Class} to access their
attila@90 118 * {@link StaticClass}.</li>
attila@90 119 * </ul>
attila@90 120 * <p><strong>Overloaded method resolution</strong> is performed automatically for property setters, methods, and
attila@90 121 * constructors. Additionally, manual overloaded method selection is supported by having a call site specify a name for
attila@90 122 * a method that contains an explicit signature, i.e. {@code dyn:getMethod:parseInt(String,int)}. You can use
attila@90 123 * non-qualified class names in such signatures regardless of those classes' packages, they will match any class with
attila@90 124 * the same non-qualified name. You only have to use a fully qualified class name in case non-qualified class names
attila@90 125 * would cause selection ambiguity (that is extremely rare).</p>
attila@90 126 * <p><strong>Variable argument invocation</strong> is handled for both methods and constructors.</p>
attila@90 127 * <p>Currently, only public fields and methods are supported. Any Lookup objects passed in the
attila@90 128 * {@link LinkRequest}s are ignored and {@link MethodHandles#publicLookup()} is used instead.</p>
attila@90 129 *
attila@90 130 * @author Attila Szegedi
attila@90 131 */
attila@90 132 public class BeansLinker implements GuardingDynamicLinker {
attila@90 133 private static final ClassValue<TypeBasedGuardingDynamicLinker> linkers = new ClassValue<TypeBasedGuardingDynamicLinker>() {
attila@90 134 @Override
attila@90 135 protected TypeBasedGuardingDynamicLinker computeValue(Class<?> clazz) {
attila@90 136 // If ClassValue.put() were public, we could just pre-populate with these known mappings...
attila@90 137 return
attila@90 138 clazz == Class.class ? new ClassLinker() :
attila@90 139 clazz == StaticClass.class ? new StaticClassLinker() :
attila@90 140 DynamicMethod.class.isAssignableFrom(clazz) ? new DynamicMethodLinker() :
attila@90 141 new BeanLinker(clazz);
attila@90 142 }
attila@90 143 };
attila@90 144
attila@90 145 /**
attila@90 146 * Creates a new POJO linker.
attila@90 147 */
attila@90 148 public BeansLinker() {
attila@90 149 }
attila@90 150
attila@90 151 /**
attila@90 152 * Returns a bean linker for a particular single class. Useful when you need to override or extend the behavior of
attila@90 153 * linking for some classes in your language runtime's linker, but still want to delegate to the default behavior in
attila@90 154 * some cases.
attila@90 155 * @param clazz the class
attila@90 156 * @return a bean linker for that class
attila@90 157 */
attila@90 158 public static TypeBasedGuardingDynamicLinker getLinkerForClass(Class<?> clazz) {
attila@90 159 return linkers.get(clazz);
attila@90 160 }
attila@90 161
lagergren@108 162 /**
sundar@102 163 * Returns true if the object is a Dynalink Java dynamic method.
sundar@102 164 *
sundar@102 165 * @param obj the object we want to test for being a dynamic method
sundar@102 166 * @return true if it is a dynamic method, false otherwise.
sundar@102 167 */
sundar@102 168 public static boolean isDynamicMethod(final Object obj) {
sundar@102 169 return obj instanceof DynamicMethod;
sundar@102 170 }
sundar@102 171
attila@90 172 @Override
attila@90 173 public GuardedInvocation getGuardedInvocation(LinkRequest request, final LinkerServices linkerServices)
attila@90 174 throws Exception {
attila@90 175 final CallSiteDescriptor callSiteDescriptor = request.getCallSiteDescriptor();
attila@90 176 final int l = callSiteDescriptor.getNameTokenCount();
attila@90 177 // All names conforming to the dynalang MOP should have at least two tokens, the first one being "dyn"
attila@90 178 if(l < 2 || "dyn" != callSiteDescriptor.getNameToken(CallSiteDescriptor.SCHEME)) {
attila@90 179 return null;
attila@90 180 }
attila@90 181
attila@90 182 final Object receiver = request.getReceiver();
attila@90 183 if(receiver == null) {
attila@90 184 // Can't operate on null
attila@90 185 return null;
attila@90 186 }
attila@90 187 return getLinkerForClass(receiver.getClass()).getGuardedInvocation(request, linkerServices);
attila@90 188 }
attila@101 189 }

mercurial