infernap12/jdk
1
0
Fork 0
mirror of https://github.com/openjdk/jdk.git synced 2026-05-11 05:59:52 +00:00
Code Issues Packages Projects Releases Wiki Activity

8248877: Document API contract for MetaspaceObj subtypes

Browse Source 
Reviewed-by: coleenp, minqi
This commit is contained in:
Ioi Lam 2021-06-08 16:47:38 +00:00
parent 159cb6facc
commit c21cc932f0
1 changed files with 15 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
src/hotspot/share/memory/allocation.hpp
View File

@ -263,6 +263,21 @@ class ClassLoaderData;
class MetaspaceClosure;
class MetaspaceObj {
// There are functions that all subtypes of MetaspaceObj are expected
// to implement, so that templates which are defined for this class hierarchy
// can work uniformly. Within the sub-hierarchy of Metadata, these are virtuals.
// Elsewhere in the hierarchy of MetaspaceObj, type(), size(), and/or on_stack()
// can be static if constant.
//
// The following functions are required by MetaspaceClosure:
// void metaspace_pointers_do(MetaspaceClosure* it) { <walk my refs> }
// int size() const { return align_up(sizeof(<This>), wordSize) / wordSize; }
// MetaspaceObj::Type type() const { return <This>Type; }
//
// The following functions are required by MetadataFactory::free_metadata():
// bool on_stack() { return false; }
// void deallocate_contents(ClassLoaderData* loader_data);
friend class VMStructs;
// When CDS is enabled, all shared metaspace objects are mapped
// into a single contiguous memory block, so we can use these