author | attila |
Wed, 11 Nov 2015 14:54:09 +0100 | |
changeset 33688 | 649d5d76f602 |
parent 33343 | 23abd10384a5 |
permissions | -rw-r--r-- |
16234
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
1 |
/* |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
2 |
* Copyright (c) 2010, 2013, Oracle and/or its affiliates. All rights reserved. |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
3 |
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
4 |
* |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
5 |
* This code is free software; you can redistribute it and/or modify it |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
6 |
* under the terms of the GNU General Public License version 2 only, as |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
7 |
* published by the Free Software Foundation. Oracle designates this |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
8 |
* particular file as subject to the "Classpath" exception as provided |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
9 |
* by Oracle in the LICENSE file that accompanied this code. |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
10 |
* |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
11 |
* This code is distributed in the hope that it will be useful, but WITHOUT |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
12 |
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
13 |
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
14 |
* version 2 for more details (a copy is included in the LICENSE file that |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
15 |
* accompanied this code). |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
16 |
* |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
17 |
* You should have received a copy of the GNU General Public License version |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
18 |
* 2 along with this work; if not, write to the Free Software Foundation, |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
19 |
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
20 |
* |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
21 |
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
22 |
* or visit www.oracle.com if you need additional information or have any |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
23 |
* questions. |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
24 |
*/ |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
25 |
|
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
26 |
/* |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
27 |
* This file is available under and governed by the GNU General Public |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
28 |
* License version 2 only, as published by the Free Software Foundation. |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
29 |
* However, the following notice accompanied the original version of this |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
30 |
* file, and Oracle licenses the original version of this file under the BSD |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
31 |
* license: |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
32 |
*/ |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
33 |
/* |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
34 |
Copyright 2009-2013 Attila Szegedi |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
35 |
|
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
36 |
Licensed under both the Apache License, Version 2.0 (the "Apache License") |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
37 |
and the BSD License (the "BSD License"), with licensee being free to |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
38 |
choose either of the two at their discretion. |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
39 |
|
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
40 |
You may not use this file except in compliance with either the Apache |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
41 |
License or the BSD License. |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
42 |
|
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
43 |
If you choose to use this file in compliance with the Apache License, the |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
44 |
following notice applies to you: |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
45 |
|
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
46 |
You may obtain a copy of the Apache License at |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
47 |
|
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
48 |
http://www.apache.org/licenses/LICENSE-2.0 |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
49 |
|
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
50 |
Unless required by applicable law or agreed to in writing, software |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
51 |
distributed under the License is distributed on an "AS IS" BASIS, |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
52 |
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
53 |
implied. See the License for the specific language governing |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
54 |
permissions and limitations under the License. |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
55 |
|
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
56 |
If you choose to use this file in compliance with the BSD License, the |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
57 |
following notice applies to you: |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
58 |
|
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
59 |
Redistribution and use in source and binary forms, with or without |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
60 |
modification, are permitted provided that the following conditions are |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
61 |
met: |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
62 |
* Redistributions of source code must retain the above copyright |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
63 |
notice, this list of conditions and the following disclaimer. |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
64 |
* Redistributions in binary form must reproduce the above copyright |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
65 |
notice, this list of conditions and the following disclaimer in the |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
66 |
documentation and/or other materials provided with the distribution. |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
67 |
* Neither the name of the copyright holder nor the names of |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
68 |
contributors may be used to endorse or promote products derived from |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
69 |
this software without specific prior written permission. |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
70 |
|
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
71 |
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
72 |
IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
73 |
TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
74 |
PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
75 |
BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
76 |
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
77 |
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
78 |
BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
79 |
WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
80 |
OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
81 |
ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
82 |
*/ |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
83 |
|
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
84 |
package jdk.internal.dynalink.beans; |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
85 |
|
33333 | 86 |
import java.lang.invoke.MethodHandles.Lookup; |
18876
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
87 |
import java.util.Collections; |
33688 | 88 |
import java.util.Set; |
16234
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
89 |
import jdk.internal.dynalink.DynamicLinkerFactory; |
33343
23abd10384a5
8139931: Introduce Operation objects in Dynalink instead of string encoding
attila
parents:
33339
diff
changeset
|
90 |
import jdk.internal.dynalink.StandardOperation; |
16234
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
91 |
import jdk.internal.dynalink.linker.GuardedInvocation; |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
92 |
import jdk.internal.dynalink.linker.GuardingDynamicLinker; |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
93 |
import jdk.internal.dynalink.linker.LinkRequest; |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
94 |
import jdk.internal.dynalink.linker.LinkerServices; |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
95 |
import jdk.internal.dynalink.linker.TypeBasedGuardingDynamicLinker; |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
96 |
|
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
97 |
/** |
33333 | 98 |
* A linker for ordinary Java objects. Normally used as the ultimate fallback |
99 |
* linker by the {@link DynamicLinkerFactory} so it is given the chance to link |
|
100 |
* calls to all objects that no other linker recognized. Specifically, this |
|
101 |
* linker will: |
|
16234
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
102 |
* <ul> |
33333 | 103 |
* <li>expose all public methods of form {@code setXxx()}, {@code getXxx()}, |
33343
23abd10384a5
8139931: Introduce Operation objects in Dynalink instead of string encoding
attila
parents:
33339
diff
changeset
|
104 |
* and {@code isXxx()} as property setters and getters for |
23abd10384a5
8139931: Introduce Operation objects in Dynalink instead of string encoding
attila
parents:
33339
diff
changeset
|
105 |
* {@link StandardOperation#SET_PROPERTY} and {@link StandardOperation#GET_PROPERTY} |
23abd10384a5
8139931: Introduce Operation objects in Dynalink instead of string encoding
attila
parents:
33339
diff
changeset
|
106 |
* operations;</li> |
23abd10384a5
8139931: Introduce Operation objects in Dynalink instead of string encoding
attila
parents:
33339
diff
changeset
|
107 |
* <li>expose all public methods for invocation through |
23abd10384a5
8139931: Introduce Operation objects in Dynalink instead of string encoding
attila
parents:
33339
diff
changeset
|
108 |
* {@link StandardOperation#CALL_METHOD} operation;</li> |
23abd10384a5
8139931: Introduce Operation objects in Dynalink instead of string encoding
attila
parents:
33339
diff
changeset
|
109 |
* <li>expose all public methods for retrieval for |
23abd10384a5
8139931: Introduce Operation objects in Dynalink instead of string encoding
attila
parents:
33339
diff
changeset
|
110 |
* {@link StandardOperation#GET_METHOD} operation; the methods thus retrieved |
23abd10384a5
8139931: Introduce Operation objects in Dynalink instead of string encoding
attila
parents:
33339
diff
changeset
|
111 |
* can then be invoked using {@link StandardOperation#CALL}.</li> |
33333 | 112 |
* <li>expose all public fields as properties, unless there are getters or |
113 |
* setters for the properties of the same name;</li> |
|
33343
23abd10384a5
8139931: Introduce Operation objects in Dynalink instead of string encoding
attila
parents:
33339
diff
changeset
|
114 |
* <li>expose {@link StandardOperation#GET_LENGTH}, |
23abd10384a5
8139931: Introduce Operation objects in Dynalink instead of string encoding
attila
parents:
33339
diff
changeset
|
115 |
* {@link StandardOperation#GET_ELEMENT} and {@link StandardOperation#SET_ELEMENT} |
23abd10384a5
8139931: Introduce Operation objects in Dynalink instead of string encoding
attila
parents:
33339
diff
changeset
|
116 |
* on native Java arrays, as well as {@link java.util.List} and |
23abd10384a5
8139931: Introduce Operation objects in Dynalink instead of string encoding
attila
parents:
33339
diff
changeset
|
117 |
* {@link java.util.Map} objects; ({@link StandardOperation#GET_LENGTH} works on |
23abd10384a5
8139931: Introduce Operation objects in Dynalink instead of string encoding
attila
parents:
33339
diff
changeset
|
118 |
* any {@link java.util.Collection});</li> |
16234
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
119 |
* <li>expose a virtual property named {@code length} on Java arrays;</li> |
33343
23abd10384a5
8139931: Introduce Operation objects in Dynalink instead of string encoding
attila
parents:
33339
diff
changeset
|
120 |
* <li>expose {@link StandardOperation#NEW} on instances of {@link StaticClass} |
23abd10384a5
8139931: Introduce Operation objects in Dynalink instead of string encoding
attila
parents:
33339
diff
changeset
|
121 |
* as calls to constructors, including those static class objects that represent |
23abd10384a5
8139931: Introduce Operation objects in Dynalink instead of string encoding
attila
parents:
33339
diff
changeset
|
122 |
* Java arrays (their constructors take a single {@code int} parameter |
23abd10384a5
8139931: Introduce Operation objects in Dynalink instead of string encoding
attila
parents:
33339
diff
changeset
|
123 |
* representing the length of the array to create);</li> |
33333 | 124 |
* <li>expose static methods, fields, and properties of classes in a similar |
125 |
* manner to how instance method, fields, and properties are exposed, on |
|
126 |
* {@link StaticClass} objects.</li> |
|
127 |
* <li>expose a virtual property named {@code static} on instances of |
|
128 |
* {@link java.lang.Class} to access their {@link StaticClass}.</li> |
|
16234
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
129 |
* </ul> |
33333 | 130 |
* <p><strong>Overloaded method resolution</strong> is performed automatically |
131 |
* for property setters, methods, and constructors. Additionally, manual |
|
132 |
* overloaded method selection is supported by having a call site specify a name |
|
133 |
* for a method that contains an explicit signature, i.e. |
|
33343
23abd10384a5
8139931: Introduce Operation objects in Dynalink instead of string encoding
attila
parents:
33339
diff
changeset
|
134 |
* {@code NamedMethod(GET_METHOD, "parseInt(String,int)")}. You can use |
23abd10384a5
8139931: Introduce Operation objects in Dynalink instead of string encoding
attila
parents:
33339
diff
changeset
|
135 |
* non-qualified class names in such signatures regardless of those classes' |
23abd10384a5
8139931: Introduce Operation objects in Dynalink instead of string encoding
attila
parents:
33339
diff
changeset
|
136 |
* packages, they will match any class with the same non-qualified name. You |
23abd10384a5
8139931: Introduce Operation objects in Dynalink instead of string encoding
attila
parents:
33339
diff
changeset
|
137 |
* only have to use a fully qualified class name in case non-qualified class |
23abd10384a5
8139931: Introduce Operation objects in Dynalink instead of string encoding
attila
parents:
33339
diff
changeset
|
138 |
* names would cause selection ambiguity (that is extremely rare). Overloaded |
23abd10384a5
8139931: Introduce Operation objects in Dynalink instead of string encoding
attila
parents:
33339
diff
changeset
|
139 |
* resolution for constructors is not automatic as there is no logical place to |
23abd10384a5
8139931: Introduce Operation objects in Dynalink instead of string encoding
attila
parents:
33339
diff
changeset
|
140 |
* attach that functionality to but if a language wishes to provide this |
23abd10384a5
8139931: Introduce Operation objects in Dynalink instead of string encoding
attila
parents:
33339
diff
changeset
|
141 |
* functionality, it can use {@link #getConstructorMethod(Class, String)} as a |
23abd10384a5
8139931: Introduce Operation objects in Dynalink instead of string encoding
attila
parents:
33339
diff
changeset
|
142 |
* useful building block for it.</p> |
33333 | 143 |
* <p><strong>Variable argument invocation</strong> is handled for both methods |
144 |
* and constructors.</p> |
|
145 |
* <p><strong>Caller sensitive methods</strong> can be linked as long as they |
|
146 |
* are otherwise public and link requests have call site descriptors carrying |
|
147 |
* full-strength {@link Lookup} objects and not weakened lookups or the public |
|
148 |
* lookup.</p> |
|
149 |
* <p>The class also exposes various static methods for discovery of available |
|
150 |
* property and method names on classes and class instances, as well as access |
|
151 |
* to per-class linkers using the {@link #getLinkerForClass(Class)} |
|
152 |
* method.</p> |
|
16234
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
153 |
*/ |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
154 |
public class BeansLinker implements GuardingDynamicLinker { |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
155 |
private static final ClassValue<TypeBasedGuardingDynamicLinker> linkers = new ClassValue<TypeBasedGuardingDynamicLinker>() { |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
156 |
@Override |
24778
2ff5d7041566
8044638: Tidy up Nashorn codebase for code standards
attila
parents:
18876
diff
changeset
|
157 |
protected TypeBasedGuardingDynamicLinker computeValue(final Class<?> clazz) { |
16234
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
158 |
// If ClassValue.put() were public, we could just pre-populate with these known mappings... |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
159 |
return |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
160 |
clazz == Class.class ? new ClassLinker() : |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
161 |
clazz == StaticClass.class ? new StaticClassLinker() : |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
162 |
DynamicMethod.class.isAssignableFrom(clazz) ? new DynamicMethodLinker() : |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
163 |
new BeanLinker(clazz); |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
164 |
} |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
165 |
}; |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
166 |
|
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
167 |
/** |
33333 | 168 |
* Creates a new beans linker. |
16234
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
169 |
*/ |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
170 |
public BeansLinker() { |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
171 |
} |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
172 |
|
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
173 |
/** |
33333 | 174 |
* Returns a bean linker for a particular single class. Useful when you need |
175 |
* to override or extend the behavior of linking for some classes in your |
|
176 |
* language runtime's linker, but still want to delegate to the default |
|
177 |
* behavior in some cases. |
|
16234
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
178 |
* @param clazz the class |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
179 |
* @return a bean linker for that class |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
180 |
*/ |
24778
2ff5d7041566
8044638: Tidy up Nashorn codebase for code standards
attila
parents:
18876
diff
changeset
|
181 |
public static TypeBasedGuardingDynamicLinker getLinkerForClass(final Class<?> clazz) { |
16234
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
182 |
return linkers.get(clazz); |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
183 |
} |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
184 |
|
16252
3bfe9b68a0fa
8008648: Lazy JIT scope and callee semantics bugfixes. Broke out wallclock timer.
lagergren
parents:
16246
diff
changeset
|
185 |
/** |
33333 | 186 |
* Returns true if the object is a Java dynamic method (e.g., one |
33343
23abd10384a5
8139931: Introduce Operation objects in Dynalink instead of string encoding
attila
parents:
33339
diff
changeset
|
187 |
* obtained through a {@code GET_METHOD} operation on a Java object or |
33333 | 188 |
* {@link StaticClass} or through |
189 |
* {@link #getConstructorMethod(Class, String)}. |
|
16246
f60e04200be3
8008387: Improve code coverage tests for JSObjectLinker and NashornBottomLinker
sundar
parents:
16245
diff
changeset
|
190 |
* |
33333 | 191 |
* @param obj the object we want to test for being a Java dynamic method. |
16246
f60e04200be3
8008387: Improve code coverage tests for JSObjectLinker and NashornBottomLinker
sundar
parents:
16245
diff
changeset
|
192 |
* @return true if it is a dynamic method, false otherwise. |
f60e04200be3
8008387: Improve code coverage tests for JSObjectLinker and NashornBottomLinker
sundar
parents:
16245
diff
changeset
|
193 |
*/ |
f60e04200be3
8008387: Improve code coverage tests for JSObjectLinker and NashornBottomLinker
sundar
parents:
16245
diff
changeset
|
194 |
public static boolean isDynamicMethod(final Object obj) { |
f60e04200be3
8008387: Improve code coverage tests for JSObjectLinker and NashornBottomLinker
sundar
parents:
16245
diff
changeset
|
195 |
return obj instanceof DynamicMethod; |
f60e04200be3
8008387: Improve code coverage tests for JSObjectLinker and NashornBottomLinker
sundar
parents:
16245
diff
changeset
|
196 |
} |
f60e04200be3
8008387: Improve code coverage tests for JSObjectLinker and NashornBottomLinker
sundar
parents:
16245
diff
changeset
|
197 |
|
18876
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
198 |
/** |
33333 | 199 |
* Returns true if the object is a Java constructor (obtained through |
200 |
* {@link #getConstructorMethod(Class, String)}}. |
|
25252
e8bfc909db53
8043232: Index selection of overloaded java new constructors
sundar
parents:
24778
diff
changeset
|
201 |
* |
33333 | 202 |
* @param obj the object we want to test for being a Java constructor. |
25252
e8bfc909db53
8043232: Index selection of overloaded java new constructors
sundar
parents:
24778
diff
changeset
|
203 |
* @return true if it is a constructor, false otherwise. |
e8bfc909db53
8043232: Index selection of overloaded java new constructors
sundar
parents:
24778
diff
changeset
|
204 |
*/ |
e8bfc909db53
8043232: Index selection of overloaded java new constructors
sundar
parents:
24778
diff
changeset
|
205 |
public static boolean isDynamicConstructor(final Object obj) { |
e8bfc909db53
8043232: Index selection of overloaded java new constructors
sundar
parents:
24778
diff
changeset
|
206 |
return obj instanceof DynamicMethod && ((DynamicMethod)obj).isConstructor(); |
e8bfc909db53
8043232: Index selection of overloaded java new constructors
sundar
parents:
24778
diff
changeset
|
207 |
} |
e8bfc909db53
8043232: Index selection of overloaded java new constructors
sundar
parents:
24778
diff
changeset
|
208 |
|
e8bfc909db53
8043232: Index selection of overloaded java new constructors
sundar
parents:
24778
diff
changeset
|
209 |
/** |
33333 | 210 |
* Return the dynamic method of constructor of the given class and the given |
211 |
* signature. This method is useful for exposing a functionality for |
|
212 |
* selecting an overloaded constructor based on an explicit signature, as |
|
213 |
* this functionality is not otherwise exposed by Dynalink as |
|
214 |
* {@link StaticClass} objects act as overloaded constructors without |
|
33339 | 215 |
* explicit signature selection. Example usage would be: |
216 |
* {@code getConstructorMethod(java.awt.Color.class, "int, int, int")}. |
|
25252
e8bfc909db53
8043232: Index selection of overloaded java new constructors
sundar
parents:
24778
diff
changeset
|
217 |
* @param clazz the class |
33339 | 218 |
* @param signature full signature of the constructor. Note how you can use |
219 |
* names of primitive types, array names with normal Java notation (e.g. |
|
220 |
* {@code "int[]"}), and normally you can even use unqualified class names |
|
221 |
* (e.g. {@code "String, List"} instead of |
|
222 |
* {@code "java.lang.String, java.util.List"} as long as they don't cause |
|
223 |
* ambiguity in the specific parameter position. |
|
224 |
* @return dynamic method for the constructor or null if no constructor with |
|
225 |
* the specified signature exists. |
|
25252
e8bfc909db53
8043232: Index selection of overloaded java new constructors
sundar
parents:
24778
diff
changeset
|
226 |
*/ |
e8bfc909db53
8043232: Index selection of overloaded java new constructors
sundar
parents:
24778
diff
changeset
|
227 |
public static Object getConstructorMethod(final Class<?> clazz, final String signature) { |
e8bfc909db53
8043232: Index selection of overloaded java new constructors
sundar
parents:
24778
diff
changeset
|
228 |
return StaticClassLinker.getConstructorMethod(clazz, signature); |
e8bfc909db53
8043232: Index selection of overloaded java new constructors
sundar
parents:
24778
diff
changeset
|
229 |
} |
e8bfc909db53
8043232: Index selection of overloaded java new constructors
sundar
parents:
24778
diff
changeset
|
230 |
|
e8bfc909db53
8043232: Index selection of overloaded java new constructors
sundar
parents:
24778
diff
changeset
|
231 |
/** |
33688 | 232 |
* Returns a set of names of all readable instance properties of a class. |
18876
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
233 |
* @param clazz the class |
33688 | 234 |
* @return a set of names of all readable instance properties of a class. |
18876
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
235 |
*/ |
33688 | 236 |
public static Set<String> getReadableInstancePropertyNames(final Class<?> clazz) { |
24778
2ff5d7041566
8044638: Tidy up Nashorn codebase for code standards
attila
parents:
18876
diff
changeset
|
237 |
final TypeBasedGuardingDynamicLinker linker = getLinkerForClass(clazz); |
18876
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
238 |
if(linker instanceof BeanLinker) { |
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
239 |
return ((BeanLinker)linker).getReadablePropertyNames(); |
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
240 |
} |
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
241 |
return Collections.emptySet(); |
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
242 |
} |
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
243 |
|
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
244 |
/** |
33688 | 245 |
* Returns a set of names of all writable instance properties of a class. |
18876
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
246 |
* @param clazz the class |
33688 | 247 |
* @return a set of names of all writable instance properties of a class. |
18876
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
248 |
*/ |
33688 | 249 |
public static Set<String> getWritableInstancePropertyNames(final Class<?> clazz) { |
24778
2ff5d7041566
8044638: Tidy up Nashorn codebase for code standards
attila
parents:
18876
diff
changeset
|
250 |
final TypeBasedGuardingDynamicLinker linker = getLinkerForClass(clazz); |
18876
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
251 |
if(linker instanceof BeanLinker) { |
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
252 |
return ((BeanLinker)linker).getWritablePropertyNames(); |
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
253 |
} |
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
254 |
return Collections.emptySet(); |
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
255 |
} |
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
256 |
|
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
257 |
/** |
33688 | 258 |
* Returns a set of names of all instance methods of a class. |
18876
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
259 |
* @param clazz the class |
33688 | 260 |
* @return a set of names of all instance methods of a class. |
18876
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
261 |
*/ |
33688 | 262 |
public static Set<String> getInstanceMethodNames(final Class<?> clazz) { |
24778
2ff5d7041566
8044638: Tidy up Nashorn codebase for code standards
attila
parents:
18876
diff
changeset
|
263 |
final TypeBasedGuardingDynamicLinker linker = getLinkerForClass(clazz); |
18876
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
264 |
if(linker instanceof BeanLinker) { |
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
265 |
return ((BeanLinker)linker).getMethodNames(); |
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
266 |
} |
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
267 |
return Collections.emptySet(); |
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
268 |
} |
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
269 |
|
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
270 |
/** |
33688 | 271 |
* Returns a set of names of all readable static properties of a class. |
18876
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
272 |
* @param clazz the class |
33688 | 273 |
* @return a set of names of all readable static properties of a class. |
18876
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
274 |
*/ |
33688 | 275 |
public static Set<String> getReadableStaticPropertyNames(final Class<?> clazz) { |
18876
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
276 |
return StaticClassLinker.getReadableStaticPropertyNames(clazz); |
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
277 |
} |
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
278 |
|
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
279 |
/** |
33688 | 280 |
* Returns a set of names of all writable static properties of a class. |
18876
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
281 |
* @param clazz the class |
33688 | 282 |
* @return a set of names of all writable static properties of a class. |
18876
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
283 |
*/ |
33688 | 284 |
public static Set<String> getWritableStaticPropertyNames(final Class<?> clazz) { |
18876
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
285 |
return StaticClassLinker.getWritableStaticPropertyNames(clazz); |
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
286 |
} |
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
287 |
|
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
288 |
/** |
33688 | 289 |
* Returns a set of names of all static methods of a class. |
18876
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
290 |
* @param clazz the class |
33688 | 291 |
* @return a set of names of all static methods of a class. |
18876
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
292 |
*/ |
33688 | 293 |
public static Set<String> getStaticMethodNames(final Class<?> clazz) { |
18876
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
294 |
return StaticClassLinker.getStaticMethodNames(clazz); |
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
295 |
} |
ada98218aaae
8020324: Implement Object.bindProperties(target, source) for beans
attila
parents:
16267
diff
changeset
|
296 |
|
16234
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
297 |
@Override |
24778
2ff5d7041566
8044638: Tidy up Nashorn codebase for code standards
attila
parents:
18876
diff
changeset
|
298 |
public GuardedInvocation getGuardedInvocation(final LinkRequest request, final LinkerServices linkerServices) |
16234
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
299 |
throws Exception { |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
300 |
final Object receiver = request.getReceiver(); |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
301 |
if(receiver == null) { |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
302 |
// Can't operate on null |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
303 |
return null; |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
304 |
} |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
305 |
return getLinkerForClass(receiver.getClass()).getGuardedInvocation(request, linkerServices); |
86cb162cec6c
8008085: Integrate Dynalink source code into Nashorn codebase
attila
parents:
diff
changeset
|
306 |
} |
16245
6a1c6c8bc113
8008371: Fix Dynalink compiler warnings and whitespace
attila
parents:
16234
diff
changeset
|
307 |
} |