/* * Copyright (c) 1997, 2022, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation. * * This code is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License * version 2 for more details (a copy is included in the LICENSE file that * accompanied this code). * * You should have received a copy of the GNU General Public License version * 2 along with this work; if not, write to the Free Software Foundation, * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. * * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA * or visit www.oracle.com if you need additional information or have any * questions. *
*/
// Klass Kinds for all subclasses of Klass enum KlassKind {
InstanceKlassKind,
InstanceRefKlassKind,
InstanceMirrorKlassKind,
InstanceClassLoaderKlassKind,
InstanceStackChunkKlassKind,
TypeArrayKlassKind,
ObjArrayKlassKind
};
// // A Klass provides: // 1: language level class object (method dictionary etc.) // 2: provide vm dispatch behavior for the object // Both functions are combined into one C++ class.
// One reason for the oop/klass dichotomy in the implementation is // that we don't want a C++ vtbl pointer in every object. Thus, // normal oops don't have any virtual functions. Instead, they // forward all "virtual" functions to their klass, which does have // a vtbl and does the C++ dispatch depending on the object's // actual type. (See oop.inline.hpp for some of the forwarding code.) // ALL FUNCTIONS IMPLEMENTING THIS DISPATCH ARE PREFIXED WITH "oop_"!
// Forward declarations. template <class T> class Array; template <class T> class GrowableArray; class ClassLoaderData; class fieldDescriptor; class klassVtable; class ModuleEntry; class PackageEntry; class ParCompactionManager; class PSPromotionManager; class vtableEntry;
class Klass : public Metadata { friendclass VMStructs; friendclass JVMCIVMStructs; protected: // If you add a new field that points to any metaspace object, you // must add this field to Klass::metaspace_pointers_do().
// note: put frequently-used fields together at start of klass structure // for better cache behavior (may not make much of a difference but sure won't hurt) enum { _primary_super_limit = 8 };
// The "layout helper" is a combined descriptor of object layout. // For klasses which are neither instance nor array, the value is zero. // // For instances, layout helper is a positive number, the instance size. // This size is already passed through align_object_size and scaled to bytes. // The low order bit is set if instances of this class cannot be // allocated using the fastpath. // // For arrays, layout helper is a negative number, containing four // distinct bytes, as follows: // MSB:[tag, hsz, ebt, log2(esz)]:LSB // where: // tag is 0x80 if the elements are oops, 0xC0 if non-oops // hsz is array header size in bytes (i.e., offset of first element) // ebt is the BasicType of the elements // esz is the element size in bytes // This packed word is arranged so as to be quickly unpacked by the // various fast paths that use the various subfields. // // The esz bits can be used directly by a SLL instruction, without masking. // // Note that the array-kind tag looks like 0x00 for instance klasses, // since their length in bytes is always less than 24Mb. // // Final note: This comes first, immediately after C++ vtable, // because it is frequently queried.
jint _layout_helper;
// Klass kind used to resolve the runtime type of the instance. // - Used to implement devirtualized oop closure dispatching. // - Various type checking in the JVM const KlassKind _kind;
// Processed access flags, for use by Class.getModifiers.
jint _modifier_flags;
// The fields _super_check_offset, _secondary_super_cache, _secondary_supers // and _primary_supers all help make fast subtype checks. See big discussion // in doc/server_compiler/checktype.txt // // Where to look to observe a supertype (it is &_secondary_super_cache for // secondary supers, else is &_primary_supers[depth()].
juint _super_check_offset;
// Class name. Instance classes: java/lang/String, etc. Array classes: [I, // [Ljava/lang/String;, etc. Set to zero for all other kinds of classes.
Symbol* _name;
// Cache of last observed secondary supertype
Klass* _secondary_super_cache; // Array of all secondary supertypes
Array<Klass*>* _secondary_supers; // Ordered list of all primary supertypes
Klass* _primary_supers[_primary_super_limit]; // java/lang/Class instance mirroring this class
OopHandle _java_mirror; // Superclass
Klass* _super; // First subclass (NULL if none); _subklass->next_sibling() is next one
Klass* volatile _subklass; // Sibling link (or NULL); links all subklasses of a klass
Klass* volatile _next_sibling;
// All klasses loaded by a class loader are chained through these links
Klass* _next_link;
// The VM's representation of the ClassLoader used to load this class. // Provide access the corresponding instance java.lang.ClassLoader.
ClassLoaderData* _class_loader_data;
int _vtable_len; // vtable length. This field may be read very often when we // have lots of itable dispatches (e.g., lambdas and streams). // Keep it away from the beginning of a Klass to avoid cacheline // contention that may happen when a nearby object is modified.
AccessFlags _access_flags; // Access flags. The class/interface distinction is stored here.
JFR_ONLY(DEFINE_TRACE_ID_FIELD;)
private: // This is an index into FileMapHeader::_shared_path_table[], to // associate this class with the JAR file where it's loaded from during // dump time. If a class is not loaded from the shared archive, this field is // -1.
jshort _shared_class_path_index;
#if INCLUDE_CDS // Various attributes for shared classes. Should be zero for a non-shared class.
u2 _shared_class_flags; enum CDSSharedClassFlags {
_archived_lambda_proxy_is_available = 1 << 1,
_has_value_based_class_annotation = 1 << 2,
_verified_at_dump_time = 1 << 3,
_has_archived_enum_objs = 1 << 4, // This class was not loaded from a classfile in the module image // or classpath.
_is_generated_shared_class = 1 << 5
}; #endif
// super() cannot be InstanceKlass* -- Java arrays are covariant, and _super is used // to implement that. NB: the _super of "[Ljava/lang/Integer;" is "[Ljava/lang/Number;" // If this is not what your code expects, you're probably looking for Klass::java_super().
Klass* super() const { return _super; } void set_super(Klass* k) { _super = k; }
// Return the element of the _super chain of the given depth. // If there is no such element, return either NULL or this.
Klass* primary_super_of_depth(juint i) const {
assert(i < primary_super_limit(), "oob");
Klass* super = _primary_supers[i];
assert(super == NULL || super->super_depth() == i, "correct display"); return super;
}
// Can this klass be a primary super? False for interfaces and arrays of // interfaces. False also for arrays or classes with long super chains. bool can_be_primary_super() const { const juint secondary_offset = in_bytes(secondary_super_cache_offset()); return super_check_offset() != secondary_offset;
} virtualbool can_be_primary_super_slow() const;
// Returns number of primary supers; may be a number in the inclusive range [0, primary_super_limit].
juint super_depth() const { if (!can_be_primary_super()) { return primary_super_limit();
} else {
juint d = (super_check_offset() - in_bytes(primary_supers_offset())) / sizeof(Klass*);
assert(d < primary_super_limit(), "oob");
assert(_primary_supers[d] == this, "proper init"); return d;
}
}
oop archived_java_mirror() NOT_CDS_JAVA_HEAP_RETURN_(NULL); void set_archived_java_mirror(oop m) NOT_CDS_JAVA_HEAP_RETURN;
// Temporary mirror switch used by RedefineClasses
OopHandle java_mirror_handle() const { return _java_mirror; } void swap_java_mirror_handle(OopHandle& mirror) { _java_mirror.swap(mirror); }
// Set java mirror OopHandle to NULL for CDS // This leaves the OopHandle in the CLD, but that's ok, you can't release them. void clear_java_mirror_handle() { _java_mirror = OopHandle(); }
InstanceKlass* superklass() const; void append_to_sibling_list(); // add newly created receiver to superklass' subklass list
void set_next_link(Klass* k) { _next_link = k; }
Klass* next_link() const { return _next_link; } // The next klass defined by the class loader.
Klass** next_link_addr() { return &_next_link; }
// class loader data
ClassLoaderData* class_loader_data() const { return _class_loader_data; } void set_class_loader_data(ClassLoaderData* loader_data) { _class_loader_data = loader_data; }
int shared_classpath_index() const { return _shared_class_path_index;
};
// subclass check bool is_subclass_of(const Klass* k) const; // subtype check: true if is_subclass_of, or if k is interface and receiver implements it bool is_subtype_of(Klass* k) const {
juint off = k->super_check_offset();
Klass* sup = *(Klass**)( (address)this + off ); const juint secondary_offset = in_bytes(secondary_super_cache_offset()); if (sup == k) { returntrue;
} elseif (off != secondary_offset) { returnfalse;
} else { return search_secondary_supers(k);
}
}
bool search_secondary_supers(Klass* k) const;
// Find LCA in class hierarchy
Klass *LCA( Klass *k );
// Check whether reflection/jni/jvm code is allowed to instantiate this class; // if not, throw either an Error or an Exception. virtualvoid check_valid_for_instantiation(bool throwError, TRAPS);
// array copying virtualvoid copy_array(arrayOop s, int src_pos, arrayOop d, int dst_pos, int length, TRAPS);
// tells if the class should be initialized virtualbool should_be_initialized() const { returnfalse; } // initializes the klass virtualvoid initialize(TRAPS); virtual Klass* find_field(Symbol* name, Symbol* signature, fieldDescriptor* fd) const; virtual Method* uncached_lookup_method(const Symbol* name, const Symbol* signature,
OverpassLookupMode overpass_mode,
PrivateLookupMode = PrivateLookupMode::find) const; public:
Method* lookup_method(const Symbol* name, const Symbol* signature) const { return uncached_lookup_method(name, signature, OverpassLookupMode::find);
}
// array class with specific rank virtual Klass* array_klass(int rank, TRAPS) = 0;
// array class with this klass as element type virtual Klass* array_klass(TRAPS) = 0;
// These will return NULL instead of allocating on the heap: virtual Klass* array_klass_or_null(int rank) = 0; virtual Klass* array_klass_or_null() = 0;
virtual oop protection_domain() const = 0;
oop class_loader() const;
inline oop klass_holder() const;
protected:
// Error handling when length > max_length or length < 0 staticvoid check_array_allocation_length(int length, int max_length, TRAPS);
#if INCLUDE_CDS // CDS support - remove and restore oops from metadata. Oops are not shared. virtualvoid remove_unshareable_info(); virtualvoid remove_java_mirror();
bool is_unshareable_info_restored() const {
assert(is_shared(), "use this for shared classes only"); if (has_archived_mirror_index()) { // _java_mirror is not a valid OopHandle but rather an encoded reference in the shared heap returnfalse;
} elseif (_java_mirror.ptr_raw() == NULL) { returnfalse;
} else { returntrue;
}
} #endif// INCLUDE_CDS
public: // ALL FUNCTIONS BELOW THIS POINT ARE DISPATCHED FROM AN OOP // These functions describe behavior for the oop not the KLASS.
// actual oop size of obj in memory in word size. virtual size_t oop_size(oop obj) const = 0;
// Size of klass in word size. virtualint size() const = 0;
// Returns the Java name for a class (Resource allocated) // For arrays, this returns the name of the element with a leading '['. // For classes, this returns the name with the package separators // turned into '.'s. constchar* external_name() const; // Returns the name for a class (Resource allocated) as the class // would appear in a signature. // For arrays, this returns the name of the element with a leading '['. // For classes, this returns the name with a leading 'L' and a trailing ';' // and the package separators as '/'. virtualconstchar* signature_name() const;
Die Informationen auf dieser Webseite wurden
nach bestem Wissen sorgfältig zusammengestellt. Es wird jedoch weder Vollständigkeit, noch Richtigkeit,
noch Qualität der bereit gestellten Informationen zugesichert.
Bemerkung:
Die farbliche Syntaxdarstellung ist noch experimentell.