1 /*
   2  * Copyright (c) 1997, 2011, 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_OOPS_INSTANCEKLASS_HPP
  26 #define SHARE_VM_OOPS_INSTANCEKLASS_HPP
  27 
  28 #include "oops/constMethodOop.hpp"
  29 #include "oops/constantPoolOop.hpp"
  30 #include "oops/fieldInfo.hpp"
  31 #include "oops/instanceOop.hpp"
  32 #include "oops/klassOop.hpp"
  33 #include "oops/klassVtable.hpp"
  34 #include "oops/objArrayOop.hpp"
  35 #include "runtime/handles.hpp"
  36 #include "runtime/os.hpp"
  37 #include "utilities/accessFlags.hpp"
  38 #include "utilities/bitMap.inline.hpp"
  39 
  40 // An instanceKlass is the VM level representation of a Java class.
  41 // It contains all information needed for at class at execution runtime.
  42 
  43 //  instanceKlass layout:
  44 //    [header                     ] klassOop
  45 //    [klass pointer              ] klassOop
  46 //    [C++ vtbl pointer           ] Klass
  47 //    [subtype cache              ] Klass
  48 //    [instance size              ] Klass
  49 //    [java mirror                ] Klass
  50 //    [super                      ] Klass
  51 //    [access_flags               ] Klass
  52 //    [name                       ] Klass
  53 //    [first subklass             ] Klass
  54 //    [next sibling               ] Klass
  55 //    [array klasses              ]
  56 //    [methods                    ]
  57 //    [local interfaces           ]
  58 //    [transitive interfaces      ]
  59 //    [number of implementors     ]
  60 //    [implementors               ] klassOop[2]
  61 //    [fields                     ]
  62 //    [constants                  ]
  63 //    [class loader               ]
  64 //    [protection domain          ]
  65 //    [signers                    ]
  66 //    [source file name           ]
  67 //    [inner classes              ]
  68 //    [static field size          ]
  69 //    [nonstatic field size       ]
  70 //    [static oop fields size     ]
  71 //    [nonstatic oop maps size    ]
  72 //    [has finalize method        ]
  73 //    [deoptimization mark bit    ]
  74 //    [initialization state       ]
  75 //    [initializing thread        ]
  76 //    [Java vtable length         ]
  77 //    [oop map cache (stack maps) ]
  78 //    [EMBEDDED Java vtable             ] size in words = vtable_len
  79 //    [EMBEDDED nonstatic oop-map blocks] size in words = nonstatic_oop_map_size
  80 //
  81 //    The embedded nonstatic oop-map blocks are short pairs (offset, length) indicating
  82 //    where oops are located in instances of this klass.
  83 
  84 
  85 // forward declaration for class -- see below for definition
  86 class SuperTypeClosure;
  87 class JNIid;
  88 class jniIdMapBase;
  89 class BreakpointInfo;
  90 class fieldDescriptor;
  91 class DepChange;
  92 class nmethodBucket;
  93 class PreviousVersionNode;
  94 class JvmtiCachedClassFieldMap;
  95 
  96 // This is used in iterators below.
  97 class FieldClosure: public StackObj {
  98 public:
  99   virtual void do_field(fieldDescriptor* fd) = 0;
 100 };
 101 
 102 #ifndef PRODUCT
 103 // Print fields.
 104 // If "obj" argument to constructor is NULL, prints static fields, otherwise prints non-static fields.
 105 class FieldPrinter: public FieldClosure {
 106    oop _obj;
 107    outputStream* _st;
 108  public:
 109    FieldPrinter(outputStream* st, oop obj = NULL) : _obj(obj), _st(st) {}
 110    void do_field(fieldDescriptor* fd);
 111 };
 112 #endif  // !PRODUCT
 113 
 114 // ValueObjs embedded in klass. Describes where oops are located in instances of
 115 // this klass.
 116 class OopMapBlock VALUE_OBJ_CLASS_SPEC {
 117  public:
 118   // Byte offset of the first oop mapped by this block.
 119   int offset() const          { return _offset; }
 120   void set_offset(int offset) { _offset = offset; }
 121 
 122   // Number of oops in this block.
 123   uint count() const         { return _count; }
 124   void set_count(uint count) { _count = count; }
 125 
 126   // sizeof(OopMapBlock) in HeapWords.
 127   static const int size_in_words() {
 128     return align_size_up(int(sizeof(OopMapBlock)), HeapWordSize) >>
 129       LogHeapWordSize;
 130   }
 131 
 132  private:
 133   int  _offset;
 134   uint _count;
 135 };
 136 
 137 class instanceKlass: public Klass {
 138   friend class VMStructs;
 139  public:
 140   // See "The Java Virtual Machine Specification" section 2.16.2-5 for a detailed description
 141   // of the class loading & initialization procedure, and the use of the states.
 142   enum ClassState {
 143     unparsable_by_gc = 0,               // object is not yet parsable by gc. Value of _init_state at object allocation.
 144     allocated,                          // allocated (but not yet linked)
 145     loaded,                             // loaded and inserted in class hierarchy (but not linked yet)
 146     linked,                             // successfully linked/verified (but not initialized yet)
 147     being_initialized,                  // currently running class initializer
 148     fully_initialized,                  // initialized (successfull final state)
 149     initialization_error                // error happened during initialization
 150   };
 151 
 152  public:
 153   oop* oop_block_beg() const { return adr_array_klasses(); }
 154   oop* oop_block_end() const { return adr_methods_default_annotations() + 1; }
 155 
 156   enum {
 157     implementors_limit = 2              // how many implems can we track?
 158   };
 159 
 160  protected:
 161   //
 162   // The oop block.  See comment in klass.hpp before making changes.
 163   //
 164 
 165   // Array classes holding elements of this class.
 166   klassOop        _array_klasses;
 167   // Method array.
 168   objArrayOop     _methods;
 169   // Int array containing the original order of method in the class file (for
 170   // JVMTI).
 171   typeArrayOop    _method_ordering;
 172   // Interface (klassOops) this class declares locally to implement.
 173   objArrayOop     _local_interfaces;
 174   // Interface (klassOops) this class implements transitively.
 175   objArrayOop     _transitive_interfaces;
 176   // Instance and static variable information, 5-tuples of shorts [access, name
 177   // index, sig index, initval index, offset].
 178   typeArrayOop    _fields;
 179   // Constant pool for this class.
 180   constantPoolOop _constants;
 181   // Class loader used to load this class, NULL if VM loader used.
 182   oop             _class_loader;
 183   // Protection domain.
 184   oop             _protection_domain;
 185   // Host class, which grants its access privileges to this class also.
 186   // This is only non-null for an anonymous class (JSR 292 enabled).
 187   // The host class is either named, or a previously loaded anonymous class.
 188   klassOop        _host_klass;
 189   // Class signers.
 190   objArrayOop     _signers;
 191   // inner_classes attribute.
 192   typeArrayOop    _inner_classes;
 193   // Implementors of this interface (not valid if it overflows)
 194   klassOop        _implementors[implementors_limit];
 195   // Annotations for this class, or null if none.
 196   typeArrayOop    _class_annotations;
 197   // Annotation objects (byte arrays) for fields, or null if no annotations.
 198   // Indices correspond to entries (not indices) in fields array.
 199   objArrayOop     _fields_annotations;
 200   // Annotation objects (byte arrays) for methods, or null if no annotations.
 201   // Index is the idnum, which is initially the same as the methods array index.
 202   objArrayOop     _methods_annotations;
 203   // Annotation objects (byte arrays) for methods' parameters, or null if no
 204   // such annotations.
 205   // Index is the idnum, which is initially the same as the methods array index.
 206   objArrayOop     _methods_parameter_annotations;
 207   // Annotation objects (byte arrays) for methods' default values, or null if no
 208   // such annotations.
 209   // Index is the idnum, which is initially the same as the methods array index.
 210   objArrayOop     _methods_default_annotations;
 211 
 212   //
 213   // End of the oop block.
 214   //
 215 
 216   // Name of source file containing this klass, NULL if not specified.
 217   Symbol*         _source_file_name;
 218   // the source debug extension for this klass, NULL if not specified.
 219   Symbol*         _source_debug_extension;
 220   // Generic signature, or null if none.
 221   Symbol*         _generic_signature;
 222   // Array name derived from this class which needs unreferencing
 223   // if this class is unloaded.
 224   Symbol*         _array_name;
 225 
 226   // Number of heapOopSize words used by non-static fields in this klass
 227   // (including inherited fields but after header_size()).
 228   int             _nonstatic_field_size;
 229   int             _static_field_size;    // number words used by static fields (oop and non-oop) in this klass
 230   u2              _static_oop_field_count;// number of static oop fields in this klass
 231   u2              _java_fields_count;    // The number of declared Java fields
 232   int             _nonstatic_oop_map_size;// size in words of nonstatic oop map blocks
 233 
 234   bool            _is_marked_dependent;  // used for marking during flushing and deoptimization
 235   bool            _rewritten;            // methods rewritten.
 236   bool            _has_nonstatic_fields; // for sizing with UseCompressedOops
 237   bool            _should_verify_class;  // allow caching of preverification
 238   u2              _minor_version;        // minor version number of class file
 239   u2              _major_version;        // major version number of class file
 240   Thread*         _init_thread;          // Pointer to current thread doing initialization (to handle recusive initialization)
 241   int             _vtable_len;           // length of Java vtable (in words)
 242   int             _itable_len;           // length of Java itable (in words)
 243   ReferenceType   _reference_type;       // reference type
 244   OopMapCache*    volatile _oop_map_cache;   // OopMapCache for all methods in the klass (allocated lazily)
 245   JNIid*          _jni_ids;              // First JNI identifier for static fields in this class
 246   jmethodID*      _methods_jmethod_ids;  // jmethodIDs corresponding to method_idnum, or NULL if none
 247   int*            _methods_cached_itable_indices;  // itable_index cache for JNI invoke corresponding to methods idnum, or NULL
 248   nmethodBucket*  _dependencies;         // list of dependent nmethods
 249   nmethod*        _osr_nmethods_head;    // Head of list of on-stack replacement nmethods for this class
 250   BreakpointInfo* _breakpoints;          // bpt lists, managed by methodOop
 251   int             _nof_implementors;     // No of implementors of this interface (zero if not an interface)
 252   // Array of interesting part(s) of the previous version(s) of this
 253   // instanceKlass. See PreviousVersionWalker below.
 254   GrowableArray<PreviousVersionNode *>* _previous_versions;
 255   u2              _enclosing_method_class_index;  // Constant pool index for class of enclosing method, or 0 if none
 256   u2              _enclosing_method_method_index; // Constant pool index for name and type of enclosing method, or 0 if none
 257   // JVMTI fields can be moved to their own structure - see 6315920
 258   unsigned char * _cached_class_file_bytes;       // JVMTI: cached class file, before retransformable agent modified it in CFLH
 259   jint            _cached_class_file_len;         // JVMTI: length of above
 260   JvmtiCachedClassFieldMap* _jvmti_cached_class_field_map;  // JVMTI: used during heap iteration
 261   volatile u2     _idnum_allocated_count;         // JNI/JVMTI: increments with the addition of methods, old ids don't change
 262 
 263   // Class states are defined as ClassState (see above).
 264   // Place the _init_state here to utilize the unused 2-byte after
 265   // _idnum_allocated_count.
 266   u1              _init_state;                    // state of class
 267 
 268   // embedded Java vtable follows here
 269   // embedded Java itables follows here
 270   // embedded static fields follows here
 271   // embedded nonstatic oop-map blocks follows here
 272 
 273   friend class instanceKlassKlass;
 274   friend class SystemDictionary;
 275 
 276  public:
 277   bool has_nonstatic_fields() const        { return _has_nonstatic_fields; }
 278   void set_has_nonstatic_fields(bool b)    { _has_nonstatic_fields = b; }
 279 
 280   // field sizes
 281   int nonstatic_field_size() const         { return _nonstatic_field_size; }
 282   void set_nonstatic_field_size(int size)  { _nonstatic_field_size = size; }
 283 
 284   int static_field_size() const            { return _static_field_size; }
 285   void set_static_field_size(int size)     { _static_field_size = size; }
 286 
 287   int static_oop_field_count() const       { return (int)_static_oop_field_count; }
 288   void set_static_oop_field_count(u2 size) { _static_oop_field_count = size; }
 289 
 290   // Java vtable
 291   int  vtable_length() const               { return _vtable_len; }
 292   void set_vtable_length(int len)          { _vtable_len = len; }
 293 
 294   // Java itable
 295   int  itable_length() const               { return _itable_len; }
 296   void set_itable_length(int len)          { _itable_len = len; }
 297 
 298   // array klasses
 299   klassOop array_klasses() const           { return _array_klasses; }
 300   void set_array_klasses(klassOop k)       { oop_store_without_check((oop*) &_array_klasses, (oop) k); }
 301 
 302   // methods
 303   objArrayOop methods() const              { return _methods; }
 304   void set_methods(objArrayOop a)          { oop_store_without_check((oop*) &_methods, (oop) a); }
 305   methodOop method_with_idnum(int idnum);
 306 
 307   // method ordering
 308   typeArrayOop method_ordering() const     { return _method_ordering; }
 309   void set_method_ordering(typeArrayOop m) { oop_store_without_check((oop*) &_method_ordering, (oop) m); }
 310 
 311   // interfaces
 312   objArrayOop local_interfaces() const          { return _local_interfaces; }
 313   void set_local_interfaces(objArrayOop a)      { oop_store_without_check((oop*) &_local_interfaces, (oop) a); }
 314   objArrayOop transitive_interfaces() const     { return _transitive_interfaces; }
 315   void set_transitive_interfaces(objArrayOop a) { oop_store_without_check((oop*) &_transitive_interfaces, (oop) a); }
 316 
 317  private:
 318   friend class fieldDescriptor;
 319   FieldInfo* field(int index) const { return FieldInfo::from_field_array(_fields, index); }
 320 
 321  public:
 322   int     field_offset      (int index) const { return field(index)->offset(); }
 323   int     field_access_flags(int index) const { return field(index)->access_flags(); }
 324   Symbol* field_name        (int index) const { return field(index)->name(constants()); }
 325   Symbol* field_signature   (int index) const { return field(index)->signature(constants()); }
 326 
 327   // Number of Java declared fields
 328   int java_fields_count() const           { return (int)_java_fields_count; }
 329 
 330   // Number of fields including any injected fields
 331   int all_fields_count() const            { return _fields->length() / sizeof(FieldInfo::field_slots); }
 332 
 333   typeArrayOop fields() const              { return _fields; }
 334 
 335   void set_fields(typeArrayOop f, u2 java_fields_count) {
 336     oop_store_without_check((oop*) &_fields, (oop) f);
 337     _java_fields_count = java_fields_count;
 338   }
 339 
 340   // inner classes
 341   typeArrayOop inner_classes() const       { return _inner_classes; }
 342   void set_inner_classes(typeArrayOop f)   { oop_store_without_check((oop*) &_inner_classes, (oop) f); }
 343 
 344   enum InnerClassAttributeOffset {
 345     // From http://mirror.eng/products/jdk/1.1/docs/guide/innerclasses/spec/innerclasses.doc10.html#18814
 346     inner_class_inner_class_info_offset = 0,
 347     inner_class_outer_class_info_offset = 1,
 348     inner_class_inner_name_offset = 2,
 349     inner_class_access_flags_offset = 3,
 350     inner_class_next_offset = 4
 351   };
 352 
 353   // method override check
 354   bool is_override(methodHandle super_method, Handle targetclassloader, Symbol* targetclassname, TRAPS);
 355 
 356   // package
 357   bool is_same_class_package(klassOop class2);
 358   bool is_same_class_package(oop classloader2, Symbol* classname2);
 359   static bool is_same_class_package(oop class_loader1, Symbol* class_name1, oop class_loader2, Symbol* class_name2);
 360 
 361   // find an enclosing class (defined where original code was, in jvm.cpp!)
 362   klassOop compute_enclosing_class(bool* inner_is_member, TRAPS) {
 363     instanceKlassHandle self(THREAD, this->as_klassOop());
 364     return compute_enclosing_class_impl(self, inner_is_member, THREAD);
 365   }
 366   static klassOop compute_enclosing_class_impl(instanceKlassHandle self,
 367                                                bool* inner_is_member, TRAPS);
 368 
 369   // tell if two classes have the same enclosing class (at package level)
 370   bool is_same_package_member(klassOop class2, TRAPS) {
 371     instanceKlassHandle self(THREAD, this->as_klassOop());
 372     return is_same_package_member_impl(self, class2, THREAD);
 373   }
 374   static bool is_same_package_member_impl(instanceKlassHandle self,
 375                                           klassOop class2, TRAPS);
 376 
 377   // initialization state
 378   bool is_loaded() const                   { return _init_state >= loaded; }
 379   bool is_linked() const                   { return _init_state >= linked; }
 380   bool is_initialized() const              { return _init_state == fully_initialized; }
 381   bool is_not_initialized() const          { return _init_state <  being_initialized; }
 382   bool is_being_initialized() const        { return _init_state == being_initialized; }
 383   bool is_in_error_state() const           { return _init_state == initialization_error; }
 384   bool is_reentrant_initialization(Thread *thread)  { return thread == _init_thread; }
 385   ClassState  init_state()                 { return (ClassState)_init_state; }
 386   bool is_rewritten() const                { return _rewritten; }
 387 
 388   // defineClass specified verification
 389   bool should_verify_class() const         { return _should_verify_class; }
 390   void set_should_verify_class(bool value) { _should_verify_class = value; }
 391 
 392   // marking
 393   bool is_marked_dependent() const         { return _is_marked_dependent; }
 394   void set_is_marked_dependent(bool value) { _is_marked_dependent = value; }
 395 
 396   // initialization (virtuals from Klass)
 397   bool should_be_initialized() const;  // means that initialize should be called
 398   void initialize(TRAPS);
 399   void link_class(TRAPS);
 400   bool link_class_or_fail(TRAPS); // returns false on failure
 401   void unlink_class();
 402   void rewrite_class(TRAPS);
 403   void relocate_and_link_methods(TRAPS);
 404   methodOop class_initializer();
 405 
 406   // set the class to initialized if no static initializer is present
 407   void eager_initialize(Thread *thread);
 408 
 409   // reference type
 410   ReferenceType reference_type() const     { return _reference_type; }
 411   void set_reference_type(ReferenceType t) { _reference_type = t; }
 412 
 413   static ByteSize reference_type_offset() { return in_ByteSize(sizeof(klassOopDesc) + offset_of(instanceKlass, _reference_type)); }
 414 
 415   // find local field, returns true if found
 416   bool find_local_field(Symbol* name, Symbol* sig, fieldDescriptor* fd) const;
 417   // find field in direct superinterfaces, returns the interface in which the field is defined
 418   klassOop find_interface_field(Symbol* name, Symbol* sig, fieldDescriptor* fd) const;
 419   // find field according to JVM spec 5.4.3.2, returns the klass in which the field is defined
 420   klassOop find_field(Symbol* name, Symbol* sig, fieldDescriptor* fd) const;
 421   // find instance or static fields according to JVM spec 5.4.3.2, returns the klass in which the field is defined
 422   klassOop find_field(Symbol* name, Symbol* sig, bool is_static, fieldDescriptor* fd) const;
 423 
 424   // find a non-static or static field given its offset within the class.
 425   bool contains_field_offset(int offset) {
 426     return instanceOopDesc::contains_field_offset(offset, nonstatic_field_size());
 427   }
 428 
 429   bool find_local_field_from_offset(int offset, bool is_static, fieldDescriptor* fd) const;
 430   bool find_field_from_offset(int offset, bool is_static, fieldDescriptor* fd) const;
 431 
 432   // find a local method (returns NULL if not found)
 433   methodOop find_method(Symbol* name, Symbol* signature) const;
 434   static methodOop find_method(objArrayOop methods, Symbol* name, Symbol* signature);
 435 
 436   // lookup operation (returns NULL if not found)
 437   methodOop uncached_lookup_method(Symbol* name, Symbol* signature) const;
 438 
 439   // lookup a method in all the interfaces that this class implements
 440   // (returns NULL if not found)
 441   methodOop lookup_method_in_all_interfaces(Symbol* name, Symbol* signature) const;
 442 
 443   // constant pool
 444   constantPoolOop constants() const        { return _constants; }
 445   void set_constants(constantPoolOop c)    { oop_store_without_check((oop*) &_constants, (oop) c); }
 446 
 447   // class loader
 448   oop class_loader() const                 { return _class_loader; }
 449   void set_class_loader(oop l)             { oop_store((oop*) &_class_loader, l); }
 450 
 451   // protection domain
 452   oop protection_domain()                  { return _protection_domain; }
 453   void set_protection_domain(oop pd)       { oop_store((oop*) &_protection_domain, pd); }
 454 
 455   // host class
 456   oop host_klass() const                   { return _host_klass; }
 457   void set_host_klass(oop host)            { oop_store((oop*) &_host_klass, host); }
 458   bool is_anonymous() const                { return _host_klass != NULL; }
 459 
 460   // signers
 461   objArrayOop signers() const              { return _signers; }
 462   void set_signers(objArrayOop s)          { oop_store((oop*) &_signers, oop(s)); }
 463 
 464   // source file name
 465   Symbol* source_file_name() const         { return _source_file_name; }
 466   void set_source_file_name(Symbol* n);
 467 
 468   // minor and major version numbers of class file
 469   u2 minor_version() const                 { return _minor_version; }
 470   void set_minor_version(u2 minor_version) { _minor_version = minor_version; }
 471   u2 major_version() const                 { return _major_version; }
 472   void set_major_version(u2 major_version) { _major_version = major_version; }
 473 
 474   // source debug extension
 475   Symbol* source_debug_extension() const   { return _source_debug_extension; }
 476   void set_source_debug_extension(Symbol* n);
 477 
 478   // symbol unloading support (refcount already added)
 479   Symbol* array_name()                     { return _array_name; }
 480   void set_array_name(Symbol* name)        { assert(_array_name == NULL, "name already created"); _array_name = name; }
 481 
 482   // nonstatic oop-map blocks
 483   static int nonstatic_oop_map_size(unsigned int oop_map_count) {
 484     return oop_map_count * OopMapBlock::size_in_words();
 485   }
 486   unsigned int nonstatic_oop_map_count() const {
 487     return _nonstatic_oop_map_size / OopMapBlock::size_in_words();
 488   }
 489   int nonstatic_oop_map_size() const { return _nonstatic_oop_map_size; }
 490   void set_nonstatic_oop_map_size(int words) {
 491     _nonstatic_oop_map_size = words;
 492   }
 493 
 494   // RedefineClasses() support for previous versions:
 495   void add_previous_version(instanceKlassHandle ikh, BitMap *emcp_methods,
 496          int emcp_method_count);
 497   // If the _previous_versions array is non-NULL, then this klass
 498   // has been redefined at least once even if we aren't currently
 499   // tracking a previous version.
 500   bool has_been_redefined() const { return _previous_versions != NULL; }
 501   bool has_previous_version() const;
 502   void init_previous_versions() {
 503     _previous_versions = NULL;
 504   }
 505   GrowableArray<PreviousVersionNode *>* previous_versions() const {
 506     return _previous_versions;
 507   }
 508 
 509   // JVMTI: Support for caching a class file before it is modified by an agent that can do retransformation
 510   void set_cached_class_file(unsigned char *class_file_bytes,
 511                              jint class_file_len)     { _cached_class_file_len = class_file_len;
 512                                                         _cached_class_file_bytes = class_file_bytes; }
 513   jint get_cached_class_file_len()                    { return _cached_class_file_len; }
 514   unsigned char * get_cached_class_file_bytes()       { return _cached_class_file_bytes; }
 515 
 516   // JVMTI: Support for caching of field indices, types, and offsets
 517   void set_jvmti_cached_class_field_map(JvmtiCachedClassFieldMap* descriptor) {
 518     _jvmti_cached_class_field_map = descriptor;
 519   }
 520   JvmtiCachedClassFieldMap* jvmti_cached_class_field_map() const {
 521     return _jvmti_cached_class_field_map;
 522   }
 523 
 524   // for adding methods, constMethodOopDesc::UNSET_IDNUM means no more ids available
 525   inline u2 next_method_idnum();
 526   void set_initial_method_idnum(u2 value)             { _idnum_allocated_count = value; }
 527 
 528   // generics support
 529   Symbol* generic_signature() const                   { return _generic_signature; }
 530   void set_generic_signature(Symbol* sig)             { _generic_signature = sig; }
 531 
 532   u2 enclosing_method_class_index() const             { return _enclosing_method_class_index; }
 533   u2 enclosing_method_method_index() const            { return _enclosing_method_method_index; }
 534   void set_enclosing_method_indices(u2 class_index,
 535                                     u2 method_index)  { _enclosing_method_class_index  = class_index;
 536                                                         _enclosing_method_method_index = method_index; }
 537 
 538   // jmethodID support
 539   static jmethodID get_jmethod_id(instanceKlassHandle ik_h,
 540                      methodHandle method_h);
 541   static jmethodID get_jmethod_id_fetch_or_update(instanceKlassHandle ik_h,
 542                      size_t idnum, jmethodID new_id, jmethodID* new_jmeths,
 543                      jmethodID* to_dealloc_id_p,
 544                      jmethodID** to_dealloc_jmeths_p);
 545   static void get_jmethod_id_length_value(jmethodID* cache, size_t idnum,
 546                 size_t *length_p, jmethodID* id_p);
 547   jmethodID jmethod_id_or_null(methodOop method);
 548 
 549   // cached itable index support
 550   void set_cached_itable_index(size_t idnum, int index);
 551   int cached_itable_index(size_t idnum);
 552 
 553   // annotations support
 554   typeArrayOop class_annotations() const              { return _class_annotations; }
 555   objArrayOop fields_annotations() const              { return _fields_annotations; }
 556   objArrayOop methods_annotations() const             { return _methods_annotations; }
 557   objArrayOop methods_parameter_annotations() const   { return _methods_parameter_annotations; }
 558   objArrayOop methods_default_annotations() const     { return _methods_default_annotations; }
 559   void set_class_annotations(typeArrayOop md)            { oop_store_without_check((oop*)&_class_annotations, (oop)md); }
 560   void set_fields_annotations(objArrayOop md)            { set_annotations(md, &_fields_annotations); }
 561   void set_methods_annotations(objArrayOop md)           { set_annotations(md, &_methods_annotations); }
 562   void set_methods_parameter_annotations(objArrayOop md) { set_annotations(md, &_methods_parameter_annotations); }
 563   void set_methods_default_annotations(objArrayOop md)   { set_annotations(md, &_methods_default_annotations); }
 564   typeArrayOop get_method_annotations_of(int idnum)
 565                                                 { return get_method_annotations_from(idnum, _methods_annotations); }
 566   typeArrayOop get_method_parameter_annotations_of(int idnum)
 567                                                 { return get_method_annotations_from(idnum, _methods_parameter_annotations); }
 568   typeArrayOop get_method_default_annotations_of(int idnum)
 569                                                 { return get_method_annotations_from(idnum, _methods_default_annotations); }
 570   void set_method_annotations_of(int idnum, typeArrayOop anno)
 571                                                 { set_methods_annotations_of(idnum, anno, &_methods_annotations); }
 572   void set_method_parameter_annotations_of(int idnum, typeArrayOop anno)
 573                                                 { set_methods_annotations_of(idnum, anno, &_methods_annotations); }
 574   void set_method_default_annotations_of(int idnum, typeArrayOop anno)
 575                                                 { set_methods_annotations_of(idnum, anno, &_methods_annotations); }
 576 
 577   // allocation
 578   DEFINE_ALLOCATE_PERMANENT(instanceKlass);
 579   instanceOop allocate_instance(TRAPS);
 580   instanceOop allocate_permanent_instance(TRAPS);
 581 
 582   // additional member function to return a handle
 583   instanceHandle allocate_instance_handle(TRAPS)      { return instanceHandle(THREAD, allocate_instance(THREAD)); }
 584 
 585   objArrayOop allocate_objArray(int n, int length, TRAPS);
 586   // Helper function
 587   static instanceOop register_finalizer(instanceOop i, TRAPS);
 588 
 589   // Check whether reflection/jni/jvm code is allowed to instantiate this class;
 590   // if not, throw either an Error or an Exception.
 591   virtual void check_valid_for_instantiation(bool throwError, TRAPS);
 592 
 593   // initialization
 594   void call_class_initializer(TRAPS);
 595   void set_initialization_state_and_notify(ClassState state, TRAPS);
 596 
 597   // OopMapCache support
 598   OopMapCache* oop_map_cache()               { return _oop_map_cache; }
 599   void set_oop_map_cache(OopMapCache *cache) { _oop_map_cache = cache; }
 600   void mask_for(methodHandle method, int bci, InterpreterOopMap* entry);
 601 
 602   // JNI identifier support (for static fields - for jni performance)
 603   JNIid* jni_ids()                               { return _jni_ids; }
 604   void set_jni_ids(JNIid* ids)                   { _jni_ids = ids; }
 605   JNIid* jni_id_for(int offset);
 606 
 607   // maintenance of deoptimization dependencies
 608   int mark_dependent_nmethods(DepChange& changes);
 609   void add_dependent_nmethod(nmethod* nm);
 610   void remove_dependent_nmethod(nmethod* nm);
 611 
 612   // On-stack replacement support
 613   nmethod* osr_nmethods_head() const         { return _osr_nmethods_head; };
 614   void set_osr_nmethods_head(nmethod* h)     { _osr_nmethods_head = h; };
 615   void add_osr_nmethod(nmethod* n);
 616   void remove_osr_nmethod(nmethod* n);
 617   nmethod* lookup_osr_nmethod(const methodOop m, int bci, int level, bool match_level) const;
 618 
 619   // Breakpoint support (see methods on methodOop for details)
 620   BreakpointInfo* breakpoints() const       { return _breakpoints; };
 621   void set_breakpoints(BreakpointInfo* bps) { _breakpoints = bps; };
 622 
 623   // support for stub routines
 624   static ByteSize init_state_offset()  { return in_ByteSize(sizeof(klassOopDesc) + offset_of(instanceKlass, _init_state)); }
 625   static ByteSize init_thread_offset() { return in_ByteSize(sizeof(klassOopDesc) + offset_of(instanceKlass, _init_thread)); }
 626 
 627   // subclass/subinterface checks
 628   bool implements_interface(klassOop k) const;
 629 
 630   // Access to implementors of an interface. We only store the count
 631   // of implementors, and in case, there are only a few
 632   // implementors, we store them in a short list.
 633   // This accessor returns NULL if we walk off the end of the list.
 634   klassOop implementor(int i) const {
 635     return (i < implementors_limit)? _implementors[i]: (klassOop) NULL;
 636   }
 637   int  nof_implementors() const       { return _nof_implementors; }
 638   void add_implementor(klassOop k);  // k is a new class that implements this interface
 639   void init_implementor();           // initialize
 640 
 641   // link this class into the implementors list of every interface it implements
 642   void process_interfaces(Thread *thread);
 643 
 644   // virtual operations from Klass
 645   bool is_leaf_class() const               { return _subklass == NULL; }
 646   objArrayOop compute_secondary_supers(int num_extra_slots, TRAPS);
 647   bool compute_is_subtype_of(klassOop k);
 648   bool can_be_primary_super_slow() const;
 649   klassOop java_super() const              { return super(); }
 650   int oop_size(oop obj)  const             { return size_helper(); }
 651   int klass_oop_size() const               { return object_size(); }
 652   bool oop_is_instance_slow() const        { return true; }
 653 
 654   // Iterators
 655   void do_local_static_fields(FieldClosure* cl);
 656   void do_nonstatic_fields(FieldClosure* cl); // including inherited fields
 657   void do_local_static_fields(void f(fieldDescriptor*, TRAPS), TRAPS);
 658 
 659   void methods_do(void f(methodOop method));
 660   void array_klasses_do(void f(klassOop k));
 661   void with_array_klasses_do(void f(klassOop k));
 662   bool super_types_do(SuperTypeClosure* blk);
 663 
 664   // Casting from klassOop
 665   static instanceKlass* cast(klassOop k) {
 666     assert(k->is_klass(), "must be");
 667     Klass* kp = k->klass_part();
 668     assert(kp->null_vtbl() || kp->oop_is_instance_slow(), "cast to instanceKlass");
 669     return (instanceKlass*) kp;
 670   }
 671 
 672   // Sizing (in words)
 673   static int header_size()            { return align_object_offset(oopDesc::header_size() + sizeof(instanceKlass)/HeapWordSize); }
 674   int object_size() const             { return object_size(align_object_offset(vtable_length()) + align_object_offset(itable_length()) + nonstatic_oop_map_size()); }
 675   static int vtable_start_offset()    { return header_size(); }
 676   static int vtable_length_offset()   { return oopDesc::header_size() + offset_of(instanceKlass, _vtable_len) / HeapWordSize; }
 677   static int object_size(int extra)   { return align_object_size(header_size() + extra); }
 678 
 679   intptr_t* start_of_vtable() const        { return ((intptr_t*)as_klassOop()) + vtable_start_offset(); }
 680   intptr_t* start_of_itable() const        { return start_of_vtable() + align_object_offset(vtable_length()); }
 681   int  itable_offset_in_words() const { return start_of_itable() - (intptr_t*)as_klassOop(); }
 682 
 683   intptr_t* end_of_itable() const          { return start_of_itable() + itable_length(); }
 684 
 685   address static_field_addr(int offset);
 686 
 687   OopMapBlock* start_of_nonstatic_oop_maps() const {
 688     return (OopMapBlock*)(start_of_itable() + align_object_offset(itable_length()));
 689   }
 690 
 691   // Allocation profiling support
 692   juint alloc_size() const            { return _alloc_count * size_helper(); }
 693   void set_alloc_size(juint n)        {}
 694 
 695   // Use this to return the size of an instance in heap words:
 696   int size_helper() const {
 697     return layout_helper_to_size_helper(layout_helper());
 698   }
 699 
 700   // This bit is initialized in classFileParser.cpp.
 701   // It is false under any of the following conditions:
 702   //  - the class is abstract (including any interface)
 703   //  - the class has a finalizer (if !RegisterFinalizersAtInit)
 704   //  - the class size is larger than FastAllocateSizeLimit
 705   //  - the class is java/lang/Class, which cannot be allocated directly
 706   bool can_be_fastpath_allocated() const {
 707     return !layout_helper_needs_slow_path(layout_helper());
 708   }
 709 
 710   // Java vtable/itable
 711   klassVtable* vtable() const;        // return new klassVtable wrapper
 712   inline methodOop method_at_vtable(int index);
 713   klassItable* itable() const;        // return new klassItable wrapper
 714   methodOop method_at_itable(klassOop holder, int index, TRAPS);
 715 
 716   // Garbage collection
 717   void oop_follow_contents(oop obj);
 718   int  oop_adjust_pointers(oop obj);
 719   bool object_is_parsable() const { return _init_state != unparsable_by_gc; }
 720        // Value of _init_state must be zero (unparsable_by_gc) when klass field is set.
 721 
 722   void follow_weak_klass_links(
 723     BoolObjectClosure* is_alive, OopClosure* keep_alive);
 724   void release_C_heap_structures();
 725 
 726   // Parallel Scavenge and Parallel Old
 727   PARALLEL_GC_DECLS
 728 
 729   // Naming
 730   const char* signature_name() const;
 731 
 732   // Iterators
 733   int oop_oop_iterate(oop obj, OopClosure* blk) {
 734     return oop_oop_iterate_v(obj, blk);
 735   }
 736 
 737   int oop_oop_iterate_m(oop obj, OopClosure* blk, MemRegion mr) {
 738     return oop_oop_iterate_v_m(obj, blk, mr);
 739   }
 740 
 741 #define InstanceKlass_OOP_OOP_ITERATE_DECL(OopClosureType, nv_suffix)      \
 742   int  oop_oop_iterate##nv_suffix(oop obj, OopClosureType* blk);           \
 743   int  oop_oop_iterate##nv_suffix##_m(oop obj, OopClosureType* blk,        \
 744                                       MemRegion mr);
 745 
 746   ALL_OOP_OOP_ITERATE_CLOSURES_1(InstanceKlass_OOP_OOP_ITERATE_DECL)
 747   ALL_OOP_OOP_ITERATE_CLOSURES_2(InstanceKlass_OOP_OOP_ITERATE_DECL)
 748 
 749 #ifndef SERIALGC
 750 #define InstanceKlass_OOP_OOP_ITERATE_BACKWARDS_DECL(OopClosureType, nv_suffix) \
 751   int  oop_oop_iterate_backwards##nv_suffix(oop obj, OopClosureType* blk);
 752 
 753   ALL_OOP_OOP_ITERATE_CLOSURES_1(InstanceKlass_OOP_OOP_ITERATE_BACKWARDS_DECL)
 754   ALL_OOP_OOP_ITERATE_CLOSURES_2(InstanceKlass_OOP_OOP_ITERATE_BACKWARDS_DECL)
 755 #endif // !SERIALGC
 756 
 757 private:
 758   // initialization state
 759 #ifdef ASSERT
 760   void set_init_state(ClassState state);
 761 #else
 762   void set_init_state(ClassState state) { _init_state = (u1)state; }
 763 #endif
 764   void set_rewritten()                  { _rewritten = true; }
 765   void set_init_thread(Thread *thread)  { _init_thread = thread; }
 766 
 767   u2 idnum_allocated_count() const      { return _idnum_allocated_count; }
 768   // The RedefineClasses() API can cause new method idnums to be needed
 769   // which will cause the caches to grow. Safety requires different
 770   // cache management logic if the caches can grow instead of just
 771   // going from NULL to non-NULL.
 772   bool idnum_can_increment() const      { return has_been_redefined(); }
 773   jmethodID* methods_jmethod_ids_acquire() const
 774          { return (jmethodID*)OrderAccess::load_ptr_acquire(&_methods_jmethod_ids); }
 775   void release_set_methods_jmethod_ids(jmethodID* jmeths)
 776          { OrderAccess::release_store_ptr(&_methods_jmethod_ids, jmeths); }
 777 
 778   int* methods_cached_itable_indices_acquire() const
 779          { return (int*)OrderAccess::load_ptr_acquire(&_methods_cached_itable_indices); }
 780   void release_set_methods_cached_itable_indices(int* indices)
 781          { OrderAccess::release_store_ptr(&_methods_cached_itable_indices, indices); }
 782 
 783   inline typeArrayOop get_method_annotations_from(int idnum, objArrayOop annos);
 784   void set_annotations(objArrayOop md, objArrayOop* md_p)  { oop_store_without_check((oop*)md_p, (oop)md); }
 785   void set_methods_annotations_of(int idnum, typeArrayOop anno, objArrayOop* md_p);
 786 
 787   // Offsets for memory management
 788   oop* adr_array_klasses() const     { return (oop*)&this->_array_klasses;}
 789   oop* adr_methods() const           { return (oop*)&this->_methods;}
 790   oop* adr_method_ordering() const   { return (oop*)&this->_method_ordering;}
 791   oop* adr_local_interfaces() const  { return (oop*)&this->_local_interfaces;}
 792   oop* adr_transitive_interfaces() const  { return (oop*)&this->_transitive_interfaces;}
 793   oop* adr_fields() const            { return (oop*)&this->_fields;}
 794   oop* adr_constants() const         { return (oop*)&this->_constants;}
 795   oop* adr_class_loader() const      { return (oop*)&this->_class_loader;}
 796   oop* adr_protection_domain() const { return (oop*)&this->_protection_domain;}
 797   oop* adr_host_klass() const        { return (oop*)&this->_host_klass;}
 798   oop* adr_signers() const           { return (oop*)&this->_signers;}
 799   oop* adr_inner_classes() const     { return (oop*)&this->_inner_classes;}
 800   oop* adr_implementors() const      { return (oop*)&this->_implementors[0];}
 801   oop* adr_methods_jmethod_ids() const             { return (oop*)&this->_methods_jmethod_ids;}
 802   oop* adr_methods_cached_itable_indices() const   { return (oop*)&this->_methods_cached_itable_indices;}
 803   oop* adr_class_annotations() const   { return (oop*)&this->_class_annotations;}
 804   oop* adr_fields_annotations() const  { return (oop*)&this->_fields_annotations;}
 805   oop* adr_methods_annotations() const { return (oop*)&this->_methods_annotations;}
 806   oop* adr_methods_parameter_annotations() const { return (oop*)&this->_methods_parameter_annotations;}
 807   oop* adr_methods_default_annotations() const { return (oop*)&this->_methods_default_annotations;}
 808 
 809   // Static methods that are used to implement member methods where an exposed this pointer
 810   // is needed due to possible GCs
 811   static bool link_class_impl                           (instanceKlassHandle this_oop, bool throw_verifyerror, TRAPS);
 812   static bool verify_code                               (instanceKlassHandle this_oop, bool throw_verifyerror, TRAPS);
 813   static void initialize_impl                           (instanceKlassHandle this_oop, TRAPS);
 814   static void eager_initialize_impl                     (instanceKlassHandle this_oop);
 815   static void set_initialization_state_and_notify_impl  (instanceKlassHandle this_oop, ClassState state, TRAPS);
 816   static void call_class_initializer_impl               (instanceKlassHandle this_oop, TRAPS);
 817   static klassOop array_klass_impl                      (instanceKlassHandle this_oop, bool or_null, int n, TRAPS);
 818   static void do_local_static_fields_impl               (instanceKlassHandle this_oop, void f(fieldDescriptor* fd, TRAPS), TRAPS);
 819   /* jni_id_for_impl for jfieldID only */
 820   static JNIid* jni_id_for_impl                         (instanceKlassHandle this_oop, int offset);
 821 
 822   // Returns the array class for the n'th dimension
 823   klassOop array_klass_impl(bool or_null, int n, TRAPS);
 824 
 825   // Returns the array class with this class as element type
 826   klassOop array_klass_impl(bool or_null, TRAPS);
 827 
 828 public:
 829   // sharing support
 830   virtual void remove_unshareable_info();
 831   virtual void shared_symbols_iterate(SymbolClosure* closure);
 832 
 833   // jvm support
 834   jint compute_modifier_flags(TRAPS) const;
 835 
 836 public:
 837   // JVMTI support
 838   jint jvmti_class_status() const;
 839 
 840  public:
 841   // Printing
 842   void oop_print_value_on(oop obj, outputStream* st);
 843 #ifndef PRODUCT
 844   void oop_print_on      (oop obj, outputStream* st);
 845 
 846   void print_dependent_nmethods(bool verbose = false);
 847   bool is_dependent_nmethod(nmethod* nm);
 848 #endif
 849 
 850   // Verification
 851   const char* internal_name() const;
 852   void oop_verify_on(oop obj, outputStream* st);
 853 };
 854 
 855 inline methodOop instanceKlass::method_at_vtable(int index)  {
 856 #ifndef PRODUCT
 857   assert(index >= 0, "valid vtable index");
 858   if (DebugVtables) {
 859     verify_vtable_index(index);
 860   }
 861 #endif
 862   vtableEntry* ve = (vtableEntry*)start_of_vtable();
 863   return ve[index].method();
 864 }
 865 
 866 inline typeArrayOop instanceKlass::get_method_annotations_from(int idnum, objArrayOop annos) {
 867   if (annos == NULL || annos->length() <= idnum) {
 868     return NULL;
 869   }
 870   return typeArrayOop(annos->obj_at(idnum));
 871 }
 872 
 873 // for adding methods
 874 // UNSET_IDNUM return means no more ids available
 875 inline u2 instanceKlass::next_method_idnum() {
 876   if (_idnum_allocated_count == constMethodOopDesc::MAX_IDNUM) {
 877     return constMethodOopDesc::UNSET_IDNUM; // no more ids available
 878   } else {
 879     return _idnum_allocated_count++;
 880   }
 881 }
 882 
 883 
 884 /* JNIid class for jfieldIDs only */
 885 class JNIid: public CHeapObj {
 886   friend class VMStructs;
 887  private:
 888   klassOop           _holder;
 889   JNIid*             _next;
 890   int                _offset;
 891 #ifdef ASSERT
 892   bool               _is_static_field_id;
 893 #endif
 894 
 895  public:
 896   // Accessors
 897   klassOop holder() const         { return _holder; }
 898   int offset() const              { return _offset; }
 899   JNIid* next()                   { return _next; }
 900   // Constructor
 901   JNIid(klassOop holder, int offset, JNIid* next);
 902   // Identifier lookup
 903   JNIid* find(int offset);
 904 
 905   bool find_local_field(fieldDescriptor* fd) {
 906     return instanceKlass::cast(holder())->find_local_field_from_offset(offset(), true, fd);
 907   }
 908 
 909   // Garbage collection support
 910   oop* holder_addr() { return (oop*)&_holder; }
 911   void oops_do(OopClosure* f);
 912   static void deallocate(JNIid* id);
 913   // Debugging
 914 #ifdef ASSERT
 915   bool is_static_field_id() const { return _is_static_field_id; }
 916   void set_is_static_field_id()   { _is_static_field_id = true; }
 917 #endif
 918   void verify(klassOop holder);
 919 };
 920 
 921 
 922 // If breakpoints are more numerous than just JVMTI breakpoints,
 923 // consider compressing this data structure.
 924 // It is currently a simple linked list defined in methodOop.hpp.
 925 
 926 class BreakpointInfo;
 927 
 928 
 929 // A collection point for interesting information about the previous
 930 // version(s) of an instanceKlass. This class uses weak references to
 931 // the information so that the information may be collected as needed
 932 // by the system. If the information is shared, then a regular
 933 // reference must be used because a weak reference would be seen as
 934 // collectible. A GrowableArray of PreviousVersionNodes is attached
 935 // to the instanceKlass as needed. See PreviousVersionWalker below.
 936 class PreviousVersionNode : public CHeapObj {
 937  private:
 938   // A shared ConstantPool is never collected so we'll always have
 939   // a reference to it so we can update items in the cache. We'll
 940   // have a weak reference to a non-shared ConstantPool until all
 941   // of the methods (EMCP or obsolete) have been collected; the
 942   // non-shared ConstantPool becomes collectible at that point.
 943   jobject _prev_constant_pool;  // regular or weak reference
 944   bool    _prev_cp_is_weak;     // true if not a shared ConstantPool
 945 
 946   // If the previous version of the instanceKlass doesn't have any
 947   // EMCP methods, then _prev_EMCP_methods will be NULL. If all the
 948   // EMCP methods have been collected, then _prev_EMCP_methods can
 949   // have a length of zero.
 950   GrowableArray<jweak>* _prev_EMCP_methods;
 951 
 952 public:
 953   PreviousVersionNode(jobject prev_constant_pool, bool prev_cp_is_weak,
 954     GrowableArray<jweak>* prev_EMCP_methods);
 955   ~PreviousVersionNode();
 956   jobject prev_constant_pool() const {
 957     return _prev_constant_pool;
 958   }
 959   GrowableArray<jweak>* prev_EMCP_methods() const {
 960     return _prev_EMCP_methods;
 961   }
 962 };
 963 
 964 
 965 // A Handle-ized version of PreviousVersionNode.
 966 class PreviousVersionInfo : public ResourceObj {
 967  private:
 968   constantPoolHandle   _prev_constant_pool_handle;
 969   // If the previous version of the instanceKlass doesn't have any
 970   // EMCP methods, then _prev_EMCP_methods will be NULL. Since the
 971   // methods cannot be collected while we hold a handle,
 972   // _prev_EMCP_methods should never have a length of zero.
 973   GrowableArray<methodHandle>* _prev_EMCP_method_handles;
 974 
 975 public:
 976   PreviousVersionInfo(PreviousVersionNode *pv_node);
 977   ~PreviousVersionInfo();
 978   constantPoolHandle prev_constant_pool_handle() const {
 979     return _prev_constant_pool_handle;
 980   }
 981   GrowableArray<methodHandle>* prev_EMCP_method_handles() const {
 982     return _prev_EMCP_method_handles;
 983   }
 984 };
 985 
 986 
 987 // Helper object for walking previous versions. This helper cleans up
 988 // the Handles that it allocates when the helper object is destroyed.
 989 // The PreviousVersionInfo object returned by next_previous_version()
 990 // is only valid until a subsequent call to next_previous_version() or
 991 // the helper object is destroyed.
 992 class PreviousVersionWalker : public StackObj {
 993  private:
 994   GrowableArray<PreviousVersionNode *>* _previous_versions;
 995   int                                   _current_index;
 996   // Fields for cleaning up when we are done walking the previous versions:
 997   // A HandleMark for the PreviousVersionInfo handles:
 998   HandleMark                            _hm;
 999 
1000   // It would be nice to have a ResourceMark field in this helper also,
1001   // but the ResourceMark code says to be careful to delete handles held
1002   // in GrowableArrays _before_ deleting the GrowableArray. Since we
1003   // can't guarantee the order in which the fields are destroyed, we
1004   // have to let the creator of the PreviousVersionWalker object do
1005   // the right thing. Also, adding a ResourceMark here causes an
1006   // include loop.
1007 
1008   // A pointer to the current info object so we can handle the deletes.
1009   PreviousVersionInfo *                 _current_p;
1010 
1011  public:
1012   PreviousVersionWalker(instanceKlass *ik);
1013   ~PreviousVersionWalker();
1014 
1015   // Return the interesting information for the next previous version
1016   // of the klass. Returns NULL if there are no more previous versions.
1017   PreviousVersionInfo* next_previous_version();
1018 };
1019 
1020 
1021 //
1022 // nmethodBucket is used to record dependent nmethods for
1023 // deoptimization.  nmethod dependencies are actually <klass, method>
1024 // pairs but we really only care about the klass part for purposes of
1025 // finding nmethods which might need to be deoptimized.  Instead of
1026 // recording the method, a count of how many times a particular nmethod
1027 // was recorded is kept.  This ensures that any recording errors are
1028 // noticed since an nmethod should be removed as many times are it's
1029 // added.
1030 //
1031 class nmethodBucket: public CHeapObj {
1032   friend class VMStructs;
1033  private:
1034   nmethod*       _nmethod;
1035   int            _count;
1036   nmethodBucket* _next;
1037 
1038  public:
1039   nmethodBucket(nmethod* nmethod, nmethodBucket* next) {
1040     _nmethod = nmethod;
1041     _next = next;
1042     _count = 1;
1043   }
1044   int count()                             { return _count; }
1045   int increment()                         { _count += 1; return _count; }
1046   int decrement()                         { _count -= 1; assert(_count >= 0, "don't underflow"); return _count; }
1047   nmethodBucket* next()                   { return _next; }
1048   void set_next(nmethodBucket* b)         { _next = b; }
1049   nmethod* get_nmethod()                  { return _nmethod; }
1050 };
1051 
1052 #endif // SHARE_VM_OOPS_INSTANCEKLASS_HPP