1 /*
   2  * Copyright (c) 2008, 2020, 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 #include "precompiled.hpp"
  26 #include "classfile/javaClasses.inline.hpp"
  27 #include "classfile/stringTable.hpp"
  28 #include "classfile/symbolTable.hpp"
  29 #include "code/codeCache.hpp"
  30 #include "code/dependencyContext.hpp"
  31 #include "compiler/compileBroker.hpp"
  32 #include "interpreter/interpreter.hpp"
  33 #include "interpreter/oopMapCache.hpp"
  34 #include "interpreter/linkResolver.hpp"
  35 #include "memory/allocation.inline.hpp"
  36 #include "memory/oopFactory.hpp"
  37 #include "memory/resourceArea.hpp"
  38 #include "memory/universe.hpp"
  39 #include "oops/objArrayKlass.hpp"
  40 #include "oops/objArrayOop.inline.hpp"
  41 #include "oops/oop.inline.hpp"
  42 #include "oops/typeArrayOop.inline.hpp"
  43 #include "prims/methodHandles.hpp"
  44 #include "runtime/deoptimization.hpp"
  45 #include "runtime/fieldDescriptor.inline.hpp"
  46 #include "runtime/handles.inline.hpp"
  47 #include "runtime/interfaceSupport.inline.hpp"
  48 #include "runtime/javaCalls.hpp"
  49 #include "runtime/jniHandles.inline.hpp"
  50 #include "runtime/timerTrace.hpp"
  51 #include "runtime/reflection.hpp"
  52 #include "runtime/safepointVerifiers.hpp"
  53 #include "runtime/signature.hpp"
  54 #include "runtime/stubRoutines.hpp"
  55 #include "utilities/exceptions.hpp"
  56 
  57 
  58 /*
  59  * JSR 292 reference implementation: method handles
  60  * The JDK 7 reference implementation represented method handle
  61  * combinations as chains.  Each link in the chain had a "vmentry"
  62  * field which pointed at a bit of assembly code which performed
  63  * one transformation before dispatching to the next link in the chain.
  64  *
  65  * The current reference implementation pushes almost all code generation
  66  * responsibility to (trusted) Java code.  A method handle contains a
  67  * pointer to its "LambdaForm", which embodies all details of the method
  68  * handle's behavior.  The LambdaForm is a normal Java object, managed
  69  * by a runtime coded in Java.
  70  */
  71 
  72 bool MethodHandles::_enabled = false; // set true after successful native linkage
  73 MethodHandlesAdapterBlob* MethodHandles::_adapter_code = NULL;
  74 
  75 /**
  76  * Generates method handle adapters. Returns 'false' if memory allocation
  77  * failed and true otherwise.
  78  */
  79 void MethodHandles::generate_adapters() {
  80   assert(SystemDictionary::MethodHandle_klass() != NULL, "should be present");
  81   assert(_adapter_code == NULL, "generate only once");
  82 
  83   ResourceMark rm;
  84   TraceTime timer("MethodHandles adapters generation", TRACETIME_LOG(Info, startuptime));
  85   _adapter_code = MethodHandlesAdapterBlob::create(adapter_code_size);
  86   CodeBuffer code(_adapter_code);
  87   MethodHandlesAdapterGenerator g(&code);
  88   g.generate();
  89   code.log_section_sizes("MethodHandlesAdapterBlob");
  90 }
  91 
  92 //------------------------------------------------------------------------------
  93 // MethodHandlesAdapterGenerator::generate
  94 //
  95 void MethodHandlesAdapterGenerator::generate() {
  96   // Generate generic method handle adapters.
  97   // Generate interpreter entries
  98   for (Interpreter::MethodKind mk = Interpreter::method_handle_invoke_FIRST;
  99        mk <= Interpreter::method_handle_invoke_LAST;
 100        mk = Interpreter::MethodKind(1 + (int)mk)) {
 101     vmIntrinsics::ID iid = Interpreter::method_handle_intrinsic(mk);
 102     StubCodeMark mark(this, "MethodHandle::interpreter_entry", vmIntrinsics::name_at(iid));
 103     address entry = MethodHandles::generate_method_handle_interpreter_entry(_masm, iid);
 104     if (entry != NULL) {
 105       Interpreter::set_entry_for_kind(mk, entry);
 106     }
 107     // If the entry is not set, it will throw AbstractMethodError.
 108   }
 109 }
 110 
 111 void MethodHandles::set_enabled(bool z) {
 112   if (_enabled != z) {
 113     guarantee(z, "can only enable once");
 114     _enabled = z;
 115   }
 116 }
 117 
 118 // MemberName support
 119 
 120 // import java_lang_invoke_MemberName.*
 121 enum {
 122   IS_METHOD            = java_lang_invoke_MemberName::MN_IS_METHOD,
 123   IS_CONSTRUCTOR       = java_lang_invoke_MemberName::MN_IS_CONSTRUCTOR,
 124   IS_FIELD             = java_lang_invoke_MemberName::MN_IS_FIELD,
 125   IS_TYPE              = java_lang_invoke_MemberName::MN_IS_TYPE,
 126   CALLER_SENSITIVE     = java_lang_invoke_MemberName::MN_CALLER_SENSITIVE,
 127   REFERENCE_KIND_SHIFT = java_lang_invoke_MemberName::MN_REFERENCE_KIND_SHIFT,
 128   REFERENCE_KIND_MASK  = java_lang_invoke_MemberName::MN_REFERENCE_KIND_MASK,
 129   SEARCH_SUPERCLASSES  = java_lang_invoke_MemberName::MN_SEARCH_SUPERCLASSES,
 130   SEARCH_INTERFACES    = java_lang_invoke_MemberName::MN_SEARCH_INTERFACES,
 131   ALL_KINDS      = IS_METHOD | IS_CONSTRUCTOR | IS_FIELD | IS_TYPE
 132 };
 133 
 134 int MethodHandles::ref_kind_to_flags(int ref_kind) {
 135   assert(ref_kind_is_valid(ref_kind), "%d", ref_kind);
 136   int flags = (ref_kind << REFERENCE_KIND_SHIFT);
 137   if (ref_kind_is_field(ref_kind)) {
 138     flags |= IS_FIELD;
 139   } else if (ref_kind_is_method(ref_kind)) {
 140     flags |= IS_METHOD;
 141   } else if (ref_kind == JVM_REF_newInvokeSpecial) {
 142     flags |= IS_CONSTRUCTOR;
 143   }
 144   return flags;
 145 }
 146 
 147 Handle MethodHandles::resolve_MemberName_type(Handle mname, Klass* caller, TRAPS) {
 148   Handle empty;
 149   Handle type(THREAD, java_lang_invoke_MemberName::type(mname()));
 150   if (!java_lang_String::is_instance_inlined(type())) {
 151     return type; // already resolved
 152   }
 153   Symbol* signature = java_lang_String::as_symbol_or_null(type());
 154   if (signature == NULL) {
 155     return empty;  // no such signature exists in the VM
 156   }
 157   Handle resolved;
 158   int flags = java_lang_invoke_MemberName::flags(mname());
 159   switch (flags & ALL_KINDS) {
 160     case IS_METHOD:
 161     case IS_CONSTRUCTOR:
 162       resolved = SystemDictionary::find_method_handle_type(signature, caller, CHECK_(empty));
 163       break;
 164     case IS_FIELD:
 165       resolved = SystemDictionary::find_field_handle_type(signature, caller, CHECK_(empty));
 166       break;
 167     default:
 168       THROW_MSG_(vmSymbols::java_lang_InternalError(), "unrecognized MemberName format", empty);
 169   }
 170   if (resolved.is_null()) {
 171     THROW_MSG_(vmSymbols::java_lang_InternalError(), "bad MemberName type", empty);
 172   }
 173   return resolved;
 174 }
 175 
 176 oop MethodHandles::init_MemberName(Handle mname, Handle target, TRAPS) {
 177   // This method is used from java.lang.invoke.MemberName constructors.
 178   // It fills in the new MemberName from a java.lang.reflect.Member.
 179   Thread* thread = Thread::current();
 180   oop target_oop = target();
 181   Klass* target_klass = target_oop->klass();
 182   if (target_klass == SystemDictionary::reflect_Field_klass()) {
 183     oop clazz = java_lang_reflect_Field::clazz(target_oop); // fd.field_holder()
 184     int slot  = java_lang_reflect_Field::slot(target_oop);  // fd.index()
 185     Klass* k = java_lang_Class::as_Klass(clazz);
 186     if (k != NULL && k->is_instance_klass()) {
 187       fieldDescriptor fd(InstanceKlass::cast(k), slot);
 188       oop mname2 = init_field_MemberName(mname, fd);
 189       if (mname2 != NULL) {
 190         // Since we have the reified name and type handy, add them to the result.
 191         if (java_lang_invoke_MemberName::name(mname2) == NULL)
 192           java_lang_invoke_MemberName::set_name(mname2, java_lang_reflect_Field::name(target_oop));
 193         if (java_lang_invoke_MemberName::type(mname2) == NULL)
 194           java_lang_invoke_MemberName::set_type(mname2, java_lang_reflect_Field::type(target_oop));
 195       }
 196       return mname2;
 197     }
 198   } else if (target_klass == SystemDictionary::reflect_Method_klass()) {
 199     oop clazz  = java_lang_reflect_Method::clazz(target_oop);
 200     int slot   = java_lang_reflect_Method::slot(target_oop);
 201     Klass* k = java_lang_Class::as_Klass(clazz);
 202     if (k != NULL && k->is_instance_klass()) {
 203       Method* m = InstanceKlass::cast(k)->method_with_idnum(slot);
 204       if (m == NULL || is_signature_polymorphic(m->intrinsic_id()))
 205         return NULL;            // do not resolve unless there is a concrete signature
 206       CallInfo info(m, k, CHECK_NULL);
 207       return init_method_MemberName(mname, info);
 208     }
 209   } else if (target_klass == SystemDictionary::reflect_Constructor_klass()) {
 210     oop clazz  = java_lang_reflect_Constructor::clazz(target_oop);
 211     int slot   = java_lang_reflect_Constructor::slot(target_oop);
 212     Klass* k = java_lang_Class::as_Klass(clazz);
 213     if (k != NULL && k->is_instance_klass()) {
 214       Method* m = InstanceKlass::cast(k)->method_with_idnum(slot);
 215       if (m == NULL)  return NULL;
 216       CallInfo info(m, k, CHECK_NULL);
 217       return init_method_MemberName(mname, info);
 218     }
 219   }
 220   return NULL;
 221 }
 222 
 223 oop MethodHandles::init_method_MemberName(Handle mname, CallInfo& info) {
 224   assert(info.resolved_appendix().is_null(), "only normal methods here");
 225   methodHandle m(Thread::current(), info.resolved_method());
 226   assert(m.not_null(), "null method handle");
 227   InstanceKlass* m_klass = m->method_holder();
 228   assert(m_klass != NULL, "null holder for method handle");
 229   int flags = (jushort)( m->access_flags().as_short() & JVM_RECOGNIZED_METHOD_MODIFIERS );
 230   int vmindex = Method::invalid_vtable_index;
 231 
 232   switch (info.call_kind()) {
 233   case CallInfo::itable_call:
 234     vmindex = info.itable_index();
 235     // More importantly, the itable index only works with the method holder.
 236     assert(m_klass->verify_itable_index(vmindex), "");
 237     flags |= IS_METHOD | (JVM_REF_invokeInterface << REFERENCE_KIND_SHIFT);
 238     if (TraceInvokeDynamic) {
 239       ttyLocker ttyl;
 240       ResourceMark rm;
 241       tty->print_cr("memberName: invokeinterface method_holder::method: %s, itableindex: %d, access_flags:",
 242             Method::name_and_sig_as_C_string(m->method_holder(), m->name(), m->signature()),
 243             vmindex);
 244        m->access_flags().print_on(tty);
 245        if (!m->is_abstract()) {
 246          if (!m->is_private()) {
 247            tty->print("default");
 248          }
 249          else {
 250            tty->print("private-intf");
 251          }
 252        }
 253        tty->cr();
 254     }
 255     break;
 256 
 257   case CallInfo::vtable_call:
 258     vmindex = info.vtable_index();
 259     flags |= IS_METHOD | (JVM_REF_invokeVirtual << REFERENCE_KIND_SHIFT);
 260     assert(info.resolved_klass()->is_subtype_of(m_klass), "virtual call must be type-safe");
 261     if (m_klass->is_interface()) {
 262       // This is a vtable call to an interface method (abstract "miranda method" or default method).
 263       // The vtable index is meaningless without a class (not interface) receiver type, so get one.
 264       // (LinkResolver should help us figure this out.)
 265       assert(info.resolved_klass()->is_instance_klass(), "subtype of interface must be an instance klass");
 266       InstanceKlass* m_klass_non_interface = InstanceKlass::cast(info.resolved_klass());
 267       if (m_klass_non_interface->is_interface()) {
 268         m_klass_non_interface = SystemDictionary::Object_klass();
 269 #ifdef ASSERT
 270         { ResourceMark rm;
 271           Method* m2 = m_klass_non_interface->vtable().method_at(vmindex);
 272           assert(m->name() == m2->name() && m->signature() == m2->signature(),
 273                  "at %d, %s != %s", vmindex,
 274                  m->name_and_sig_as_C_string(), m2->name_and_sig_as_C_string());
 275         }
 276 #endif //ASSERT
 277       }
 278       if (!m->is_public()) {
 279         assert(m->is_public(), "virtual call must be to public interface method");
 280         return NULL;  // elicit an error later in product build
 281       }
 282       assert(info.resolved_klass()->is_subtype_of(m_klass_non_interface), "virtual call must be type-safe");
 283       m_klass = m_klass_non_interface;
 284     }
 285     if (TraceInvokeDynamic) {
 286       ttyLocker ttyl;
 287       ResourceMark rm;
 288       tty->print_cr("memberName: invokevirtual method_holder::method: %s, receiver: %s, vtableindex: %d, access_flags:",
 289             Method::name_and_sig_as_C_string(m->method_holder(), m->name(), m->signature()),
 290             m_klass->internal_name(), vmindex);
 291        m->access_flags().print_on(tty);
 292        if (m->is_default_method()) {
 293          tty->print("default");
 294        }
 295        tty->cr();
 296     }
 297     break;
 298 
 299   case CallInfo::direct_call:
 300     vmindex = Method::nonvirtual_vtable_index;
 301     if (m->is_static()) {
 302       flags |= IS_METHOD      | (JVM_REF_invokeStatic  << REFERENCE_KIND_SHIFT);
 303     } else if (m->is_initializer()) {
 304       flags |= IS_CONSTRUCTOR | (JVM_REF_invokeSpecial << REFERENCE_KIND_SHIFT);
 305     } else {
 306       // "special" reflects that this is a direct call, not that it
 307       // necessarily originates from an invokespecial. We can also do
 308       // direct calls for private and/or final non-static methods.
 309       flags |= IS_METHOD      | (JVM_REF_invokeSpecial << REFERENCE_KIND_SHIFT);
 310     }
 311     break;
 312 
 313   default:  assert(false, "bad CallInfo");  return NULL;
 314   }
 315 
 316   // @CallerSensitive annotation detected
 317   if (m->caller_sensitive()) {
 318     flags |= CALLER_SENSITIVE;
 319   }
 320 
 321   Handle resolved_method = info.resolved_method_name();
 322   assert(java_lang_invoke_ResolvedMethodName::vmtarget(resolved_method()) == m() || m->is_old(),
 323          "Should not change after link resolution");
 324 
 325   oop mname_oop = mname();
 326   java_lang_invoke_MemberName::set_flags  (mname_oop, flags);
 327   java_lang_invoke_MemberName::set_method (mname_oop, resolved_method());
 328   java_lang_invoke_MemberName::set_vmindex(mname_oop, vmindex);   // vtable/itable index
 329   java_lang_invoke_MemberName::set_clazz  (mname_oop, m_klass->java_mirror());
 330   // Note:  name and type can be lazily computed by resolve_MemberName,
 331   // if Java code needs them as resolved String and MethodType objects.
 332   // If relevant, the vtable or itable value is stored as vmindex.
 333   // This is done eagerly, since it is readily available without
 334   // constructing any new objects.
 335   return mname();
 336 }
 337 
 338 oop MethodHandles::init_field_MemberName(Handle mname, fieldDescriptor& fd, bool is_setter) {
 339   int flags = (jushort)( fd.access_flags().as_short() & JVM_RECOGNIZED_FIELD_MODIFIERS );
 340   flags |= IS_FIELD | ((fd.is_static() ? JVM_REF_getStatic : JVM_REF_getField) << REFERENCE_KIND_SHIFT);
 341   if (is_setter)  flags += ((JVM_REF_putField - JVM_REF_getField) << REFERENCE_KIND_SHIFT);
 342   int vmindex        = fd.offset();  // determines the field uniquely when combined with static bit
 343 
 344   oop mname_oop = mname();
 345   java_lang_invoke_MemberName::set_flags  (mname_oop, flags);
 346   java_lang_invoke_MemberName::set_method (mname_oop, NULL);
 347   java_lang_invoke_MemberName::set_vmindex(mname_oop, vmindex);
 348   java_lang_invoke_MemberName::set_clazz  (mname_oop, fd.field_holder()->java_mirror());
 349 
 350   oop type = field_signature_type_or_null(fd.signature());
 351   oop name = field_name_or_null(fd.name());
 352   if (name != NULL)
 353     java_lang_invoke_MemberName::set_name(mname_oop,   name);
 354   if (type != NULL)
 355     java_lang_invoke_MemberName::set_type(mname_oop,   type);
 356   // Note:  name and type can be lazily computed by resolve_MemberName,
 357   // if Java code needs them as resolved String and Class objects.
 358   // Note that the incoming type oop might be pre-resolved (non-null).
 359   // The base clazz and field offset (vmindex) must be eagerly stored,
 360   // because they unambiguously identify the field.
 361   // Although the fieldDescriptor::_index would also identify the field,
 362   // we do not use it, because it is harder to decode.
 363   // TO DO: maybe intern mname_oop
 364   return mname();
 365 }
 366 
 367 // JVM 2.9 Special Methods:
 368 // A method is signature polymorphic if and only if all of the following conditions hold :
 369 // * It is declared in the java.lang.invoke.MethodHandle/VarHandle classes.
 370 // * It has a single formal parameter of type Object[].
 371 // * It has a return type of Object for a polymorphic return type, otherwise a fixed return type.
 372 // * It has the ACC_VARARGS and ACC_NATIVE flags set.
 373 bool MethodHandles::is_method_handle_invoke_name(Klass* klass, Symbol* name) {
 374   if (klass == NULL)
 375     return false;
 376   // The following test will fail spuriously during bootstrap of MethodHandle itself:
 377   //    if (klass != SystemDictionary::MethodHandle_klass())
 378   // Test the name instead:
 379   if (klass->name() != vmSymbols::java_lang_invoke_MethodHandle() &&
 380       klass->name() != vmSymbols::java_lang_invoke_VarHandle()) {
 381     return false;
 382   }
 383 
 384   // Look up signature polymorphic method with polymorphic return type
 385   Symbol* poly_sig = vmSymbols::object_array_object_signature();
 386   InstanceKlass* iklass = InstanceKlass::cast(klass);
 387   Method* m = iklass->find_method(name, poly_sig);
 388   if (m != NULL) {
 389     int required = JVM_ACC_NATIVE | JVM_ACC_VARARGS;
 390     int flags = m->access_flags().as_int();
 391     if ((flags & required) == required) {
 392       return true;
 393     }
 394   }
 395 
 396   // Look up signature polymorphic method with non-polymorphic (non Object) return type
 397   int me;
 398   int ms = iklass->find_method_by_name(name, &me);
 399   if (ms == -1) return false;
 400   for (; ms < me; ms++) {
 401     Method* m = iklass->methods()->at(ms);
 402     int required = JVM_ACC_NATIVE | JVM_ACC_VARARGS;
 403     int flags = m->access_flags().as_int();
 404     if ((flags & required) == required && ArgumentCount(m->signature()).size() == 1) {
 405       return true;
 406     }
 407   }
 408   return false;
 409 }
 410 
 411 
 412 Symbol* MethodHandles::signature_polymorphic_intrinsic_name(vmIntrinsics::ID iid) {
 413   assert(is_signature_polymorphic_intrinsic(iid), "%d %s", iid, vmIntrinsics::name_at(iid));
 414   switch (iid) {
 415   case vmIntrinsics::_invokeBasic:      return vmSymbols::invokeBasic_name();
 416   case vmIntrinsics::_linkToVirtual:    return vmSymbols::linkToVirtual_name();
 417   case vmIntrinsics::_linkToStatic:     return vmSymbols::linkToStatic_name();
 418   case vmIntrinsics::_linkToSpecial:    return vmSymbols::linkToSpecial_name();
 419   case vmIntrinsics::_linkToInterface:  return vmSymbols::linkToInterface_name();
 420   default:
 421     fatal("unexpected intrinsic id: %d %s", iid, vmIntrinsics::name_at(iid));
 422     return 0;
 423   }
 424 }
 425 
 426 Bytecodes::Code MethodHandles::signature_polymorphic_intrinsic_bytecode(vmIntrinsics::ID id) {
 427   switch(id) {
 428     case vmIntrinsics::_linkToVirtual:   return Bytecodes::_invokevirtual;
 429     case vmIntrinsics::_linkToInterface: return Bytecodes::_invokeinterface;
 430     case vmIntrinsics::_linkToStatic:    return Bytecodes::_invokestatic;
 431     case vmIntrinsics::_linkToSpecial:   return Bytecodes::_invokespecial;
 432     case vmIntrinsics::_invokeBasic:     return Bytecodes::_invokehandle;
 433     default:
 434       fatal("unexpected id: (%d) %s", (uint)id, vmIntrinsics::name_at(id));
 435       return Bytecodes::_illegal;
 436   }
 437 }
 438 
 439 int MethodHandles::signature_polymorphic_intrinsic_ref_kind(vmIntrinsics::ID iid) {
 440   switch (iid) {
 441   case vmIntrinsics::_invokeBasic:      return 0;
 442   case vmIntrinsics::_linkToVirtual:    return JVM_REF_invokeVirtual;
 443   case vmIntrinsics::_linkToStatic:     return JVM_REF_invokeStatic;
 444   case vmIntrinsics::_linkToSpecial:    return JVM_REF_invokeSpecial;
 445   case vmIntrinsics::_linkToInterface:  return JVM_REF_invokeInterface;
 446   default:
 447     fatal("unexpected intrinsic id: %d %s", iid, vmIntrinsics::name_at(iid));
 448     return 0;
 449   }
 450 }
 451 
 452 vmIntrinsics::ID MethodHandles::signature_polymorphic_name_id(Symbol* name) {
 453   vmSymbols::SID name_id = vmSymbols::find_sid(name);
 454   switch (name_id) {
 455   // The ID _invokeGeneric stands for all non-static signature-polymorphic methods, except built-ins.
 456   case vmSymbols::VM_SYMBOL_ENUM_NAME(invoke_name):           return vmIntrinsics::_invokeGeneric;
 457   // The only built-in non-static signature-polymorphic method is MethodHandle.invokeBasic:
 458   case vmSymbols::VM_SYMBOL_ENUM_NAME(invokeBasic_name):      return vmIntrinsics::_invokeBasic;
 459 
 460   // There is one static signature-polymorphic method for each JVM invocation mode.
 461   case vmSymbols::VM_SYMBOL_ENUM_NAME(linkToVirtual_name):    return vmIntrinsics::_linkToVirtual;
 462   case vmSymbols::VM_SYMBOL_ENUM_NAME(linkToStatic_name):     return vmIntrinsics::_linkToStatic;
 463   case vmSymbols::VM_SYMBOL_ENUM_NAME(linkToSpecial_name):    return vmIntrinsics::_linkToSpecial;
 464   case vmSymbols::VM_SYMBOL_ENUM_NAME(linkToInterface_name):  return vmIntrinsics::_linkToInterface;
 465   default:                                                    break;
 466   }
 467 
 468   // Cover the case of invokeExact and any future variants of invokeFoo.
 469   Klass* mh_klass = SystemDictionary::well_known_klass(
 470                               SystemDictionary::WK_KLASS_ENUM_NAME(MethodHandle_klass) );
 471   if (mh_klass != NULL && is_method_handle_invoke_name(mh_klass, name)) {
 472     return vmIntrinsics::_invokeGeneric;
 473   }
 474 
 475   // Cover the case of methods on VarHandle.
 476   Klass* vh_klass = SystemDictionary::well_known_klass(
 477                               SystemDictionary::WK_KLASS_ENUM_NAME(VarHandle_klass) );
 478   if (vh_klass != NULL && is_method_handle_invoke_name(vh_klass, name)) {
 479     return vmIntrinsics::_invokeGeneric;
 480   }
 481 
 482   // Note: The pseudo-intrinsic _compiledLambdaForm is never linked against.
 483   // Instead it is used to mark lambda forms bound to invokehandle or invokedynamic.
 484   return vmIntrinsics::_none;
 485 }
 486 
 487 vmIntrinsics::ID MethodHandles::signature_polymorphic_name_id(Klass* klass, Symbol* name) {
 488   if (klass != NULL &&
 489       (klass->name() == vmSymbols::java_lang_invoke_MethodHandle() ||
 490        klass->name() == vmSymbols::java_lang_invoke_VarHandle())) {
 491     vmIntrinsics::ID iid = signature_polymorphic_name_id(name);
 492     if (iid != vmIntrinsics::_none)
 493       return iid;
 494     if (is_method_handle_invoke_name(klass, name))
 495       return vmIntrinsics::_invokeGeneric;
 496   }
 497   return vmIntrinsics::_none;
 498 }
 499 
 500 // Returns true if method is signature polymorphic and public
 501 bool MethodHandles::is_signature_polymorphic_public_name(Klass* klass, Symbol* name) {
 502   if (is_signature_polymorphic_name(klass, name)) {
 503     InstanceKlass* iklass = InstanceKlass::cast(klass);
 504     int me;
 505     int ms = iklass->find_method_by_name(name, &me);
 506     assert(ms != -1, "");
 507     for (; ms < me; ms++) {
 508       Method* m = iklass->methods()->at(ms);
 509       int required = JVM_ACC_NATIVE | JVM_ACC_VARARGS | JVM_ACC_PUBLIC;
 510       int flags = m->access_flags().as_int();
 511       if ((flags & required) == required && ArgumentCount(m->signature()).size() == 1) {
 512         return true;
 513       }
 514     }
 515   }
 516   return false;
 517 }
 518 
 519 // convert the external string or reflective type to an internal signature
 520 Symbol* MethodHandles::lookup_signature(oop type_str, bool intern_if_not_found, TRAPS) {
 521   if (java_lang_invoke_MethodType::is_instance(type_str)) {
 522     return java_lang_invoke_MethodType::as_signature(type_str, intern_if_not_found);
 523   } else if (java_lang_Class::is_instance(type_str)) {
 524     return java_lang_Class::as_signature(type_str, false);
 525   } else if (java_lang_String::is_instance_inlined(type_str)) {
 526     if (intern_if_not_found) {
 527       return java_lang_String::as_symbol(type_str);
 528     } else {
 529       return java_lang_String::as_symbol_or_null(type_str);
 530     }
 531   } else {
 532     THROW_MSG_(vmSymbols::java_lang_InternalError(), "unrecognized type", NULL);
 533   }
 534 }
 535 
 536 static const char OBJ_SIG[] = "Ljava/lang/Object;";
 537 enum { OBJ_SIG_LEN = 18 };
 538 
 539 bool MethodHandles::is_basic_type_signature(Symbol* sig) {
 540   assert(vmSymbols::object_signature()->utf8_length() == (int)OBJ_SIG_LEN, "");
 541   assert(vmSymbols::object_signature()->equals(OBJ_SIG), "");
 542   for (SignatureStream ss(sig, sig->starts_with(JVM_SIGNATURE_FUNC)); !ss.is_done(); ss.next()) {
 543     switch (ss.type()) {
 544     case T_OBJECT:
 545       // only java/lang/Object is valid here
 546       if (strncmp((char*) ss.raw_bytes(), OBJ_SIG, OBJ_SIG_LEN) != 0)
 547         return false;
 548       break;
 549     case T_VOID:
 550     case T_INT: case T_LONG: case T_FLOAT: case T_DOUBLE:
 551       break;
 552     default:
 553       // subword types (T_BYTE etc.), Q-descriptors, arrays
 554       return false;
 555     }
 556   }
 557   return true;
 558 }
 559 
 560 Symbol* MethodHandles::lookup_basic_type_signature(Symbol* sig, bool keep_last_arg, TRAPS) {
 561   Symbol* bsig = NULL;
 562   if (sig == NULL) {
 563     return sig;
 564   } else if (is_basic_type_signature(sig)) {
 565     sig->increment_refcount();
 566     return sig;  // that was easy
 567   } else if (!sig->starts_with(JVM_SIGNATURE_FUNC)) {
 568     BasicType bt = Signature::basic_type(sig);
 569     if (is_subword_type(bt)) {
 570       bsig = vmSymbols::int_signature();
 571     } else {
 572       assert(is_reference_type(bt), "is_basic_type_signature was false");
 573       bsig = vmSymbols::object_signature();
 574     }
 575   } else {
 576     ResourceMark rm;
 577     stringStream buffer(128);
 578     buffer.put(JVM_SIGNATURE_FUNC);
 579     int arg_pos = 0, keep_arg_pos = -1;
 580     if (keep_last_arg)
 581       keep_arg_pos = ArgumentCount(sig).size() - 1;
 582     for (SignatureStream ss(sig); !ss.is_done(); ss.next()) {
 583       BasicType bt = ss.type();
 584       size_t this_arg_pos = buffer.size();
 585       if (ss.at_return_type()) {
 586         buffer.put(JVM_SIGNATURE_ENDFUNC);
 587       }
 588       if (arg_pos == keep_arg_pos) {
 589         buffer.write((char*) ss.raw_bytes(),
 590                      (int)   ss.raw_length());
 591       } else if (is_reference_type(bt)) {
 592         buffer.write(OBJ_SIG, OBJ_SIG_LEN);
 593       } else {
 594         if (is_subword_type(bt))
 595           bt = T_INT;
 596         buffer.put(type2char(bt));
 597       }
 598       arg_pos++;
 599     }
 600     const char* sigstr =       buffer.base();
 601     int         siglen = (int) buffer.size();
 602     bsig = SymbolTable::new_symbol(sigstr, siglen);
 603   }
 604   assert(is_basic_type_signature(bsig) ||
 605          // detune assert in case the injected argument is not a basic type:
 606          keep_last_arg, "");
 607   return bsig;
 608 }
 609 
 610 void MethodHandles::print_as_basic_type_signature_on(outputStream* st,
 611                                                      Symbol* sig) {
 612   st = st ? st : tty;
 613   bool prev_type = false;
 614   bool is_method = (sig->char_at(0) == JVM_SIGNATURE_FUNC);
 615   if (is_method)  st->put(JVM_SIGNATURE_FUNC);
 616   for (SignatureStream ss(sig, is_method); !ss.is_done(); ss.next()) {
 617     if (ss.at_return_type())
 618       st->put(JVM_SIGNATURE_ENDFUNC);
 619     else if (prev_type)
 620       st->put(',');
 621     const char* cp = (const char*) ss.raw_bytes();
 622     if (ss.is_array()) {
 623       st->put(JVM_SIGNATURE_ARRAY);
 624       if (ss.array_prefix_length() == 1)
 625         st->put(cp[1]);
 626       else
 627         st->put(JVM_SIGNATURE_CLASS);
 628     } else {
 629       st->put(cp[0]);
 630     }
 631   }
 632 }
 633 
 634 
 635 
 636 static oop object_java_mirror() {
 637   return SystemDictionary::Object_klass()->java_mirror();
 638 }
 639 
 640 oop MethodHandles::field_name_or_null(Symbol* s) {
 641   if (s == NULL)  return NULL;
 642   return StringTable::lookup(s);
 643 }
 644 
 645 oop MethodHandles::field_signature_type_or_null(Symbol* s) {
 646   if (s == NULL)  return NULL;
 647   BasicType bt = Signature::basic_type(s);
 648   if (is_java_primitive(bt)) {
 649     assert(s->utf8_length() == 1, "");
 650     return java_lang_Class::primitive_mirror(bt);
 651   }
 652   // Here are some more short cuts for common types.
 653   // They are optional, since reference types can be resolved lazily.
 654   if (bt == T_OBJECT) {
 655     if (s == vmSymbols::object_signature()) {
 656       return object_java_mirror();
 657     } else if (s == vmSymbols::class_signature()) {
 658       return SystemDictionary::Class_klass()->java_mirror();
 659     } else if (s == vmSymbols::string_signature()) {
 660       return SystemDictionary::String_klass()->java_mirror();
 661     }
 662   }
 663   return NULL;
 664 }
 665 
 666 
 667 // An unresolved member name is a mere symbolic reference.
 668 // Resolving it plants a vmtarget/vmindex in it,
 669 // which refers directly to JVM internals.
 670 Handle MethodHandles::resolve_MemberName(Handle mname, Klass* caller,
 671                                          bool speculative_resolve, TRAPS) {
 672   Handle empty;
 673   assert(java_lang_invoke_MemberName::is_instance(mname()), "");
 674 
 675   if (java_lang_invoke_MemberName::vmtarget(mname()) != NULL) {
 676     // Already resolved.
 677     DEBUG_ONLY(int vmindex = java_lang_invoke_MemberName::vmindex(mname()));
 678     assert(vmindex >= Method::nonvirtual_vtable_index, "");
 679     return mname;
 680   }
 681 
 682   Handle defc_oop(THREAD, java_lang_invoke_MemberName::clazz(mname()));
 683   Handle name_str(THREAD, java_lang_invoke_MemberName::name( mname()));
 684   Handle type_str(THREAD, java_lang_invoke_MemberName::type( mname()));
 685   int    flags    =       java_lang_invoke_MemberName::flags(mname());
 686   int    ref_kind =       (flags >> REFERENCE_KIND_SHIFT) & REFERENCE_KIND_MASK;
 687   if (!ref_kind_is_valid(ref_kind)) {
 688     THROW_MSG_(vmSymbols::java_lang_InternalError(), "obsolete MemberName format", empty);
 689   }
 690 
 691   DEBUG_ONLY(int old_vmindex);
 692   assert((old_vmindex = java_lang_invoke_MemberName::vmindex(mname())) == 0, "clean input");
 693 
 694   if (defc_oop.is_null() || name_str.is_null() || type_str.is_null()) {
 695     THROW_MSG_(vmSymbols::java_lang_IllegalArgumentException(), "nothing to resolve", empty);
 696   }
 697 
 698   InstanceKlass* defc = NULL;
 699   {
 700     Klass* defc_klass = java_lang_Class::as_Klass(defc_oop());
 701     if (defc_klass == NULL)  return empty;  // a primitive; no resolution possible
 702     if (!defc_klass->is_instance_klass()) {
 703       if (!defc_klass->is_array_klass())  return empty;
 704       defc_klass = SystemDictionary::Object_klass();
 705     }
 706     defc = InstanceKlass::cast(defc_klass);
 707   }
 708   if (defc == NULL) {
 709     THROW_MSG_(vmSymbols::java_lang_InternalError(), "primitive class", empty);
 710   }
 711   defc->link_class(CHECK_(empty));  // possible safepoint
 712 
 713   // convert the external string name to an internal symbol
 714   TempNewSymbol name = java_lang_String::as_symbol_or_null(name_str());
 715   if (name == NULL)  return empty;  // no such name
 716   if (name == vmSymbols::class_initializer_name())
 717     return empty; // illegal name
 718 
 719   vmIntrinsics::ID mh_invoke_id = vmIntrinsics::_none;
 720   if ((flags & ALL_KINDS) == IS_METHOD &&
 721       (defc == SystemDictionary::MethodHandle_klass() || defc == SystemDictionary::VarHandle_klass()) &&
 722       (ref_kind == JVM_REF_invokeVirtual ||
 723        ref_kind == JVM_REF_invokeSpecial ||
 724        // static invocation mode is required for _linkToVirtual, etc.:
 725        ref_kind == JVM_REF_invokeStatic)) {
 726     vmIntrinsics::ID iid = signature_polymorphic_name_id(name);
 727     if (iid != vmIntrinsics::_none &&
 728         ((ref_kind == JVM_REF_invokeStatic) == is_signature_polymorphic_static(iid))) {
 729       // Virtual methods invoke and invokeExact, plus internal invokers like _invokeBasic.
 730       // For a static reference it could an internal linkage routine like _linkToVirtual, etc.
 731       mh_invoke_id = iid;
 732     }
 733   }
 734 
 735   // convert the external string or reflective type to an internal signature
 736   TempNewSymbol type = lookup_signature(type_str(), (mh_invoke_id != vmIntrinsics::_none), CHECK_(empty));
 737   if (type == NULL)  return empty;  // no such signature exists in the VM
 738 
 739   LinkInfo::AccessCheck access_check = caller != NULL ?
 740                                               LinkInfo::needs_access_check :
 741                                               LinkInfo::skip_access_check;
 742 
 743   // Time to do the lookup.
 744   switch (flags & ALL_KINDS) {
 745   case IS_METHOD:
 746     {
 747       CallInfo result;
 748       LinkInfo link_info(defc, name, type, caller, access_check);
 749       {
 750         assert(!HAS_PENDING_EXCEPTION, "");
 751         if (ref_kind == JVM_REF_invokeStatic) {
 752           LinkResolver::resolve_static_call(result,
 753                         link_info, false, THREAD);
 754         } else if (ref_kind == JVM_REF_invokeInterface) {
 755           LinkResolver::resolve_interface_call(result, Handle(), defc,
 756                         link_info, false, THREAD);
 757         } else if (mh_invoke_id != vmIntrinsics::_none) {
 758           assert(!is_signature_polymorphic_static(mh_invoke_id), "");
 759           LinkResolver::resolve_handle_call(result, link_info, THREAD);
 760         } else if (ref_kind == JVM_REF_invokeSpecial) {
 761           LinkResolver::resolve_special_call(result, Handle(),
 762                         link_info, THREAD);
 763         } else if (ref_kind == JVM_REF_invokeVirtual) {
 764           LinkResolver::resolve_virtual_call(result, Handle(), defc,
 765                         link_info, false, THREAD);
 766         } else {
 767           assert(false, "ref_kind=%d", ref_kind);
 768         }
 769         if (HAS_PENDING_EXCEPTION) {
 770           if (speculative_resolve) {
 771             CLEAR_PENDING_EXCEPTION;
 772           }
 773           return empty;
 774         }
 775       }
 776       if (result.resolved_appendix().not_null()) {
 777         // The resolved MemberName must not be accompanied by an appendix argument,
 778         // since there is no way to bind this value into the MemberName.
 779         // Caller is responsible to prevent this from happening.
 780         THROW_MSG_(vmSymbols::java_lang_InternalError(), "appendix", empty);
 781       }
 782       result.set_resolved_method_name(CHECK_(empty));
 783       oop mname2 = init_method_MemberName(mname, result);
 784       return Handle(THREAD, mname2);
 785     }
 786   case IS_CONSTRUCTOR:
 787     {
 788       CallInfo result;
 789       LinkInfo link_info(defc, name, type, caller, access_check);
 790       {
 791         assert(!HAS_PENDING_EXCEPTION, "");
 792         if (name == vmSymbols::object_initializer_name()) {
 793           LinkResolver::resolve_special_call(result, Handle(), link_info, THREAD);
 794         } else {
 795           break;                // will throw after end of switch
 796         }
 797         if (HAS_PENDING_EXCEPTION) {
 798           if (speculative_resolve) {
 799             CLEAR_PENDING_EXCEPTION;
 800           }
 801           return empty;
 802         }
 803       }
 804       assert(result.is_statically_bound(), "");
 805       result.set_resolved_method_name(CHECK_(empty));
 806       oop mname2 = init_method_MemberName(mname, result);
 807       return Handle(THREAD, mname2);
 808     }
 809   case IS_FIELD:
 810     {
 811       fieldDescriptor result; // find_field initializes fd if found
 812       {
 813         assert(!HAS_PENDING_EXCEPTION, "");
 814         LinkInfo link_info(defc, name, type, caller, LinkInfo::skip_access_check);
 815         LinkResolver::resolve_field(result, link_info, Bytecodes::_nop, false, THREAD);
 816         if (HAS_PENDING_EXCEPTION) {
 817           if (speculative_resolve) {
 818             CLEAR_PENDING_EXCEPTION;
 819           }
 820           return empty;
 821         }
 822       }
 823       oop mname2 = init_field_MemberName(mname, result, ref_kind_is_setter(ref_kind));
 824       return Handle(THREAD, mname2);
 825     }
 826   default:
 827     THROW_MSG_(vmSymbols::java_lang_InternalError(), "unrecognized MemberName format", empty);
 828   }
 829 
 830   return empty;
 831 }
 832 
 833 // Conversely, a member name which is only initialized from JVM internals
 834 // may have null defc, name, and type fields.
 835 // Resolving it plants a vmtarget/vmindex in it,
 836 // which refers directly to JVM internals.
 837 void MethodHandles::expand_MemberName(Handle mname, int suppress, TRAPS) {
 838   assert(java_lang_invoke_MemberName::is_instance(mname()), "");
 839 
 840   bool have_defc = (java_lang_invoke_MemberName::clazz(mname()) != NULL);
 841   bool have_name = (java_lang_invoke_MemberName::name(mname()) != NULL);
 842   bool have_type = (java_lang_invoke_MemberName::type(mname()) != NULL);
 843   int flags      = java_lang_invoke_MemberName::flags(mname());
 844 
 845   if (suppress != 0) {
 846     if (suppress & _suppress_defc)  have_defc = true;
 847     if (suppress & _suppress_name)  have_name = true;
 848     if (suppress & _suppress_type)  have_type = true;
 849   }
 850 
 851   if (have_defc && have_name && have_type)  return;  // nothing needed
 852 
 853   switch (flags & ALL_KINDS) {
 854   case IS_METHOD:
 855   case IS_CONSTRUCTOR:
 856     {
 857       Method* vmtarget = java_lang_invoke_MemberName::vmtarget(mname());
 858       if (vmtarget == NULL) {
 859         THROW_MSG(vmSymbols::java_lang_IllegalArgumentException(), "nothing to expand");
 860       }
 861       methodHandle m(THREAD, vmtarget);
 862       DEBUG_ONLY(vmtarget = NULL);  // safety
 863       if (!have_defc) {
 864         InstanceKlass* defc = m->method_holder();
 865         java_lang_invoke_MemberName::set_clazz(mname(), defc->java_mirror());
 866       }
 867       if (!have_name) {
 868         //not java_lang_String::create_from_symbol; let's intern member names
 869         oop name = StringTable::intern(m->name(), CHECK);
 870         java_lang_invoke_MemberName::set_name(mname(), name);
 871       }
 872       if (!have_type) {
 873         Handle type = java_lang_String::create_from_symbol(m->signature(), CHECK);
 874         java_lang_invoke_MemberName::set_type(mname(), type());
 875       }
 876       return;
 877     }
 878   case IS_FIELD:
 879     {
 880       oop clazz = java_lang_invoke_MemberName::clazz(mname());
 881       if (clazz == NULL) {
 882         THROW_MSG(vmSymbols::java_lang_IllegalArgumentException(), "nothing to expand (as field)");
 883       }
 884       InstanceKlass* defc = InstanceKlass::cast(java_lang_Class::as_Klass(clazz));
 885       DEBUG_ONLY(clazz = NULL);  // safety
 886       int vmindex  = java_lang_invoke_MemberName::vmindex(mname());
 887       bool is_static = ((flags & JVM_ACC_STATIC) != 0);
 888       fieldDescriptor fd; // find_field initializes fd if found
 889       if (!defc->find_field_from_offset(vmindex, is_static, &fd))
 890         break;                  // cannot expand
 891       if (!have_name) {
 892         //not java_lang_String::create_from_symbol; let's intern member names
 893         oop name = StringTable::intern(fd.name(), CHECK);
 894         java_lang_invoke_MemberName::set_name(mname(), name);
 895       }
 896       if (!have_type) {
 897         // If it is a primitive field type, don't mess with short strings like "I".
 898         Handle type (THREAD, field_signature_type_or_null(fd.signature()));
 899         if (type.is_null()) {
 900           type = java_lang_String::create_from_symbol(fd.signature(), CHECK);
 901         }
 902         java_lang_invoke_MemberName::set_type(mname(), type());
 903       }
 904       return;
 905     }
 906   }
 907   THROW_MSG(vmSymbols::java_lang_InternalError(), "unrecognized MemberName format");
 908 }
 909 
 910 int MethodHandles::find_MemberNames(Klass* k,
 911                                     Symbol* name, Symbol* sig,
 912                                     int mflags, Klass* caller,
 913                                     int skip, objArrayHandle results, TRAPS) {
 914   // %%% take caller into account!
 915 
 916   Thread* thread = Thread::current();
 917 
 918   if (k == NULL || !k->is_instance_klass())  return -1;
 919 
 920   int rfill = 0, rlimit = results->length(), rskip = skip;
 921   // overflow measurement:
 922   int overflow = 0, overflow_limit = MAX2(1000, rlimit);
 923 
 924   int match_flags = mflags;
 925   bool search_superc = ((match_flags & SEARCH_SUPERCLASSES) != 0);
 926   bool search_intfc  = ((match_flags & SEARCH_INTERFACES)   != 0);
 927   bool local_only = !(search_superc | search_intfc);
 928 
 929   if (name != NULL) {
 930     if (name->utf8_length() == 0)  return 0; // a match is not possible
 931   }
 932   if (sig != NULL) {
 933     if (sig->starts_with(JVM_SIGNATURE_FUNC))
 934       match_flags &= ~(IS_FIELD | IS_TYPE);
 935     else
 936       match_flags &= ~(IS_CONSTRUCTOR | IS_METHOD);
 937   }
 938 
 939   if ((match_flags & IS_TYPE) != 0) {
 940     // NYI, and Core Reflection works quite well for this query
 941   }
 942 
 943   if ((match_flags & IS_FIELD) != 0) {
 944     InstanceKlass* ik = InstanceKlass::cast(k);
 945     for (FieldStream st(ik, local_only, !search_intfc); !st.eos(); st.next()) {
 946       if (name != NULL && st.name() != name)
 947           continue;
 948       if (sig != NULL && st.signature() != sig)
 949         continue;
 950       // passed the filters
 951       if (rskip > 0) {
 952         --rskip;
 953       } else if (rfill < rlimit) {
 954         Handle result(thread, results->obj_at(rfill++));
 955         if (!java_lang_invoke_MemberName::is_instance(result()))
 956           return -99;  // caller bug!
 957         oop saved = MethodHandles::init_field_MemberName(result, st.field_descriptor());
 958         if (saved != result())
 959           results->obj_at_put(rfill-1, saved);  // show saved instance to user
 960       } else if (++overflow >= overflow_limit) {
 961         match_flags = 0; break; // got tired of looking at overflow
 962       }
 963     }
 964   }
 965 
 966   if ((match_flags & (IS_METHOD | IS_CONSTRUCTOR)) != 0) {
 967     // watch out for these guys:
 968     Symbol* init_name   = vmSymbols::object_initializer_name();
 969     Symbol* clinit_name = vmSymbols::class_initializer_name();
 970     if (name == clinit_name)  clinit_name = NULL; // hack for exposing <clinit>
 971     bool negate_name_test = false;
 972     // fix name so that it captures the intention of IS_CONSTRUCTOR
 973     if (!(match_flags & IS_METHOD)) {
 974       // constructors only
 975       if (name == NULL) {
 976         name = init_name;
 977       } else if (name != init_name) {
 978         return 0;               // no constructors of this method name
 979       }
 980     } else if (!(match_flags & IS_CONSTRUCTOR)) {
 981       // methods only
 982       if (name == NULL) {
 983         name = init_name;
 984         negate_name_test = true; // if we see the name, we *omit* the entry
 985       } else if (name == init_name) {
 986         return 0;               // no methods of this constructor name
 987       }
 988     } else {
 989       // caller will accept either sort; no need to adjust name
 990     }
 991     InstanceKlass* ik = InstanceKlass::cast(k);
 992     for (MethodStream st(ik, local_only, !search_intfc); !st.eos(); st.next()) {
 993       Method* m = st.method();
 994       Symbol* m_name = m->name();
 995       if (m_name == clinit_name)
 996         continue;
 997       if (name != NULL && ((m_name != name) ^ negate_name_test))
 998           continue;
 999       if (sig != NULL && m->signature() != sig)
1000         continue;
1001       // passed the filters
1002       if (rskip > 0) {
1003         --rskip;
1004       } else if (rfill < rlimit) {
1005         Handle result(thread, results->obj_at(rfill++));
1006         if (!java_lang_invoke_MemberName::is_instance(result()))
1007           return -99;  // caller bug!
1008         CallInfo info(m, NULL, CHECK_0);
1009         oop saved = MethodHandles::init_method_MemberName(result, info);
1010         if (saved != result())
1011           results->obj_at_put(rfill-1, saved);  // show saved instance to user
1012       } else if (++overflow >= overflow_limit) {
1013         match_flags = 0; break; // got tired of looking at overflow
1014       }
1015     }
1016   }
1017 
1018   // return number of elements we at leasted wanted to initialize
1019   return rfill + overflow;
1020 }
1021 
1022 void MethodHandles::add_dependent_nmethod(oop call_site, nmethod* nm) {
1023   assert_locked_or_safepoint(CodeCache_lock);
1024 
1025   oop context = java_lang_invoke_CallSite::context_no_keepalive(call_site);
1026   DependencyContext deps = java_lang_invoke_MethodHandleNatives_CallSiteContext::vmdependencies(context);
1027   // Try to purge stale entries on updates.
1028   // Since GC doesn't clean dependency contexts rooted at CallSiteContext objects,
1029   // in order to avoid memory leak, stale entries are purged whenever a dependency list
1030   // is changed (both on addition and removal). Though memory reclamation is delayed,
1031   // it avoids indefinite memory usage growth.
1032   deps.add_dependent_nmethod(nm);
1033 }
1034 
1035 void MethodHandles::remove_dependent_nmethod(oop call_site, nmethod* nm) {
1036   assert_locked_or_safepoint(CodeCache_lock);
1037 
1038   oop context = java_lang_invoke_CallSite::context_no_keepalive(call_site);
1039   DependencyContext deps = java_lang_invoke_MethodHandleNatives_CallSiteContext::vmdependencies(context);
1040   deps.remove_dependent_nmethod(nm);
1041 }
1042 
1043 void MethodHandles::clean_dependency_context(oop call_site) {
1044   oop context = java_lang_invoke_CallSite::context_no_keepalive(call_site);
1045   DependencyContext deps = java_lang_invoke_MethodHandleNatives_CallSiteContext::vmdependencies(context);
1046   deps.clean_unloading_dependents();
1047 }
1048 
1049 void MethodHandles::flush_dependent_nmethods(Handle call_site, Handle target) {
1050   assert_lock_strong(Compile_lock);
1051 
1052   int marked = 0;
1053   CallSiteDepChange changes(call_site, target);
1054   {
1055     NoSafepointVerifier nsv;
1056     MutexLocker mu2(CodeCache_lock, Mutex::_no_safepoint_check_flag);
1057 
1058     oop context = java_lang_invoke_CallSite::context_no_keepalive(call_site());
1059     DependencyContext deps = java_lang_invoke_MethodHandleNatives_CallSiteContext::vmdependencies(context);
1060     marked = deps.mark_dependent_nmethods(changes);
1061   }
1062   if (marked > 0) {
1063     // At least one nmethod has been marked for deoptimization.
1064     Deoptimization::deoptimize_all_marked();
1065   }
1066 }
1067 
1068 void MethodHandles::trace_method_handle_interpreter_entry(MacroAssembler* _masm, vmIntrinsics::ID iid) {
1069   if (TraceMethodHandles) {
1070     const char* name = vmIntrinsics::name_at(iid);
1071     if (*name == '_')  name += 1;
1072     const size_t len = strlen(name) + 50;
1073     char* qname = NEW_C_HEAP_ARRAY(char, len, mtInternal);
1074     const char* suffix = "";
1075     if (is_signature_polymorphic(iid)) {
1076       if (is_signature_polymorphic_static(iid))
1077         suffix = "/static";
1078       else
1079         suffix = "/private";
1080     }
1081     jio_snprintf(qname, len, "MethodHandle::interpreter_entry::%s%s", name, suffix);
1082     trace_method_handle(_masm, qname);
1083     // Note:  Don't free the allocated char array because it's used
1084     // during runtime.
1085   }
1086 }
1087 
1088 //
1089 // Here are the native methods in java.lang.invoke.MethodHandleNatives
1090 // They are the private interface between this JVM and the HotSpot-specific
1091 // Java code that implements JSR 292 method handles.
1092 //
1093 // Note:  We use a JVM_ENTRY macro to define each of these, for this is the way
1094 // that intrinsic (non-JNI) native methods are defined in HotSpot.
1095 //
1096 
1097 #ifndef PRODUCT
1098 #define EACH_NAMED_CON(template, requirement) \
1099     template(java_lang_invoke_MemberName,MN_IS_METHOD) \
1100     template(java_lang_invoke_MemberName,MN_IS_CONSTRUCTOR) \
1101     template(java_lang_invoke_MemberName,MN_IS_FIELD) \
1102     template(java_lang_invoke_MemberName,MN_IS_TYPE) \
1103     template(java_lang_invoke_MemberName,MN_CALLER_SENSITIVE) \
1104     template(java_lang_invoke_MemberName,MN_SEARCH_SUPERCLASSES) \
1105     template(java_lang_invoke_MemberName,MN_SEARCH_INTERFACES) \
1106     template(java_lang_invoke_MemberName,MN_REFERENCE_KIND_SHIFT) \
1107     template(java_lang_invoke_MemberName,MN_REFERENCE_KIND_MASK) \
1108     /*end*/
1109 
1110 #define IGNORE_REQ(req_expr) /* req_expr */
1111 #define ONE_PLUS(scope,value) 1+
1112 static const int con_value_count = EACH_NAMED_CON(ONE_PLUS, IGNORE_REQ) 0;
1113 #define VALUE_COMMA(scope,value) scope::value,
1114 static const int con_values[con_value_count+1] = { EACH_NAMED_CON(VALUE_COMMA, IGNORE_REQ) 0 };
1115 #define STRING_NULL(scope,value) #value "\0"
1116 static const char con_names[] = { EACH_NAMED_CON(STRING_NULL, IGNORE_REQ) };
1117 
1118 static bool advertise_con_value(int which) {
1119   if (which < 0)  return false;
1120   bool ok = true;
1121   int count = 0;
1122 #define INC_COUNT(scope,value) \
1123   ++count;
1124 #define CHECK_REQ(req_expr) \
1125   if (which < count)  return ok; \
1126   ok = (req_expr);
1127   EACH_NAMED_CON(INC_COUNT, CHECK_REQ);
1128 #undef INC_COUNT
1129 #undef CHECK_REQ
1130   assert(count == con_value_count, "");
1131   if (which < count)  return ok;
1132   return false;
1133 }
1134 
1135 #undef ONE_PLUS
1136 #undef VALUE_COMMA
1137 #undef STRING_NULL
1138 #undef EACH_NAMED_CON
1139 #endif // PRODUCT
1140 
1141 JVM_ENTRY(jint, MHN_getNamedCon(JNIEnv *env, jobject igcls, jint which, jobjectArray box_jh)) {
1142 #ifndef PRODUCT
1143   if (advertise_con_value(which)) {
1144     assert(which >= 0 && which < con_value_count, "");
1145     int con = con_values[which];
1146     objArrayHandle box(THREAD, (objArrayOop) JNIHandles::resolve(box_jh));
1147     if (box.not_null() && box->klass() == Universe::objectArrayKlassObj() && box->length() > 0) {
1148       const char* str = &con_names[0];
1149       for (int i = 0; i < which; i++)
1150         str += strlen(str) + 1;   // skip name and null
1151       oop name = java_lang_String::create_oop_from_str(str, CHECK_0);  // possible safepoint
1152       box->obj_at_put(0, name);
1153     }
1154     return con;
1155   }
1156 #endif
1157   return 0;
1158 }
1159 JVM_END
1160 
1161 // void init(MemberName self, AccessibleObject ref)
1162 JVM_ENTRY(void, MHN_init_Mem(JNIEnv *env, jobject igcls, jobject mname_jh, jobject target_jh)) {
1163   if (mname_jh == NULL) { THROW_MSG(vmSymbols::java_lang_InternalError(), "mname is null"); }
1164   if (target_jh == NULL) { THROW_MSG(vmSymbols::java_lang_InternalError(), "target is null"); }
1165   Handle mname(THREAD, JNIHandles::resolve_non_null(mname_jh));
1166   Handle target(THREAD, JNIHandles::resolve_non_null(target_jh));
1167   MethodHandles::init_MemberName(mname, target, CHECK);
1168 }
1169 JVM_END
1170 
1171 // void expand(MemberName self)
1172 JVM_ENTRY(void, MHN_expand_Mem(JNIEnv *env, jobject igcls, jobject mname_jh)) {
1173   if (mname_jh == NULL) { THROW_MSG(vmSymbols::java_lang_InternalError(), "mname is null"); }
1174   Handle mname(THREAD, JNIHandles::resolve_non_null(mname_jh));
1175   MethodHandles::expand_MemberName(mname, 0, CHECK);
1176 }
1177 JVM_END
1178 
1179 // void resolve(MemberName self, Class<?> caller)
1180 JVM_ENTRY(jobject, MHN_resolve_Mem(JNIEnv *env, jobject igcls, jobject mname_jh, jclass caller_jh,
1181     jboolean speculative_resolve)) {
1182   if (mname_jh == NULL) { THROW_MSG_NULL(vmSymbols::java_lang_InternalError(), "mname is null"); }
1183   Handle mname(THREAD, JNIHandles::resolve_non_null(mname_jh));
1184 
1185   // The trusted Java code that calls this method should already have performed
1186   // access checks on behalf of the given caller.  But, we can verify this.
1187   if (VerifyMethodHandles && caller_jh != NULL &&
1188       java_lang_invoke_MemberName::clazz(mname()) != NULL) {
1189     Klass* reference_klass = java_lang_Class::as_Klass(java_lang_invoke_MemberName::clazz(mname()));
1190     if (reference_klass != NULL && reference_klass->is_objArray_klass()) {
1191       reference_klass = ObjArrayKlass::cast(reference_klass)->bottom_klass();
1192     }
1193 
1194     // Reflection::verify_class_access can only handle instance classes.
1195     if (reference_klass != NULL && reference_klass->is_instance_klass()) {
1196       // Emulate LinkResolver::check_klass_accessability.
1197       Klass* caller = java_lang_Class::as_Klass(JNIHandles::resolve_non_null(caller_jh));
1198       if (caller != SystemDictionary::Object_klass()
1199           && Reflection::verify_class_access(caller,
1200                                              InstanceKlass::cast(reference_klass),
1201                                              true) != Reflection::ACCESS_OK) {
1202         THROW_MSG_NULL(vmSymbols::java_lang_InternalError(), reference_klass->external_name());
1203       }
1204     }
1205   }
1206 
1207   Klass* caller = caller_jh == NULL ? NULL :
1208                      java_lang_Class::as_Klass(JNIHandles::resolve_non_null(caller_jh));
1209   Handle resolved = MethodHandles::resolve_MemberName(mname, caller, speculative_resolve == JNI_TRUE,
1210                                                       CHECK_NULL);
1211 
1212   if (resolved.is_null()) {
1213     int flags = java_lang_invoke_MemberName::flags(mname());
1214     int ref_kind = (flags >> REFERENCE_KIND_SHIFT) & REFERENCE_KIND_MASK;
1215     if (!MethodHandles::ref_kind_is_valid(ref_kind)) {
1216       THROW_MSG_NULL(vmSymbols::java_lang_InternalError(), "obsolete MemberName format");
1217     }
1218     if (speculative_resolve) {
1219       assert(!HAS_PENDING_EXCEPTION, "No exceptions expected when resolving speculatively");
1220       return NULL;
1221     }
1222     if ((flags & ALL_KINDS) == IS_FIELD) {
1223       THROW_MSG_NULL(vmSymbols::java_lang_NoSuchFieldError(), "field resolution failed");
1224     } else if ((flags & ALL_KINDS) == IS_METHOD ||
1225                (flags & ALL_KINDS) == IS_CONSTRUCTOR) {
1226       THROW_MSG_NULL(vmSymbols::java_lang_NoSuchMethodError(), "method resolution failed");
1227     } else {
1228       THROW_MSG_NULL(vmSymbols::java_lang_LinkageError(), "resolution failed");
1229     }
1230   }
1231 
1232   return JNIHandles::make_local(THREAD, resolved());
1233 }
1234 JVM_END
1235 
1236 static jlong find_member_field_offset(oop mname, bool must_be_static, TRAPS) {
1237   if (mname == NULL ||
1238       java_lang_invoke_MemberName::clazz(mname) == NULL) {
1239     THROW_MSG_0(vmSymbols::java_lang_InternalError(), "mname not resolved");
1240   } else {
1241     int flags = java_lang_invoke_MemberName::flags(mname);
1242     if ((flags & IS_FIELD) != 0 &&
1243         (must_be_static
1244          ? (flags & JVM_ACC_STATIC) != 0
1245          : (flags & JVM_ACC_STATIC) == 0)) {
1246       int vmindex = java_lang_invoke_MemberName::vmindex(mname);
1247       return (jlong) vmindex;
1248     }
1249   }
1250   const char* msg = (must_be_static ? "static field required" : "non-static field required");
1251   THROW_MSG_0(vmSymbols::java_lang_InternalError(), msg);
1252   return 0;
1253 }
1254 
1255 JVM_ENTRY(jlong, MHN_objectFieldOffset(JNIEnv *env, jobject igcls, jobject mname_jh)) {
1256   return find_member_field_offset(JNIHandles::resolve(mname_jh), false, THREAD);
1257 }
1258 JVM_END
1259 
1260 JVM_ENTRY(jlong, MHN_staticFieldOffset(JNIEnv *env, jobject igcls, jobject mname_jh)) {
1261   return find_member_field_offset(JNIHandles::resolve(mname_jh), true, THREAD);
1262 }
1263 JVM_END
1264 
1265 JVM_ENTRY(jobject, MHN_staticFieldBase(JNIEnv *env, jobject igcls, jobject mname_jh)) {
1266   // use the other function to perform sanity checks:
1267   jlong ignore = find_member_field_offset(JNIHandles::resolve(mname_jh), true, CHECK_NULL);
1268   oop clazz = java_lang_invoke_MemberName::clazz(JNIHandles::resolve_non_null(mname_jh));
1269   return JNIHandles::make_local(THREAD, clazz);
1270 }
1271 JVM_END
1272 
1273 JVM_ENTRY(jobject, MHN_getMemberVMInfo(JNIEnv *env, jobject igcls, jobject mname_jh)) {
1274   if (mname_jh == NULL)  return NULL;
1275   Handle mname(THREAD, JNIHandles::resolve_non_null(mname_jh));
1276   intptr_t vmindex  = java_lang_invoke_MemberName::vmindex(mname());
1277   objArrayHandle result = oopFactory::new_objArray_handle(SystemDictionary::Object_klass(), 2, CHECK_NULL);
1278   jvalue vmindex_value; vmindex_value.j = (long)vmindex;
1279   oop x = java_lang_boxing_object::create(T_LONG, &vmindex_value, CHECK_NULL);
1280   result->obj_at_put(0, x);
1281 
1282   int flags = java_lang_invoke_MemberName::flags(mname());
1283   if ((flags & IS_FIELD) != 0) {
1284     x = java_lang_invoke_MemberName::clazz(mname());
1285   } else {
1286     Method* vmtarget = java_lang_invoke_MemberName::vmtarget(mname());
1287     assert(vmtarget != NULL && vmtarget->is_method(), "vmtarget is only method");
1288     x = mname();
1289   }
1290   result->obj_at_put(1, x);
1291   return JNIHandles::make_local(env, result());
1292 }
1293 JVM_END
1294 
1295 
1296 
1297 //  static native int getMembers(Class<?> defc, String matchName, String matchSig,
1298 //          int matchFlags, Class<?> caller, int skip, MemberName[] results);
1299 JVM_ENTRY(jint, MHN_getMembers(JNIEnv *env, jobject igcls,
1300                                jclass clazz_jh, jstring name_jh, jstring sig_jh,
1301                                int mflags, jclass caller_jh, jint skip, jobjectArray results_jh)) {
1302   if (clazz_jh == NULL || results_jh == NULL)  return -1;
1303   Klass* k = java_lang_Class::as_Klass(JNIHandles::resolve_non_null(clazz_jh));
1304 
1305   objArrayHandle results(THREAD, (objArrayOop) JNIHandles::resolve(results_jh));
1306   if (results.is_null() || !results->is_objArray())  return -1;
1307 
1308   TempNewSymbol name = NULL;
1309   TempNewSymbol sig = NULL;
1310   if (name_jh != NULL) {
1311     name = java_lang_String::as_symbol_or_null(JNIHandles::resolve_non_null(name_jh));
1312     if (name == NULL)  return 0; // a match is not possible
1313   }
1314   if (sig_jh != NULL) {
1315     sig = java_lang_String::as_symbol_or_null(JNIHandles::resolve_non_null(sig_jh));
1316     if (sig == NULL)  return 0; // a match is not possible
1317   }
1318 
1319   Klass* caller = NULL;
1320   if (caller_jh != NULL) {
1321     oop caller_oop = JNIHandles::resolve_non_null(caller_jh);
1322     if (!java_lang_Class::is_instance(caller_oop))  return -1;
1323     caller = java_lang_Class::as_Klass(caller_oop);
1324   }
1325 
1326   if (name != NULL && sig != NULL && results.not_null()) {
1327     // try a direct resolve
1328     // %%% TO DO
1329   }
1330 
1331   int res = MethodHandles::find_MemberNames(k, name, sig, mflags,
1332                                             caller, skip, results, CHECK_0);
1333   // TO DO: expand at least some of the MemberNames, to avoid massive callbacks
1334   return res;
1335 }
1336 JVM_END
1337 
1338 JVM_ENTRY(void, MHN_setCallSiteTargetNormal(JNIEnv* env, jobject igcls, jobject call_site_jh, jobject target_jh)) {
1339   Handle call_site(THREAD, JNIHandles::resolve_non_null(call_site_jh));
1340   Handle target   (THREAD, JNIHandles::resolve_non_null(target_jh));
1341   {
1342     // Walk all nmethods depending on this call site.
1343     MutexLocker mu(thread, Compile_lock);
1344     MethodHandles::flush_dependent_nmethods(call_site, target);
1345     java_lang_invoke_CallSite::set_target(call_site(), target());
1346   }
1347 }
1348 JVM_END
1349 
1350 JVM_ENTRY(void, MHN_setCallSiteTargetVolatile(JNIEnv* env, jobject igcls, jobject call_site_jh, jobject target_jh)) {
1351   Handle call_site(THREAD, JNIHandles::resolve_non_null(call_site_jh));
1352   Handle target   (THREAD, JNIHandles::resolve_non_null(target_jh));
1353   {
1354     // Walk all nmethods depending on this call site.
1355     MutexLocker mu(thread, Compile_lock);
1356     MethodHandles::flush_dependent_nmethods(call_site, target);
1357     java_lang_invoke_CallSite::set_target_volatile(call_site(), target());
1358   }
1359 }
1360 JVM_END
1361 
1362 JVM_ENTRY(void, MHN_copyOutBootstrapArguments(JNIEnv* env, jobject igcls,
1363                                               jobject caller_jh, jintArray index_info_jh,
1364                                               jint start, jint end,
1365                                               jobjectArray buf_jh, jint pos,
1366                                               jboolean resolve, jobject ifna_jh)) {
1367   Klass* caller_k = java_lang_Class::as_Klass(JNIHandles::resolve(caller_jh));
1368   if (caller_k == NULL || !caller_k->is_instance_klass()) {
1369       THROW_MSG(vmSymbols::java_lang_InternalError(), "bad caller");
1370   }
1371   InstanceKlass* caller = InstanceKlass::cast(caller_k);
1372   typeArrayOop index_info_oop = (typeArrayOop) JNIHandles::resolve(index_info_jh);
1373   if (index_info_oop == NULL ||
1374       index_info_oop->klass() != Universe::intArrayKlassObj() ||
1375       typeArrayOop(index_info_oop)->length() < 2) {
1376       THROW_MSG(vmSymbols::java_lang_InternalError(), "bad index info (0)");
1377   }
1378   typeArrayHandle index_info(THREAD, index_info_oop);
1379   int bss_index_in_pool = index_info->int_at(1);
1380   // While we are here, take a quick look at the index info:
1381   if (bss_index_in_pool <= 0 ||
1382       bss_index_in_pool >= caller->constants()->length() ||
1383       index_info->int_at(0)
1384       != caller->constants()->bootstrap_argument_count_at(bss_index_in_pool)) {
1385       THROW_MSG(vmSymbols::java_lang_InternalError(), "bad index info (1)");
1386   }
1387   objArrayHandle buf(THREAD, (objArrayOop) JNIHandles::resolve(buf_jh));
1388   if (start < 0) {
1389     for (int pseudo_index = -4; pseudo_index < 0; pseudo_index++) {
1390       if (start == pseudo_index) {
1391         if (start >= end || 0 > pos || pos >= buf->length())  break;
1392         oop pseudo_arg = NULL;
1393         switch (pseudo_index) {
1394         case -4:  // bootstrap method
1395           {
1396             int bsm_index = caller->constants()->bootstrap_method_ref_index_at(bss_index_in_pool);
1397             pseudo_arg = caller->constants()->resolve_possibly_cached_constant_at(bsm_index, CHECK);
1398             break;
1399           }
1400         case -3:  // name
1401           {
1402             Symbol* name = caller->constants()->name_ref_at(bss_index_in_pool);
1403             Handle str = java_lang_String::create_from_symbol(name, CHECK);
1404             pseudo_arg = str();
1405             break;
1406           }
1407         case -2:  // type
1408           {
1409             Symbol* type = caller->constants()->signature_ref_at(bss_index_in_pool);
1410             Handle th;
1411             if (type->char_at(0) == JVM_SIGNATURE_FUNC) {
1412               th = SystemDictionary::find_method_handle_type(type, caller, CHECK);
1413             } else {
1414               th = SystemDictionary::find_java_mirror_for_type(type, caller, SignatureStream::NCDFError, CHECK);
1415             }
1416             pseudo_arg = th();
1417             break;
1418           }
1419         case -1:  // argument count
1420           {
1421             int argc = caller->constants()->bootstrap_argument_count_at(bss_index_in_pool);
1422             jvalue argc_value; argc_value.i = (jint)argc;
1423             pseudo_arg = java_lang_boxing_object::create(T_INT, &argc_value, CHECK);
1424             break;
1425           }
1426         }
1427 
1428         // Store the pseudo-argument, and advance the pointers.
1429         buf->obj_at_put(pos++, pseudo_arg);
1430         ++start;
1431       }
1432     }
1433     // When we are done with this there may be regular arguments to process too.
1434   }
1435   Handle ifna(THREAD, JNIHandles::resolve(ifna_jh));
1436   caller->constants()->
1437     copy_bootstrap_arguments_at(bss_index_in_pool,
1438                                 start, end, buf, pos,
1439                                 (resolve == JNI_TRUE), ifna, CHECK);
1440 }
1441 JVM_END
1442 
1443 // It is called by a Cleaner object which ensures that dropped CallSites properly
1444 // deallocate their dependency information.
1445 JVM_ENTRY(void, MHN_clearCallSiteContext(JNIEnv* env, jobject igcls, jobject context_jh)) {
1446   Handle context(THREAD, JNIHandles::resolve_non_null(context_jh));
1447   {
1448     // Walk all nmethods depending on this call site.
1449     MutexLocker mu1(thread, Compile_lock);
1450 
1451     int marked = 0;
1452     {
1453       NoSafepointVerifier nsv;
1454       MutexLocker mu2(THREAD, CodeCache_lock, Mutex::_no_safepoint_check_flag);
1455       DependencyContext deps = java_lang_invoke_MethodHandleNatives_CallSiteContext::vmdependencies(context());
1456       marked = deps.remove_all_dependents();
1457     }
1458     if (marked > 0) {
1459       // At least one nmethod has been marked for deoptimization
1460       Deoptimization::deoptimize_all_marked();
1461     }
1462   }
1463 }
1464 JVM_END
1465 
1466 /**
1467  * Throws a java/lang/UnsupportedOperationException unconditionally.
1468  * This is required by the specification of MethodHandle.invoke if
1469  * invoked directly.
1470  */
1471 JVM_ENTRY(jobject, MH_invoke_UOE(JNIEnv* env, jobject mh, jobjectArray args)) {
1472   THROW_MSG_NULL(vmSymbols::java_lang_UnsupportedOperationException(), "MethodHandle.invoke cannot be invoked reflectively");
1473   return NULL;
1474 }
1475 JVM_END
1476 
1477 /**
1478  * Throws a java/lang/UnsupportedOperationException unconditionally.
1479  * This is required by the specification of MethodHandle.invokeExact if
1480  * invoked directly.
1481  */
1482 JVM_ENTRY(jobject, MH_invokeExact_UOE(JNIEnv* env, jobject mh, jobjectArray args)) {
1483   THROW_MSG_NULL(vmSymbols::java_lang_UnsupportedOperationException(), "MethodHandle.invokeExact cannot be invoked reflectively");
1484   return NULL;
1485 }
1486 JVM_END
1487 
1488 /// JVM_RegisterMethodHandleMethods
1489 
1490 #undef CS  // Solaris builds complain
1491 
1492 #define LANG "Ljava/lang/"
1493 #define JLINV "Ljava/lang/invoke/"
1494 
1495 #define OBJ   LANG "Object;"
1496 #define CLS   LANG "Class;"
1497 #define STRG  LANG "String;"
1498 #define CS    JLINV "CallSite;"
1499 #define MT    JLINV "MethodType;"
1500 #define MH    JLINV "MethodHandle;"
1501 #define MEM   JLINV "MemberName;"
1502 #define CTX   JLINV "MethodHandleNatives$CallSiteContext;"
1503 
1504 #define CC (char*)  /*cast a literal from (const char*)*/
1505 #define FN_PTR(f) CAST_FROM_FN_PTR(void*, &f)
1506 
1507 // These are the native methods on java.lang.invoke.MethodHandleNatives.
1508 static JNINativeMethod MHN_methods[] = {
1509   {CC "init",                      CC "(" MEM "" OBJ ")V",                   FN_PTR(MHN_init_Mem)},
1510   {CC "expand",                    CC "(" MEM ")V",                          FN_PTR(MHN_expand_Mem)},
1511   {CC "resolve",                   CC "(" MEM "" CLS "Z)" MEM,               FN_PTR(MHN_resolve_Mem)},
1512   //  static native int getNamedCon(int which, Object[] name)
1513   {CC "getNamedCon",               CC "(I[" OBJ ")I",                        FN_PTR(MHN_getNamedCon)},
1514   //  static native int getMembers(Class<?> defc, String matchName, String matchSig,
1515   //          int matchFlags, Class<?> caller, int skip, MemberName[] results);
1516   {CC "getMembers",                CC "(" CLS "" STRG "" STRG "I" CLS "I[" MEM ")I", FN_PTR(MHN_getMembers)},
1517   {CC "objectFieldOffset",         CC "(" MEM ")J",                          FN_PTR(MHN_objectFieldOffset)},
1518   {CC "setCallSiteTargetNormal",   CC "(" CS "" MH ")V",                     FN_PTR(MHN_setCallSiteTargetNormal)},
1519   {CC "setCallSiteTargetVolatile", CC "(" CS "" MH ")V",                     FN_PTR(MHN_setCallSiteTargetVolatile)},
1520   {CC "copyOutBootstrapArguments", CC "(" CLS "[III[" OBJ "IZ" OBJ ")V",     FN_PTR(MHN_copyOutBootstrapArguments)},
1521   {CC "clearCallSiteContext",      CC "(" CTX ")V",                          FN_PTR(MHN_clearCallSiteContext)},
1522   {CC "staticFieldOffset",         CC "(" MEM ")J",                          FN_PTR(MHN_staticFieldOffset)},
1523   {CC "staticFieldBase",           CC "(" MEM ")" OBJ,                        FN_PTR(MHN_staticFieldBase)},
1524   {CC "getMemberVMInfo",           CC "(" MEM ")" OBJ,                        FN_PTR(MHN_getMemberVMInfo)}
1525 };
1526 
1527 static JNINativeMethod MH_methods[] = {
1528   // UnsupportedOperationException throwers
1529   {CC "invoke",                    CC "([" OBJ ")" OBJ,                       FN_PTR(MH_invoke_UOE)},
1530   {CC "invokeExact",               CC "([" OBJ ")" OBJ,                       FN_PTR(MH_invokeExact_UOE)}
1531 };
1532 
1533 /**
1534  * This one function is exported, used by NativeLookup.
1535  */
1536 JVM_ENTRY(void, JVM_RegisterMethodHandleMethods(JNIEnv *env, jclass MHN_class)) {
1537   assert(!MethodHandles::enabled(), "must not be enabled");
1538   assert(SystemDictionary::MethodHandle_klass() != NULL, "should be present");
1539 
1540   oop mirror = SystemDictionary::MethodHandle_klass()->java_mirror();
1541   jclass MH_class = (jclass) JNIHandles::make_local(env, mirror);
1542 
1543   {
1544     ThreadToNativeFromVM ttnfv(thread);
1545 
1546     int status = env->RegisterNatives(MHN_class, MHN_methods, sizeof(MHN_methods)/sizeof(JNINativeMethod));
1547     guarantee(status == JNI_OK && !env->ExceptionOccurred(),
1548               "register java.lang.invoke.MethodHandleNative natives");
1549 
1550     status = env->RegisterNatives(MH_class, MH_methods, sizeof(MH_methods)/sizeof(JNINativeMethod));
1551     guarantee(status == JNI_OK && !env->ExceptionOccurred(),
1552               "register java.lang.invoke.MethodHandle natives");
1553   }
1554 
1555   if (TraceInvokeDynamic) {
1556     tty->print_cr("MethodHandle support loaded (using LambdaForms)");
1557   }
1558 
1559   MethodHandles::set_enabled(true);
1560 }
1561 JVM_END