Fri, 04 Sep 2009 12:53:02 -0400
6830542: Performance: JVM_DefineClass already verified.
Reviewed-by: kamg, phh
1 /*
2 * Copyright 1997-2009 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 // smaller footprint for boolean flags
118 enum ClassFlags {
119 _noflags = 0, // initial value
120 _rewritten = 0x00000001U, // rewritten
121 _should_verify = 0x00000002U, // defineClass specified conditional verification
122 _has_nonstatic_fields = 0x00000004U, // for sizing with UseCompressedOops
123 _is_marked_dependent = 0x00000008U // used for marking during flushing and deoptimization
124 };
126 public:
127 oop* oop_block_beg() const { return adr_array_klasses(); }
128 oop* oop_block_end() const { return adr_methods_default_annotations() + 1; }
130 enum {
131 implementors_limit = 2 // how many implems can we track?
132 };
134 protected:
135 //
136 // The oop block. See comment in klass.hpp before making changes.
137 //
139 // Array classes holding elements of this class.
140 klassOop _array_klasses;
141 // Method array.
142 objArrayOop _methods;
143 // Int array containing the original order of method in the class file (for
144 // JVMTI).
145 typeArrayOop _method_ordering;
146 // Interface (klassOops) this class declares locally to implement.
147 objArrayOop _local_interfaces;
148 // Interface (klassOops) this class implements transitively.
149 objArrayOop _transitive_interfaces;
150 // Instance and static variable information, 5-tuples of shorts [access, name
151 // index, sig index, initval index, offset].
152 typeArrayOop _fields;
153 // Constant pool for this class.
154 constantPoolOop _constants;
155 // Class loader used to load this class, NULL if VM loader used.
156 oop _class_loader;
157 // Protection domain.
158 oop _protection_domain;
159 // Host class, which grants its access privileges to this class also.
160 // This is only non-null for an anonymous class (AnonymousClasses enabled).
161 // The host class is either named, or a previously loaded anonymous class.
162 klassOop _host_klass;
163 // Class signers.
164 objArrayOop _signers;
165 // Name of source file containing this klass, NULL if not specified.
166 symbolOop _source_file_name;
167 // the source debug extension for this klass, NULL if not specified.
168 symbolOop _source_debug_extension;
169 // inner_classes attribute.
170 typeArrayOop _inner_classes;
171 // Implementors of this interface (not valid if it overflows)
172 klassOop _implementors[implementors_limit];
173 // Generic signature, or null if none.
174 symbolOop _generic_signature;
175 // invokedynamic bootstrap method (a java.dyn.MethodHandle)
176 oop _bootstrap_method;
177 // Annotations for this class, or null if none.
178 typeArrayOop _class_annotations;
179 // Annotation objects (byte arrays) for fields, or null if no annotations.
180 // Indices correspond to entries (not indices) in fields array.
181 objArrayOop _fields_annotations;
182 // Annotation objects (byte arrays) for methods, or null if no annotations.
183 // Index is the idnum, which is initially the same as the methods array index.
184 objArrayOop _methods_annotations;
185 // Annotation objects (byte arrays) for methods' parameters, or null if no
186 // such annotations.
187 // Index is the idnum, which is initially the same as the methods array index.
188 objArrayOop _methods_parameter_annotations;
189 // Annotation objects (byte arrays) for methods' default values, or null if no
190 // such annotations.
191 // Index is the idnum, which is initially the same as the methods array index.
192 objArrayOop _methods_default_annotations;
194 //
195 // End of the oop block.
196 //
198 // Number of heapOopSize words used by non-static fields in this klass
199 // (including inherited fields but after header_size()).
200 int _nonstatic_field_size;
201 int _static_field_size; // number words used by static fields (oop and non-oop) in this klass
202 int _static_oop_field_size;// number of static oop fields in this klass
203 int _nonstatic_oop_map_size;// number of nonstatic oop-map blocks allocated at end of this klass
204 int _class_flags; // internal class state flags
205 u2 _minor_version; // minor version number of class file
206 u2 _major_version; // major version number of class file
207 ClassState _init_state; // state of class
208 Thread* _init_thread; // Pointer to current thread doing initialization (to handle recusive initialization)
209 int _vtable_len; // length of Java vtable (in words)
210 int _itable_len; // length of Java itable (in words)
211 ReferenceType _reference_type; // reference type
212 OopMapCache* volatile _oop_map_cache; // OopMapCache for all methods in the klass (allocated lazily)
213 JNIid* _jni_ids; // First JNI identifier for static fields in this class
214 jmethodID* _methods_jmethod_ids; // jmethodIDs corresponding to method_idnum, or NULL if none
215 int* _methods_cached_itable_indices; // itable_index cache for JNI invoke corresponding to methods idnum, or NULL
216 nmethodBucket* _dependencies; // list of dependent nmethods
217 nmethod* _osr_nmethods_head; // Head of list of on-stack replacement nmethods for this class
218 BreakpointInfo* _breakpoints; // bpt lists, managed by methodOop
219 int _nof_implementors; // No of implementors of this interface (zero if not an interface)
220 // Array of interesting part(s) of the previous version(s) of this
221 // instanceKlass. See PreviousVersionWalker below.
222 GrowableArray<PreviousVersionNode *>* _previous_versions;
223 u2 _enclosing_method_class_index; // Constant pool index for class of enclosing method, or 0 if none
224 u2 _enclosing_method_method_index; // Constant pool index for name and type of enclosing method, or 0 if none
225 // JVMTI fields can be moved to their own structure - see 6315920
226 unsigned char * _cached_class_file_bytes; // JVMTI: cached class file, before retransformable agent modified it in CFLH
227 jint _cached_class_file_len; // JVMTI: length of above
228 JvmtiCachedClassFieldMap* _jvmti_cached_class_field_map; // JVMTI: used during heap iteration
229 volatile u2 _idnum_allocated_count; // JNI/JVMTI: increments with the addition of methods, old ids don't change
231 // embedded Java vtable follows here
232 // embedded Java itables follows here
233 // embedded static fields follows here
234 // embedded nonstatic oop-map blocks follows here
236 friend class instanceKlassKlass;
237 friend class SystemDictionary;
239 public:
240 bool has_nonstatic_fields() const { return (_class_flags & _has_nonstatic_fields) != 0; }
241 void set_has_nonstatic_fields() { _class_flags |= _has_nonstatic_fields; }
243 // field sizes
244 int nonstatic_field_size() const { return _nonstatic_field_size; }
245 void set_nonstatic_field_size(int size) { _nonstatic_field_size = size; }
247 int static_field_size() const { return _static_field_size; }
248 void set_static_field_size(int size) { _static_field_size = size; }
250 int static_oop_field_size() const { return _static_oop_field_size; }
251 void set_static_oop_field_size(int size) { _static_oop_field_size = size; }
253 // Java vtable
254 int vtable_length() const { return _vtable_len; }
255 void set_vtable_length(int len) { _vtable_len = len; }
257 // Java itable
258 int itable_length() const { return _itable_len; }
259 void set_itable_length(int len) { _itable_len = len; }
261 // array klasses
262 klassOop array_klasses() const { return _array_klasses; }
263 void set_array_klasses(klassOop k) { oop_store_without_check((oop*) &_array_klasses, (oop) k); }
265 // methods
266 objArrayOop methods() const { return _methods; }
267 void set_methods(objArrayOop a) { oop_store_without_check((oop*) &_methods, (oop) a); }
268 methodOop method_with_idnum(int idnum);
270 // method ordering
271 typeArrayOop method_ordering() const { return _method_ordering; }
272 void set_method_ordering(typeArrayOop m) { oop_store_without_check((oop*) &_method_ordering, (oop) m); }
274 // interfaces
275 objArrayOop local_interfaces() const { return _local_interfaces; }
276 void set_local_interfaces(objArrayOop a) { oop_store_without_check((oop*) &_local_interfaces, (oop) a); }
277 objArrayOop transitive_interfaces() const { return _transitive_interfaces; }
278 void set_transitive_interfaces(objArrayOop a) { oop_store_without_check((oop*) &_transitive_interfaces, (oop) a); }
280 // fields
281 // Field info extracted from the class file and stored
282 // as an array of 7 shorts
283 enum FieldOffset {
284 access_flags_offset = 0,
285 name_index_offset = 1,
286 signature_index_offset = 2,
287 initval_index_offset = 3,
288 low_offset = 4,
289 high_offset = 5,
290 generic_signature_offset = 6,
291 next_offset = 7
292 };
294 typeArrayOop fields() const { return _fields; }
295 int offset_from_fields( int index ) const {
296 return build_int_from_shorts( fields()->ushort_at(index + low_offset),
297 fields()->ushort_at(index + high_offset) );
298 }
300 void set_fields(typeArrayOop f) { oop_store_without_check((oop*) &_fields, (oop) f); }
302 // inner classes
303 typeArrayOop inner_classes() const { return _inner_classes; }
304 void set_inner_classes(typeArrayOop f) { oop_store_without_check((oop*) &_inner_classes, (oop) f); }
306 enum InnerClassAttributeOffset {
307 // From http://mirror.eng/products/jdk/1.1/docs/guide/innerclasses/spec/innerclasses.doc10.html#18814
308 inner_class_inner_class_info_offset = 0,
309 inner_class_outer_class_info_offset = 1,
310 inner_class_inner_name_offset = 2,
311 inner_class_access_flags_offset = 3,
312 inner_class_next_offset = 4
313 };
315 // method override check
316 bool is_override(methodHandle super_method, Handle targetclassloader, symbolHandle targetclassname, TRAPS);
318 // package
319 bool is_same_class_package(klassOop class2);
320 bool is_same_class_package(oop classloader2, symbolOop classname2);
321 static bool is_same_class_package(oop class_loader1, symbolOop class_name1, oop class_loader2, symbolOop class_name2);
323 // find an enclosing class (defined where original code was, in jvm.cpp!)
324 klassOop compute_enclosing_class(symbolOop& simple_name_result, TRAPS) {
325 instanceKlassHandle self(THREAD, this->as_klassOop());
326 return compute_enclosing_class_impl(self, simple_name_result, THREAD);
327 }
328 static klassOop compute_enclosing_class_impl(instanceKlassHandle self,
329 symbolOop& simple_name_result, TRAPS);
331 // tell if two classes have the same enclosing class (at package level)
332 bool is_same_package_member(klassOop class2, TRAPS) {
333 instanceKlassHandle self(THREAD, this->as_klassOop());
334 return is_same_package_member_impl(self, class2, THREAD);
335 }
336 static bool is_same_package_member_impl(instanceKlassHandle self,
337 klassOop class2, TRAPS);
339 // initialization state
340 bool is_loaded() const { return _init_state >= loaded; }
341 bool is_linked() const { return _init_state >= linked; }
342 bool is_initialized() const { return _init_state == fully_initialized; }
343 bool is_not_initialized() const { return _init_state < being_initialized; }
344 bool is_being_initialized() const { return _init_state == being_initialized; }
345 bool is_in_error_state() const { return _init_state == initialization_error; }
346 bool is_reentrant_initialization(Thread *thread) { return thread == _init_thread; }
347 int get_init_state() { return _init_state; } // Useful for debugging
348 bool is_rewritten() const { return (_class_flags & _rewritten) != 0; }
350 // defineClass specified verification
351 bool should_verify_class() const { return (_class_flags & _should_verify) != 0; }
352 void set_should_verify_class() { _class_flags |= _should_verify; }
354 // marking
355 bool is_marked_dependent() const { return (_class_flags & _is_marked_dependent) != 0; }
356 void set_is_marked_dependent() { _class_flags |= _is_marked_dependent; }
357 void clear_is_marked_dependent() { _class_flags &= ~_is_marked_dependent; }
359 // initialization (virtuals from Klass)
360 bool should_be_initialized() const; // means that initialize should be called
361 void initialize(TRAPS);
362 void link_class(TRAPS);
363 bool link_class_or_fail(TRAPS); // returns false on failure
364 void unlink_class();
365 void rewrite_class(TRAPS);
366 methodOop class_initializer();
368 // set the class to initialized if no static initializer is present
369 void eager_initialize(Thread *thread);
371 // reference type
372 ReferenceType reference_type() const { return _reference_type; }
373 void set_reference_type(ReferenceType t) { _reference_type = t; }
375 // find local field, returns true if found
376 bool find_local_field(symbolOop name, symbolOop sig, fieldDescriptor* fd) const;
377 // find field in direct superinterfaces, returns the interface in which the field is defined
378 klassOop find_interface_field(symbolOop name, symbolOop sig, fieldDescriptor* fd) const;
379 // find field according to JVM spec 5.4.3.2, returns the klass in which the field is defined
380 klassOop find_field(symbolOop name, symbolOop sig, fieldDescriptor* fd) const;
381 // find instance or static fields according to JVM spec 5.4.3.2, returns the klass in which the field is defined
382 klassOop find_field(symbolOop name, symbolOop sig, bool is_static, fieldDescriptor* fd) const;
384 // find a non-static or static field given its offset within the class.
385 bool contains_field_offset(int offset) {
386 return instanceOopDesc::contains_field_offset(offset, nonstatic_field_size());
387 }
389 bool find_local_field_from_offset(int offset, bool is_static, fieldDescriptor* fd) const;
390 bool find_field_from_offset(int offset, bool is_static, fieldDescriptor* fd) const;
392 // find a local method (returns NULL if not found)
393 methodOop find_method(symbolOop name, symbolOop signature) const;
394 static methodOop find_method(objArrayOop methods, symbolOop name, symbolOop signature);
396 // lookup operation (returns NULL if not found)
397 methodOop uncached_lookup_method(symbolOop name, symbolOop signature) const;
399 // lookup a method in all the interfaces that this class implements
400 // (returns NULL if not found)
401 methodOop lookup_method_in_all_interfaces(symbolOop name, symbolOop signature) const;
403 // constant pool
404 constantPoolOop constants() const { return _constants; }
405 void set_constants(constantPoolOop c) { oop_store_without_check((oop*) &_constants, (oop) c); }
407 // class loader
408 oop class_loader() const { return _class_loader; }
409 void set_class_loader(oop l) { oop_store((oop*) &_class_loader, l); }
411 // protection domain
412 oop protection_domain() { return _protection_domain; }
413 void set_protection_domain(oop pd) { oop_store((oop*) &_protection_domain, pd); }
415 // host class
416 oop host_klass() const { return _host_klass; }
417 void set_host_klass(oop host) { oop_store((oop*) &_host_klass, host); }
418 bool is_anonymous() const { return _host_klass != NULL; }
420 // signers
421 objArrayOop signers() const { return _signers; }
422 void set_signers(objArrayOop s) { oop_store((oop*) &_signers, oop(s)); }
424 // source file name
425 symbolOop source_file_name() const { return _source_file_name; }
426 void set_source_file_name(symbolOop n) { oop_store_without_check((oop*) &_source_file_name, (oop) n); }
428 // minor and major version numbers of class file
429 u2 minor_version() const { return _minor_version; }
430 void set_minor_version(u2 minor_version) { _minor_version = minor_version; }
431 u2 major_version() const { return _major_version; }
432 void set_major_version(u2 major_version) { _major_version = major_version; }
434 // source debug extension
435 symbolOop source_debug_extension() const { return _source_debug_extension; }
436 void set_source_debug_extension(symbolOop n){ oop_store_without_check((oop*) &_source_debug_extension, (oop) n); }
438 // nonstatic oop-map blocks
439 int nonstatic_oop_map_size() const { return _nonstatic_oop_map_size; }
440 void set_nonstatic_oop_map_size(int size) { _nonstatic_oop_map_size = size; }
442 // RedefineClasses() support for previous versions:
443 void add_previous_version(instanceKlassHandle ikh, BitMap *emcp_methods,
444 int emcp_method_count);
445 bool has_previous_version() const;
446 void init_previous_versions() {
447 _previous_versions = NULL;
448 }
449 GrowableArray<PreviousVersionNode *>* previous_versions() const {
450 return _previous_versions;
451 }
453 // JVMTI: Support for caching a class file before it is modified by an agent that can do retransformation
454 void set_cached_class_file(unsigned char *class_file_bytes,
455 jint class_file_len) { _cached_class_file_len = class_file_len;
456 _cached_class_file_bytes = class_file_bytes; }
457 jint get_cached_class_file_len() { return _cached_class_file_len; }
458 unsigned char * get_cached_class_file_bytes() { return _cached_class_file_bytes; }
460 // JVMTI: Support for caching of field indices, types, and offsets
461 void set_jvmti_cached_class_field_map(JvmtiCachedClassFieldMap* descriptor) {
462 _jvmti_cached_class_field_map = descriptor;
463 }
464 JvmtiCachedClassFieldMap* jvmti_cached_class_field_map() const {
465 return _jvmti_cached_class_field_map;
466 }
468 // for adding methods, constMethodOopDesc::UNSET_IDNUM means no more ids available
469 inline u2 next_method_idnum();
470 void set_initial_method_idnum(u2 value) { _idnum_allocated_count = value; }
472 // generics support
473 symbolOop generic_signature() const { return _generic_signature; }
474 void set_generic_signature(symbolOop sig) { oop_store_without_check((oop*)&_generic_signature, (oop)sig); }
475 u2 enclosing_method_class_index() const { return _enclosing_method_class_index; }
476 u2 enclosing_method_method_index() const { return _enclosing_method_method_index; }
477 void set_enclosing_method_indices(u2 class_index,
478 u2 method_index) { _enclosing_method_class_index = class_index;
479 _enclosing_method_method_index = method_index; }
481 // JSR 292 support
482 oop bootstrap_method() const { return _bootstrap_method; }
483 void set_bootstrap_method(oop mh) { oop_store(&_bootstrap_method, mh); }
485 // jmethodID support
486 static jmethodID get_jmethod_id(instanceKlassHandle ik_h, size_t idnum,
487 jmethodID new_id, jmethodID* new_jmeths);
488 static jmethodID jmethod_id_for_impl(instanceKlassHandle ik_h, methodHandle method_h);
489 jmethodID jmethod_id_or_null(methodOop method);
491 // cached itable index support
492 void set_cached_itable_index(size_t idnum, int index);
493 int cached_itable_index(size_t idnum);
495 // annotations support
496 typeArrayOop class_annotations() const { return _class_annotations; }
497 objArrayOop fields_annotations() const { return _fields_annotations; }
498 objArrayOop methods_annotations() const { return _methods_annotations; }
499 objArrayOop methods_parameter_annotations() const { return _methods_parameter_annotations; }
500 objArrayOop methods_default_annotations() const { return _methods_default_annotations; }
501 void set_class_annotations(typeArrayOop md) { oop_store_without_check((oop*)&_class_annotations, (oop)md); }
502 void set_fields_annotations(objArrayOop md) { set_annotations(md, &_fields_annotations); }
503 void set_methods_annotations(objArrayOop md) { set_annotations(md, &_methods_annotations); }
504 void set_methods_parameter_annotations(objArrayOop md) { set_annotations(md, &_methods_parameter_annotations); }
505 void set_methods_default_annotations(objArrayOop md) { set_annotations(md, &_methods_default_annotations); }
506 typeArrayOop get_method_annotations_of(int idnum)
507 { return get_method_annotations_from(idnum, _methods_annotations); }
508 typeArrayOop get_method_parameter_annotations_of(int idnum)
509 { return get_method_annotations_from(idnum, _methods_parameter_annotations); }
510 typeArrayOop get_method_default_annotations_of(int idnum)
511 { return get_method_annotations_from(idnum, _methods_default_annotations); }
512 void set_method_annotations_of(int idnum, typeArrayOop anno)
513 { set_methods_annotations_of(idnum, anno, &_methods_annotations); }
514 void set_method_parameter_annotations_of(int idnum, typeArrayOop anno)
515 { set_methods_annotations_of(idnum, anno, &_methods_annotations); }
516 void set_method_default_annotations_of(int idnum, typeArrayOop anno)
517 { set_methods_annotations_of(idnum, anno, &_methods_annotations); }
519 // allocation
520 DEFINE_ALLOCATE_PERMANENT(instanceKlass);
521 instanceOop allocate_instance(TRAPS);
522 instanceOop allocate_permanent_instance(TRAPS);
524 // additional member function to return a handle
525 instanceHandle allocate_instance_handle(TRAPS) { return instanceHandle(THREAD, allocate_instance(THREAD)); }
527 objArrayOop allocate_objArray(int n, int length, TRAPS);
528 // Helper function
529 static instanceOop register_finalizer(instanceOop i, TRAPS);
531 // Check whether reflection/jni/jvm code is allowed to instantiate this class;
532 // if not, throw either an Error or an Exception.
533 virtual void check_valid_for_instantiation(bool throwError, TRAPS);
535 // initialization
536 void call_class_initializer(TRAPS);
537 void set_initialization_state_and_notify(ClassState state, TRAPS);
539 // OopMapCache support
540 OopMapCache* oop_map_cache() { return _oop_map_cache; }
541 void set_oop_map_cache(OopMapCache *cache) { _oop_map_cache = cache; }
542 void mask_for(methodHandle method, int bci, InterpreterOopMap* entry);
544 // JNI identifier support (for static fields - for jni performance)
545 JNIid* jni_ids() { return _jni_ids; }
546 void set_jni_ids(JNIid* ids) { _jni_ids = ids; }
547 JNIid* jni_id_for(int offset);
549 // maintenance of deoptimization dependencies
550 int mark_dependent_nmethods(DepChange& changes);
551 void add_dependent_nmethod(nmethod* nm);
552 void remove_dependent_nmethod(nmethod* nm);
554 // On-stack replacement support
555 nmethod* osr_nmethods_head() const { return _osr_nmethods_head; };
556 void set_osr_nmethods_head(nmethod* h) { _osr_nmethods_head = h; };
557 void add_osr_nmethod(nmethod* n);
558 void remove_osr_nmethod(nmethod* n);
559 nmethod* lookup_osr_nmethod(const methodOop m, int bci) const;
561 // Breakpoint support (see methods on methodOop for details)
562 BreakpointInfo* breakpoints() const { return _breakpoints; };
563 void set_breakpoints(BreakpointInfo* bps) { _breakpoints = bps; };
565 // support for stub routines
566 static int init_state_offset_in_bytes() { return offset_of(instanceKlass, _init_state); }
567 static int init_thread_offset_in_bytes() { return offset_of(instanceKlass, _init_thread); }
569 // subclass/subinterface checks
570 bool implements_interface(klassOop k) const;
572 // Access to implementors of an interface. We only store the count
573 // of implementors, and in case, there are only a few
574 // implementors, we store them in a short list.
575 // This accessor returns NULL if we walk off the end of the list.
576 klassOop implementor(int i) const {
577 return (i < implementors_limit)? _implementors[i]: (klassOop) NULL;
578 }
579 int nof_implementors() const { return _nof_implementors; }
580 void add_implementor(klassOop k); // k is a new class that implements this interface
581 void init_implementor(); // initialize
583 // link this class into the implementors list of every interface it implements
584 void process_interfaces(Thread *thread);
586 // virtual operations from Klass
587 bool is_leaf_class() const { return _subklass == NULL; }
588 objArrayOop compute_secondary_supers(int num_extra_slots, TRAPS);
589 bool compute_is_subtype_of(klassOop k);
590 bool can_be_primary_super_slow() const;
591 klassOop java_super() const { return super(); }
592 int oop_size(oop obj) const { return size_helper(); }
593 int klass_oop_size() const { return object_size(); }
594 bool oop_is_instance_slow() const { return true; }
596 // Iterators
597 void do_local_static_fields(FieldClosure* cl);
598 void do_nonstatic_fields(FieldClosure* cl); // including inherited fields
599 void do_local_static_fields(void f(fieldDescriptor*, TRAPS), TRAPS);
601 void methods_do(void f(methodOop method));
602 void array_klasses_do(void f(klassOop k));
603 void with_array_klasses_do(void f(klassOop k));
604 bool super_types_do(SuperTypeClosure* blk);
606 // Casting from klassOop
607 static instanceKlass* cast(klassOop k) {
608 Klass* kp = k->klass_part();
609 assert(kp->null_vtbl() || kp->oop_is_instance_slow(), "cast to instanceKlass");
610 return (instanceKlass*) kp;
611 }
613 // Sizing (in words)
614 static int header_size() { return align_object_offset(oopDesc::header_size() + sizeof(instanceKlass)/HeapWordSize); }
615 int object_size() const { return object_size(align_object_offset(vtable_length()) + align_object_offset(itable_length()) + static_field_size() + nonstatic_oop_map_size()); }
616 static int vtable_start_offset() { return header_size(); }
617 static int vtable_length_offset() { return oopDesc::header_size() + offset_of(instanceKlass, _vtable_len) / HeapWordSize; }
618 static int object_size(int extra) { return align_object_size(header_size() + extra); }
620 intptr_t* start_of_vtable() const { return ((intptr_t*)as_klassOop()) + vtable_start_offset(); }
621 intptr_t* start_of_itable() const { return start_of_vtable() + align_object_offset(vtable_length()); }
622 int itable_offset_in_words() const { return start_of_itable() - (intptr_t*)as_klassOop(); }
624 // Static field offset is an offset into the Heap, should be converted by
625 // based on UseCompressedOop for traversal
626 HeapWord* start_of_static_fields() const {
627 return (HeapWord*)(start_of_itable() + align_object_offset(itable_length()));
628 }
630 intptr_t* end_of_itable() const { return start_of_itable() + itable_length(); }
632 int offset_of_static_fields() const {
633 return (intptr_t)start_of_static_fields() - (intptr_t)as_klassOop();
634 }
636 OopMapBlock* start_of_nonstatic_oop_maps() const {
637 return (OopMapBlock*) (start_of_static_fields() + static_field_size());
638 }
640 // Allocation profiling support
641 juint alloc_size() const { return _alloc_count * size_helper(); }
642 void set_alloc_size(juint n) {}
644 // Use this to return the size of an instance in heap words:
645 int size_helper() const {
646 return layout_helper_to_size_helper(layout_helper());
647 }
649 // This bit is initialized in classFileParser.cpp.
650 // It is false under any of the following conditions:
651 // - the class is abstract (including any interface)
652 // - the class has a finalizer (if !RegisterFinalizersAtInit)
653 // - the class size is larger than FastAllocateSizeLimit
654 // - the class is java/lang/Class, which cannot be allocated directly
655 bool can_be_fastpath_allocated() const {
656 return !layout_helper_needs_slow_path(layout_helper());
657 }
659 // Java vtable/itable
660 klassVtable* vtable() const; // return new klassVtable wrapper
661 inline methodOop method_at_vtable(int index);
662 klassItable* itable() const; // return new klassItable wrapper
663 methodOop method_at_itable(klassOop holder, int index, TRAPS);
665 // Garbage collection
666 void oop_follow_contents(oop obj);
667 void follow_static_fields();
668 void adjust_static_fields();
669 int oop_adjust_pointers(oop obj);
670 bool object_is_parsable() const { return _init_state != unparsable_by_gc; }
671 // Value of _init_state must be zero (unparsable_by_gc) when klass field is set.
673 void follow_weak_klass_links(
674 BoolObjectClosure* is_alive, OopClosure* keep_alive);
675 void release_C_heap_structures();
677 // Parallel Scavenge and Parallel Old
678 PARALLEL_GC_DECLS
680 #ifndef SERIALGC
681 // Parallel Scavenge
682 void copy_static_fields(PSPromotionManager* pm);
683 void push_static_fields(PSPromotionManager* pm);
685 // Parallel Old
686 void follow_static_fields(ParCompactionManager* cm);
687 void copy_static_fields(ParCompactionManager* cm);
688 void update_static_fields();
689 void update_static_fields(HeapWord* beg_addr, HeapWord* end_addr);
690 #endif // SERIALGC
692 // Naming
693 char* signature_name() const;
695 // Iterators
696 int oop_oop_iterate(oop obj, OopClosure* blk) {
697 return oop_oop_iterate_v(obj, blk);
698 }
700 int oop_oop_iterate_m(oop obj, OopClosure* blk, MemRegion mr) {
701 return oop_oop_iterate_v_m(obj, blk, mr);
702 }
704 #define InstanceKlass_OOP_OOP_ITERATE_DECL(OopClosureType, nv_suffix) \
705 int oop_oop_iterate##nv_suffix(oop obj, OopClosureType* blk); \
706 int oop_oop_iterate##nv_suffix##_m(oop obj, OopClosureType* blk, \
707 MemRegion mr);
709 ALL_OOP_OOP_ITERATE_CLOSURES_1(InstanceKlass_OOP_OOP_ITERATE_DECL)
710 ALL_OOP_OOP_ITERATE_CLOSURES_2(InstanceKlass_OOP_OOP_ITERATE_DECL)
712 #ifndef SERIALGC
713 #define InstanceKlass_OOP_OOP_ITERATE_BACKWARDS_DECL(OopClosureType, nv_suffix) \
714 int oop_oop_iterate_backwards##nv_suffix(oop obj, OopClosureType* blk);
716 ALL_OOP_OOP_ITERATE_CLOSURES_1(InstanceKlass_OOP_OOP_ITERATE_BACKWARDS_DECL)
717 ALL_OOP_OOP_ITERATE_CLOSURES_2(InstanceKlass_OOP_OOP_ITERATE_BACKWARDS_DECL)
718 #endif // !SERIALGC
720 void iterate_static_fields(OopClosure* closure);
721 void iterate_static_fields(OopClosure* closure, MemRegion mr);
723 private:
724 // initialization state
725 #ifdef ASSERT
726 void set_init_state(ClassState state);
727 #else
728 void set_init_state(ClassState state) { _init_state = state; }
729 #endif
730 void clear_class_flags() { _class_flags = _noflags; }
731 void set_rewritten() { _class_flags |= _rewritten; }
732 void set_init_thread(Thread *thread) { _init_thread = thread; }
734 u2 idnum_allocated_count() const { return _idnum_allocated_count; }
735 jmethodID* methods_jmethod_ids_acquire() const
736 { return (jmethodID*)OrderAccess::load_ptr_acquire(&_methods_jmethod_ids); }
737 void release_set_methods_jmethod_ids(jmethodID* jmeths)
738 { OrderAccess::release_store_ptr(&_methods_jmethod_ids, jmeths); }
740 int* methods_cached_itable_indices_acquire() const
741 { return (int*)OrderAccess::load_ptr_acquire(&_methods_cached_itable_indices); }
742 void release_set_methods_cached_itable_indices(int* indices)
743 { OrderAccess::release_store_ptr(&_methods_cached_itable_indices, indices); }
745 inline typeArrayOop get_method_annotations_from(int idnum, objArrayOop annos);
746 void set_annotations(objArrayOop md, objArrayOop* md_p) { oop_store_without_check((oop*)md_p, (oop)md); }
747 void set_methods_annotations_of(int idnum, typeArrayOop anno, objArrayOop* md_p);
749 // Offsets for memory management
750 oop* adr_array_klasses() const { return (oop*)&this->_array_klasses;}
751 oop* adr_methods() const { return (oop*)&this->_methods;}
752 oop* adr_method_ordering() const { return (oop*)&this->_method_ordering;}
753 oop* adr_local_interfaces() const { return (oop*)&this->_local_interfaces;}
754 oop* adr_transitive_interfaces() const { return (oop*)&this->_transitive_interfaces;}
755 oop* adr_fields() const { return (oop*)&this->_fields;}
756 oop* adr_constants() const { return (oop*)&this->_constants;}
757 oop* adr_class_loader() const { return (oop*)&this->_class_loader;}
758 oop* adr_protection_domain() const { return (oop*)&this->_protection_domain;}
759 oop* adr_host_klass() const { return (oop*)&this->_host_klass;}
760 oop* adr_signers() const { return (oop*)&this->_signers;}
761 oop* adr_source_file_name() const { return (oop*)&this->_source_file_name;}
762 oop* adr_source_debug_extension() const { return (oop*)&this->_source_debug_extension;}
763 oop* adr_inner_classes() const { return (oop*)&this->_inner_classes;}
764 oop* adr_implementors() const { return (oop*)&this->_implementors[0];}
765 oop* adr_generic_signature() const { return (oop*)&this->_generic_signature;}
766 oop* adr_bootstrap_method() const { return (oop*)&this->_bootstrap_method;}
767 oop* adr_methods_jmethod_ids() const { return (oop*)&this->_methods_jmethod_ids;}
768 oop* adr_methods_cached_itable_indices() const { return (oop*)&this->_methods_cached_itable_indices;}
769 oop* adr_class_annotations() const { return (oop*)&this->_class_annotations;}
770 oop* adr_fields_annotations() const { return (oop*)&this->_fields_annotations;}
771 oop* adr_methods_annotations() const { return (oop*)&this->_methods_annotations;}
772 oop* adr_methods_parameter_annotations() const { return (oop*)&this->_methods_parameter_annotations;}
773 oop* adr_methods_default_annotations() const { return (oop*)&this->_methods_default_annotations;}
775 // Static methods that are used to implement member methods where an exposed this pointer
776 // is needed due to possible GCs
777 static bool link_class_impl (instanceKlassHandle this_oop, bool throw_verifyerror, TRAPS);
778 static bool verify_code (instanceKlassHandle this_oop, bool throw_verifyerror, TRAPS);
779 static void initialize_impl (instanceKlassHandle this_oop, TRAPS);
780 static void eager_initialize_impl (instanceKlassHandle this_oop);
781 static void set_initialization_state_and_notify_impl (instanceKlassHandle this_oop, ClassState state, TRAPS);
782 static void call_class_initializer_impl (instanceKlassHandle this_oop, TRAPS);
783 static klassOop array_klass_impl (instanceKlassHandle this_oop, bool or_null, int n, TRAPS);
784 static void do_local_static_fields_impl (instanceKlassHandle this_oop, void f(fieldDescriptor* fd, TRAPS), TRAPS);
785 /* jni_id_for_impl for jfieldID only */
786 static JNIid* jni_id_for_impl (instanceKlassHandle this_oop, int offset);
788 // Returns the array class for the n'th dimension
789 klassOop array_klass_impl(bool or_null, int n, TRAPS);
791 // Returns the array class with this class as element type
792 klassOop array_klass_impl(bool or_null, TRAPS);
794 public:
795 // sharing support
796 virtual void remove_unshareable_info();
797 void field_names_and_sigs_iterate(OopClosure* closure);
799 // jvm support
800 jint compute_modifier_flags(TRAPS) const;
802 public:
803 // JVMTI support
804 jint jvmti_class_status() const;
806 #ifndef PRODUCT
807 public:
808 // Printing
809 void oop_print_on (oop obj, outputStream* st);
810 void oop_print_value_on(oop obj, outputStream* st);
812 void print_dependent_nmethods(bool verbose = false);
813 bool is_dependent_nmethod(nmethod* nm);
814 #endif
816 public:
817 // Verification
818 const char* internal_name() const;
819 void oop_verify_on(oop obj, outputStream* st);
821 #ifndef PRODUCT
822 static void verify_class_klass_nonstatic_oop_maps(klassOop k) PRODUCT_RETURN;
823 #endif
824 };
826 inline methodOop instanceKlass::method_at_vtable(int index) {
827 #ifndef PRODUCT
828 assert(index >= 0, "valid vtable index");
829 if (DebugVtables) {
830 verify_vtable_index(index);
831 }
832 #endif
833 vtableEntry* ve = (vtableEntry*)start_of_vtable();
834 return ve[index].method();
835 }
837 inline typeArrayOop instanceKlass::get_method_annotations_from(int idnum, objArrayOop annos) {
838 if (annos == NULL || annos->length() <= idnum) {
839 return NULL;
840 }
841 return typeArrayOop(annos->obj_at(idnum));
842 }
844 // for adding methods
845 // UNSET_IDNUM return means no more ids available
846 inline u2 instanceKlass::next_method_idnum() {
847 if (_idnum_allocated_count == constMethodOopDesc::MAX_IDNUM) {
848 return constMethodOopDesc::UNSET_IDNUM; // no more ids available
849 } else {
850 return _idnum_allocated_count++;
851 }
852 }
855 // ValueObjs embedded in klass. Describes where oops are located in instances of this klass.
857 class OopMapBlock VALUE_OBJ_CLASS_SPEC {
858 private:
859 jushort _offset; // Offset of first oop in oop-map block
860 jushort _length; // Length of oop-map block
861 public:
862 // Accessors
863 jushort offset() const { return _offset; }
864 void set_offset(jushort offset) { _offset = offset; }
866 jushort length() const { return _length; }
867 void set_length(jushort length) { _length = length; }
868 };
870 /* JNIid class for jfieldIDs only */
871 class JNIid: public CHeapObj {
872 friend class VMStructs;
873 private:
874 klassOop _holder;
875 JNIid* _next;
876 int _offset;
877 #ifdef ASSERT
878 bool _is_static_field_id;
879 #endif
881 public:
882 // Accessors
883 klassOop holder() const { return _holder; }
884 int offset() const { return _offset; }
885 JNIid* next() { return _next; }
886 // Constructor
887 JNIid(klassOop holder, int offset, JNIid* next);
888 // Identifier lookup
889 JNIid* find(int offset);
891 // Garbage collection support
892 oop* holder_addr() { return (oop*)&_holder; }
893 void oops_do(OopClosure* f);
894 static void deallocate(JNIid* id);
895 // Debugging
896 #ifdef ASSERT
897 bool is_static_field_id() const { return _is_static_field_id; }
898 void set_is_static_field_id() { _is_static_field_id = true; }
899 #endif
900 void verify(klassOop holder);
901 };
904 // If breakpoints are more numerous than just JVMTI breakpoints,
905 // consider compressing this data structure.
906 // It is currently a simple linked list defined in methodOop.hpp.
908 class BreakpointInfo;
911 // A collection point for interesting information about the previous
912 // version(s) of an instanceKlass. This class uses weak references to
913 // the information so that the information may be collected as needed
914 // by the system. If the information is shared, then a regular
915 // reference must be used because a weak reference would be seen as
916 // collectible. A GrowableArray of PreviousVersionNodes is attached
917 // to the instanceKlass as needed. See PreviousVersionWalker below.
918 class PreviousVersionNode : public CHeapObj {
919 private:
920 // A shared ConstantPool is never collected so we'll always have
921 // a reference to it so we can update items in the cache. We'll
922 // have a weak reference to a non-shared ConstantPool until all
923 // of the methods (EMCP or obsolete) have been collected; the
924 // non-shared ConstantPool becomes collectible at that point.
925 jobject _prev_constant_pool; // regular or weak reference
926 bool _prev_cp_is_weak; // true if not a shared ConstantPool
928 // If the previous version of the instanceKlass doesn't have any
929 // EMCP methods, then _prev_EMCP_methods will be NULL. If all the
930 // EMCP methods have been collected, then _prev_EMCP_methods can
931 // have a length of zero.
932 GrowableArray<jweak>* _prev_EMCP_methods;
934 public:
935 PreviousVersionNode(jobject prev_constant_pool, bool prev_cp_is_weak,
936 GrowableArray<jweak>* prev_EMCP_methods);
937 ~PreviousVersionNode();
938 jobject prev_constant_pool() const {
939 return _prev_constant_pool;
940 }
941 GrowableArray<jweak>* prev_EMCP_methods() const {
942 return _prev_EMCP_methods;
943 }
944 };
947 // A Handle-ized version of PreviousVersionNode.
948 class PreviousVersionInfo : public ResourceObj {
949 private:
950 constantPoolHandle _prev_constant_pool_handle;
951 // If the previous version of the instanceKlass doesn't have any
952 // EMCP methods, then _prev_EMCP_methods will be NULL. Since the
953 // methods cannot be collected while we hold a handle,
954 // _prev_EMCP_methods should never have a length of zero.
955 GrowableArray<methodHandle>* _prev_EMCP_method_handles;
957 public:
958 PreviousVersionInfo(PreviousVersionNode *pv_node);
959 ~PreviousVersionInfo();
960 constantPoolHandle prev_constant_pool_handle() const {
961 return _prev_constant_pool_handle;
962 }
963 GrowableArray<methodHandle>* prev_EMCP_method_handles() const {
964 return _prev_EMCP_method_handles;
965 }
966 };
969 // Helper object for walking previous versions. This helper cleans up
970 // the Handles that it allocates when the helper object is destroyed.
971 // The PreviousVersionInfo object returned by next_previous_version()
972 // is only valid until a subsequent call to next_previous_version() or
973 // the helper object is destroyed.
974 class PreviousVersionWalker : public StackObj {
975 private:
976 GrowableArray<PreviousVersionNode *>* _previous_versions;
977 int _current_index;
978 // Fields for cleaning up when we are done walking the previous versions:
979 // A HandleMark for the PreviousVersionInfo handles:
980 HandleMark _hm;
982 // It would be nice to have a ResourceMark field in this helper also,
983 // but the ResourceMark code says to be careful to delete handles held
984 // in GrowableArrays _before_ deleting the GrowableArray. Since we
985 // can't guarantee the order in which the fields are destroyed, we
986 // have to let the creator of the PreviousVersionWalker object do
987 // the right thing. Also, adding a ResourceMark here causes an
988 // include loop.
990 // A pointer to the current info object so we can handle the deletes.
991 PreviousVersionInfo * _current_p;
993 public:
994 PreviousVersionWalker(instanceKlass *ik);
995 ~PreviousVersionWalker();
997 // Return the interesting information for the next previous version
998 // of the klass. Returns NULL if there are no more previous versions.
999 PreviousVersionInfo* next_previous_version();
1000 };