1 /*
2 * Copyright (c) 1997, 2014, 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.
8 *
9 * This code is distributed in the hope that it will be useful, but WITHOUT
10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
12 * version 2 for more details (a copy is included in the LICENSE file that
13 * accompanied this code).
14 *
15 * You should have received a copy of the GNU General Public License version
16 * 2 along with this work; if not, write to the Free Software Foundation,
17 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
18 *
19 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
20 * or visit www.oracle.com if you need additional information or have any
21 * questions.
22 *
23 */
24
25 #ifndef SHARE_VM_RUNTIME_JAVACALLS_HPP
26 #define SHARE_VM_RUNTIME_JAVACALLS_HPP
27
28 #include "memory/allocation.hpp"
29 #include "oops/method.hpp"
30 #include "runtime/handles.hpp"
31 #include "runtime/javaFrameAnchor.hpp"
32 #include "runtime/thread.inline.hpp"
33 #include "runtime/vmThread.hpp"
34 #ifdef TARGET_ARCH_x86
35 # include "jniTypes_x86.hpp"
36 #endif
37 #ifdef TARGET_ARCH_sparc
38 # include "jniTypes_sparc.hpp"
39 #endif
40 #ifdef TARGET_ARCH_zero
41 # include "jniTypes_zero.hpp"
42 #endif
43 #ifdef TARGET_ARCH_arm
44 # include "jniTypes_arm.hpp"
45 #endif
46 #ifdef TARGET_ARCH_ppc
47 # include "jniTypes_ppc.hpp"
48 #endif
49 #ifdef TARGET_ARCH_aarch64
50 # include "jniTypes_aarch64.hpp"
51 #endif
52
53 // A JavaCallWrapper is constructed before each JavaCall and destructed after the call.
54 // Its purpose is to allocate/deallocate a new handle block and to save/restore the last
55 // Java fp/sp. A pointer to the JavaCallWrapper is stored on the stack.
56
57 class JavaCallWrapper: StackObj {
58 friend class VMStructs;
59 private:
60 JavaThread* _thread; // the thread to which this call belongs
61 JNIHandleBlock* _handles; // the saved handle block
62 Method* _callee_method; // to be able to collect arguments if entry frame is top frame
63 oop _receiver; // the receiver of the call (if a non-static call)
64
65 JavaFrameAnchor _anchor; // last thread anchor state that we must restore
66
67 JavaValue* _result; // result value
68
69 public:
70 // Construction/destruction
71 JavaCallWrapper(methodHandle callee_method, Handle receiver, JavaValue* result, TRAPS);
72 ~JavaCallWrapper();
73
74 // Accessors
75 JavaThread* thread() const { return _thread; }
76 JNIHandleBlock* handles() const { return _handles; }
77
78 JavaFrameAnchor* anchor(void) { return &_anchor; }
79
80 JavaValue* result() const { return _result; }
81 // GC support
82 Method* callee_method() { return _callee_method; }
83 oop receiver() { return _receiver; }
84 void oops_do(OopClosure* f);
85
86 bool is_first_frame() const { return _anchor.last_Java_sp() == NULL; }
87
88 };
89
90
91 // Encapsulates arguments to a JavaCall (faster, safer, and more convenient than using var-args)
92 class JavaCallArguments : public StackObj {
93 private:
94 enum Constants {
95 _default_size = 8 // Must be at least # of arguments in JavaCalls methods
96 };
97
98 intptr_t _value_buffer [_default_size + 1];
99 bool _is_oop_buffer[_default_size + 1];
100
101 intptr_t* _value;
102 bool* _is_oop;
103 int _size;
104 int _max_size;
105 bool _start_at_zero; // Support late setting of receiver
106
107 void initialize() {
108 // Starts at first element to support set_receiver.
109 _value = &_value_buffer[1];
110 _is_oop = &_is_oop_buffer[1];
111
112 _max_size = _default_size;
113 _size = 0;
114 _start_at_zero = false;
115 }
116
117 public:
118 JavaCallArguments() { initialize(); }
119
120 JavaCallArguments(Handle receiver) {
121 initialize();
122 push_oop(receiver);
123 }
124
125 JavaCallArguments(int max_size) {
126 if (max_size > _default_size) {
127 _value = NEW_RESOURCE_ARRAY(intptr_t, max_size + 1);
128 _is_oop = NEW_RESOURCE_ARRAY(bool, max_size + 1);
129
130 // Reserve room for potential receiver in value and is_oop
131 _value++; _is_oop++;
132
133 _max_size = max_size;
134 _size = 0;
135 _start_at_zero = false;
136 } else {
137 initialize();
138 }
139 }
140
141 inline void push_oop(Handle h) { _is_oop[_size] = true;
142 JNITypes::put_obj((oop)h.raw_value(), _value, _size); }
143
144 inline void push_int(int i) { _is_oop[_size] = false;
145 JNITypes::put_int(i, _value, _size); }
146
147 inline void push_double(double d) { _is_oop[_size] = false; _is_oop[_size + 1] = false;
148 JNITypes::put_double(d, _value, _size); }
149
150 inline void push_long(jlong l) { _is_oop[_size] = false; _is_oop[_size + 1] = false;
151 JNITypes::put_long(l, _value, _size); }
152
153 inline void push_float(float f) { _is_oop[_size] = false;
154 JNITypes::put_float(f, _value, _size); }
155
156 // receiver
157 Handle receiver() {
158 assert(_size > 0, "must at least be one argument");
159 assert(_is_oop[0], "first argument must be an oop");
160 assert(_value[0] != 0, "receiver must be not-null");
161 return Handle((oop*)_value[0], false);
162 }
163
164 void set_receiver(Handle h) {
165 assert(_start_at_zero == false, "can only be called once");
166 _start_at_zero = true;
167 _is_oop--;
168 _value--;
169 _size++;
170 _is_oop[0] = true;
171 _value[0] = (intptr_t)h.raw_value();
172 }
173
174 // Converts all Handles to oops, and returns a reference to parameter vector
175 intptr_t* parameters() ;
176 int size_of_parameters() const { return _size; }
177
178 // Verify that pushed arguments fits a given method
179 void verify(methodHandle method, BasicType return_type, Thread *thread);
180 };
181
182 // All calls to Java have to go via JavaCalls. Sets up the stack frame
183 // and makes sure that the last_Java_frame pointers are chained correctly.
184 //
185
186 class JavaCalls: AllStatic {
187 static void call_helper(JavaValue* result, methodHandle* method, JavaCallArguments* args, TRAPS);
188 public:
189 // call_special
190 // ------------
191 // The receiver must be first oop in argument list
192 static void call_special(JavaValue* result, KlassHandle klass, Symbol* name, Symbol* signature, JavaCallArguments* args, TRAPS);
193
194 static void call_special(JavaValue* result, Handle receiver, KlassHandle klass, Symbol* name, Symbol* signature, TRAPS); // No args
195 static void call_special(JavaValue* result, Handle receiver, KlassHandle klass, Symbol* name, Symbol* signature, Handle arg1, TRAPS);
196 static void call_special(JavaValue* result, Handle receiver, KlassHandle klass, Symbol* name, Symbol* signature, Handle arg1, Handle arg2, TRAPS);
197
198 // virtual call
199 // ------------
200
201 // The receiver must be first oop in argument list
202 static void call_virtual(JavaValue* result, KlassHandle spec_klass, Symbol* name, Symbol* signature, JavaCallArguments* args, TRAPS);
203
204 static void call_virtual(JavaValue* result, Handle receiver, KlassHandle spec_klass, Symbol* name, Symbol* signature, TRAPS); // No args
205 static void call_virtual(JavaValue* result, Handle receiver, KlassHandle spec_klass, Symbol* name, Symbol* signature, Handle arg1, TRAPS);
206 static void call_virtual(JavaValue* result, Handle receiver, KlassHandle spec_klass, Symbol* name, Symbol* signature, Handle arg1, Handle arg2, TRAPS);
207
208 // Static call
209 // -----------
210 static void call_static(JavaValue* result, KlassHandle klass, Symbol* name, Symbol* signature, JavaCallArguments* args, TRAPS);
211
212 static void call_static(JavaValue* result, KlassHandle klass, Symbol* name, Symbol* signature, TRAPS);
213 static void call_static(JavaValue* result, KlassHandle klass, Symbol* name, Symbol* signature, Handle arg1, TRAPS);
214 static void call_static(JavaValue* result, KlassHandle klass, Symbol* name, Symbol* signature, Handle arg1, Handle arg2, TRAPS);
215
216 // Low-level interface
217 static void call(JavaValue* result, methodHandle method, JavaCallArguments* args, TRAPS);
218 };
219
220 #endif // SHARE_VM_RUNTIME_JAVACALLS_HPP