/* * Copyright (c) 1997, 2017, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation. * * This code is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License * version 2 for more details (a copy is included in the LICENSE file that * accompanied this code). * * You should have received a copy of the GNU General Public License version * 2 along with this work; if not, write to the Free Software Foundation, * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. * * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA * or visit www.oracle.com if you need additional information or have any * questions. * */ #ifndef SHARE_VM_RUNTIME_JAVACALLS_HPP #define SHARE_VM_RUNTIME_JAVACALLS_HPP #include "memory/allocation.hpp" #include "oops/method.hpp" #include "runtime/handles.hpp" #include "runtime/javaFrameAnchor.hpp" #include "runtime/thread.inline.hpp" #include "runtime/vmThread.hpp" #ifdef TARGET_ARCH_x86 # include "jniTypes_x86.hpp" #endif #ifdef TARGET_ARCH_sparc # include "jniTypes_sparc.hpp" #endif #ifdef TARGET_ARCH_zero # include "jniTypes_zero.hpp" #endif #ifdef TARGET_ARCH_arm # include "jniTypes_arm.hpp" #endif #ifdef TARGET_ARCH_ppc # include "jniTypes_ppc.hpp" #endif // A JavaCallWrapper is constructed before each JavaCall and destructed after the call. // Its purpose is to allocate/deallocate a new handle block and to save/restore the last // Java fp/sp. A pointer to the JavaCallWrapper is stored on the stack. class JavaCallWrapper: StackObj { friend class VMStructs; private: JavaThread* _thread; // the thread to which this call belongs JNIHandleBlock* _handles; // the saved handle block Method* _callee_method; // to be able to collect arguments if entry frame is top frame oop _receiver; // the receiver of the call (if a non-static call) JavaFrameAnchor _anchor; // last thread anchor state that we must restore JavaValue* _result; // result value public: // Construction/destruction JavaCallWrapper(methodHandle callee_method, Handle receiver, JavaValue* result, TRAPS); ~JavaCallWrapper(); void initialize(JavaThread* thread, JNIHandleBlock* handles, Method* callee_method, oop receiver, JavaValue* result); // Accessors JavaThread* thread() const { return _thread; } JNIHandleBlock* handles() const { return _handles; } JavaFrameAnchor* anchor(void) { return &_anchor; } JavaValue* result() const { return _result; } // GC support Method* callee_method() { return _callee_method; } oop receiver() { return _receiver; } void oops_do(OopClosure* f); bool is_first_frame() const { return _anchor.last_Java_sp() == NULL; } }; // Encapsulates arguments to a JavaCall (faster, safer, and more convenient than using var-args) class JavaCallArguments : public StackObj { private: enum Constants { _default_size = 8 // Must be at least # of arguments in JavaCalls methods }; intptr_t _value_buffer [_default_size + 1]; u_char _value_state_buffer[_default_size + 1]; intptr_t* _value; u_char* _value_state; int _size; int _max_size; bool _start_at_zero; // Support late setting of receiver void initialize() { // Starts at first element to support set_receiver. _value = &_value_buffer[1]; _value_state = &_value_state_buffer[1]; _max_size = _default_size; _size = 0; _start_at_zero = false; } // Helper for push_oop and the like. The value argument is a // "handle" that refers to an oop. We record the address of the // handle rather than the designated oop. The handle is later // resolved to the oop by parameters(). This delays the exposure of // naked oops until it is GC-safe. template inline int push_oop_impl(T handle, int size) { // JNITypes::put_obj expects an oop value, so we play fast and // loose with the type system. The cast from handle type to oop // *must* use a C-style cast. In a product build it performs a // reinterpret_cast. In a debug build (more accurately, in a // CHECK_UNHANDLED_OOPS build) it performs a static_cast, invoking // the debug-only oop class's conversion from void* constructor. JNITypes::put_obj((oop)handle, _value, size); // Updates size. return size; // Return the updated size. } public: JavaCallArguments() { initialize(); } JavaCallArguments(Handle receiver) { initialize(); push_oop(receiver); } JavaCallArguments(int max_size) { if (max_size > _default_size) { _value = NEW_RESOURCE_ARRAY(intptr_t, max_size + 1); _value_state = NEW_RESOURCE_ARRAY(u_char, max_size + 1); // Reserve room for potential receiver in value and state _value++; _value_state++; _max_size = max_size; _size = 0; _start_at_zero = false; } else { initialize(); } } // The possible values for _value_state elements. enum { value_state_primitive, value_state_oop, value_state_handle, value_state_jobject, value_state_limit }; inline void push_oop(Handle h) { _value_state[_size] = value_state_handle; _size = push_oop_impl(h.raw_value(), _size); } inline void push_jobject(jobject h) { _value_state[_size] = value_state_jobject; _size = push_oop_impl(h, _size); } inline void push_int(int i) { _value_state[_size] = value_state_primitive; JNITypes::put_int(i, _value, _size); } inline void push_double(double d) { _value_state[_size] = value_state_primitive; _value_state[_size + 1] = value_state_primitive; JNITypes::put_double(d, _value, _size); } inline void push_long(jlong l) { _value_state[_size] = value_state_primitive; _value_state[_size + 1] = value_state_primitive; JNITypes::put_long(l, _value, _size); } inline void push_float(float f) { _value_state[_size] = value_state_primitive; JNITypes::put_float(f, _value, _size); } // receiver Handle receiver() { assert(_size > 0, "must at least be one argument"); assert(_value_state[0] == value_state_handle, "first argument must be an oop"); assert(_value[0] != 0, "receiver must be not-null"); return Handle((oop*)_value[0], false); } void set_receiver(Handle h) { assert(_start_at_zero == false, "can only be called once"); _start_at_zero = true; _value_state--; _value--; _size++; _value_state[0] = value_state_handle; push_oop_impl(h.raw_value(), 0); } // Converts all Handles to oops, and returns a reference to parameter vector intptr_t* parameters() ; int size_of_parameters() const { return _size; } // Verify that pushed arguments fits a given method void verify(methodHandle method, BasicType return_type); }; // All calls to Java have to go via JavaCalls. Sets up the stack frame // and makes sure that the last_Java_frame pointers are chained correctly. // class JavaCalls: AllStatic { static void call_helper(JavaValue* result, methodHandle* method, JavaCallArguments* args, TRAPS); public: // Optimized Constuctor call static void call_default_constructor(JavaThread* thread, methodHandle method, Handle receiver, TRAPS); // call_special // ------------ // The receiver must be first oop in argument list static void call_special(JavaValue* result, KlassHandle klass, Symbol* name, Symbol* signature, JavaCallArguments* args, TRAPS); static void call_special(JavaValue* result, Handle receiver, KlassHandle klass, Symbol* name, Symbol* signature, TRAPS); // No args static void call_special(JavaValue* result, Handle receiver, KlassHandle klass, Symbol* name, Symbol* signature, Handle arg1, TRAPS); static void call_special(JavaValue* result, Handle receiver, KlassHandle klass, Symbol* name, Symbol* signature, Handle arg1, Handle arg2, TRAPS); // virtual call // ------------ // The receiver must be first oop in argument list static void call_virtual(JavaValue* result, KlassHandle spec_klass, Symbol* name, Symbol* signature, JavaCallArguments* args, TRAPS); static void call_virtual(JavaValue* result, Handle receiver, KlassHandle spec_klass, Symbol* name, Symbol* signature, TRAPS); // No args static void call_virtual(JavaValue* result, Handle receiver, KlassHandle spec_klass, Symbol* name, Symbol* signature, Handle arg1, TRAPS); static void call_virtual(JavaValue* result, Handle receiver, KlassHandle spec_klass, Symbol* name, Symbol* signature, Handle arg1, Handle arg2, TRAPS); // Static call // ----------- static void call_static(JavaValue* result, KlassHandle klass, Symbol* name, Symbol* signature, JavaCallArguments* args, TRAPS); static void call_static(JavaValue* result, KlassHandle klass, Symbol* name, Symbol* signature, TRAPS); static void call_static(JavaValue* result, KlassHandle klass, Symbol* name, Symbol* signature, Handle arg1, TRAPS); static void call_static(JavaValue* result, KlassHandle klass, Symbol* name, Symbol* signature, Handle arg1, Handle arg2, TRAPS); // Low-level interface static void call(JavaValue* result, methodHandle method, JavaCallArguments* args, TRAPS); }; #endif // SHARE_VM_RUNTIME_JAVACALLS_HPP