src/share/vm/oops/instanceKlass.hpp

Fri, 27 Feb 2009 13:27:09 -0800

author
twisti
date
Fri, 27 Feb 2009 13:27:09 -0800
changeset 1040
98cb887364d3
parent 866
a45484ea312d
child 1087
4aaa9f5e02a8
child 1100
c89f86385056
permissions
-rw-r--r--

6810672: Comment typos
Summary: I have collected some typos I have found while looking at the code.
Reviewed-by: kvn, never

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

mercurial