Modifier and Type	Class and Description
private static class	CDS.ProcessLauncher This class is used only by native JVM code to spawn a child JVM process to assemble the AOT cache.
private static class	CDS.UnregisteredClassLoader This class is used only by native JVM code at CDS dump time for loading "unregistered classes", which are archived classes that are intended to be loaded by custom class loaders during runtime.

Modifier and Type	Field and Description
pack-priv static final String	BASIC_FORMS_HOLDER_CLASS_NAME
private static final int	configStatus
pack-priv static final String	DELEGATING_HOLDER_CLASS_NAME
pack-priv static final String	DIRECT_HOLDER_CLASS_NAME
private static String[]	excludeFlags
pack-priv static final String	INVOKERS_HOLDER_CLASS_NAME
private static final int	IS_DUMPING_AOT_LINKED_CLASSES
private static final int	IS_DUMPING_ARCHIVE
private static final int	IS_DUMPING_METHOD_HANDLES
private static final int	IS_DUMPING_STATIC_ARCHIVE
private static final int	IS_LOGGING_LAMBDA_FORM_INVOKERS
private static final int	IS_USING_ARCHIVE
private static ArrayList<Object>	keepAliveList

Access	Constructor and Description
public	CDS()

Method Summary

Modifier and Type	Method and Description
private static boolean	containsExcludedFlags(String testStr)
public static native void	defineArchivedModules(ClassLoader platformLoader, ClassLoader systemLoader) Ensure that the native representation of all archived java.lang.Module objects are properly restored.
private static String	drainOutput(InputStream stream, long pid, String tail, List<String> cmds)
private static native void	dumpClassList(String listFileName)
private static native void	dumpDynamicArchive(String archiveFileName)
private static String	Returns: The archive name if successfully dumped. dumpSharedArchive(boolean true for dump static archive or false for dynnamic archive. isStatic, String user input archive name, can be null. fileName) called from jcmd VM.cds to dump static or dynamic shared archive
private static Object[]	Returns: `Object[]` if holder classes can be generated. generateLambdaFormHolderClasses(String[] in format of LF_RESOLVE or SPECIES_RESOLVE output lines) called from vm to generate MethodHandle holder classes
private static native int	getCDSConfigStatus()
private static Object[]	getKeepAliveObjects()
public static native long	getRandomSeedForDumping() Returns a predictable "random" seed derived from the VM's build ID and version, to be used by java.util.ImmutableCollections to ensure that archived ImmutableCollections are always sorted the same order for the same VM build.
public static native void	initializeFromArchive(Class<?> c) Initialize archived static fields in the given Class using archived values from CDS dump time.
private static boolean	isBasicTypeChar(char c)
public static boolean	isDumpingAOTLinkedClasses()
public static boolean	isDumpingArchive() Is the VM writing to a (static or dynamic) CDS archive.
public static boolean	isDumpingStaticArchive() Is dumping static archive.
public static boolean	isLoggingLambdaFormInvokers() Should we log the use of lambda form invokers?
public static boolean	isSingleThreadVM()
public static boolean	isUsingArchive() Is the VM using at least one CDS archive?
private static boolean	isValidHolderName(String name)
private static boolean	isValidMethodType(String type)
public static void	keepAlive(Object s)
private static native void	logLambdaFormInvoker(String line)
public static void	logLambdaFormInvoker(String prefix, String holder, String name, String type) log lambda form invoker holder, name and method type
public static void	logSpeciesType(String prefix, String cn) log species
public static boolean	Returns: false only if a call to `ensureClassInitialized` would have no effect during the application's production run. needsClassInitBarrier(Class<?> c) Detects if we need to emit explicit class initialization checks in AOT-cached MethodHandles and VarHandles before accessing static fields and methods.
private static native boolean	needsClassInitBarrier0(Class<?> c)
private static void	validateInputLines(String[] lines)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

BASIC_FORMS_HOLDER_CLASS_NAME	back to summary
pack-priv static final String BASIC_FORMS_HOLDER_CLASS_NAME

configStatus	back to summary
private static final int configStatus

DELEGATING_HOLDER_CLASS_NAME	back to summary
pack-priv static final String DELEGATING_HOLDER_CLASS_NAME

DIRECT_HOLDER_CLASS_NAME	back to summary
pack-priv static final String DIRECT_HOLDER_CLASS_NAME

excludeFlags	back to summary
private static String[] excludeFlags

INVOKERS_HOLDER_CLASS_NAME	back to summary
pack-priv static final String INVOKERS_HOLDER_CLASS_NAME

IS_DUMPING_AOT_LINKED_CLASSES	back to summary
private static final int IS_DUMPING_AOT_LINKED_CLASSES

IS_DUMPING_ARCHIVE	back to summary
private static final int IS_DUMPING_ARCHIVE

IS_DUMPING_METHOD_HANDLES	back to summary
private static final int IS_DUMPING_METHOD_HANDLES

IS_DUMPING_STATIC_ARCHIVE	back to summary
private static final int IS_DUMPING_STATIC_ARCHIVE

IS_LOGGING_LAMBDA_FORM_INVOKERS	back to summary
private static final int IS_LOGGING_LAMBDA_FORM_INVOKERS

IS_USING_ARCHIVE	back to summary
private static final int IS_USING_ARCHIVE

keepAliveList	back to summary
private static ArrayList<Object> keepAliveList

CDS	back to summary
public CDS()

Method Detail

containsExcludedFlags	back to summary
private static boolean containsExcludedFlags(String testStr)

defineArchivedModules	back to summary
public static native void defineArchivedModules(ClassLoader platformLoader, ClassLoader systemLoader) Ensure that the native representation of all archived java.lang.Module objects are properly restored.

drainOutput	back to summary
private static String drainOutput(InputStream stream, long pid, String tail, List<String> cmds)

dumpClassList	back to summary
private static native void dumpClassList(String listFileName)

dumpDynamicArchive	back to summary
private static native void dumpDynamicArchive(String archiveFileName)

dumpSharedArchive	back to summary
private static String dumpSharedArchive(boolean isStatic, String fileName) throws Exception called from jcmd VM.cds to dump static or dynamic shared archive Parameters isStatic:boolean true for dump static archive or false for dynnamic archive. fileName:String user input archive name, can be null. Returns:String The archive name if successfully dumped.

dumpSharedArchive

back to summary

private static String dumpSharedArchive(boolean isStatic, String fileName) throws Exception

called from jcmd VM.cds to dump static or dynamic shared archive

Parameters

isStatic:boolean: true for dump static archive or false for dynnamic archive.
fileName:String: user input archive name, can be null.

Returns:String

The archive name if successfully dumped.

generateLambdaFormHolderClasses back to summary

generateLambdaFormHolderClasses	back to summary
private static Object[] generateLambdaFormHolderClasses(String[] lines) called from vm to generate MethodHandle holder classes Parameters lines:String[] in format of LF_RESOLVE or SPECIES_RESOLVE output Returns:Object[] `Object[]` if holder classes can be generated.

private static Object[] generateLambdaFormHolderClasses(String[] lines)

called from vm to generate MethodHandle holder classes

Parameters

lines:String[]: in format of LF_RESOLVE or SPECIES_RESOLVE output

Returns:Object[]

Object[] if holder classes can be generated.

getCDSConfigStatus	back to summary
private static native int getCDSConfigStatus()

getKeepAliveObjects	back to summary
private static Object[] getKeepAliveObjects()

getRandomSeedForDumping	back to summary
public static native long getRandomSeedForDumping() Returns a predictable "random" seed derived from the VM's build ID and version, to be used by java.util.ImmutableCollections to ensure that archived ImmutableCollections are always sorted the same order for the same VM build.

initializeFromArchive	back to summary
public static native void initializeFromArchive(Class<?> c) Initialize archived static fields in the given Class using archived values from CDS dump time. Also initialize the classes of objects in the archived graph referenced by those fields. Those static fields remain as uninitialized if there is no mapped CDS java heap data or there is any error during initialization of the object class in the archived graph.

initializeFromArchive

back to summary

public static native void initializeFromArchive(Class<?> c)

Initialize archived static fields in the given Class using archived values from CDS dump time. Also initialize the classes of objects in the archived graph referenced by those fields. Those static fields remain as uninitialized if there is no mapped CDS java heap data or there is any error during initialization of the object class in the archived graph.

isBasicTypeChar	back to summary
private static boolean isBasicTypeChar(char c)

isDumpingAOTLinkedClasses	back to summary
public static boolean isDumpingAOTLinkedClasses()

isDumpingArchive	back to summary
public static boolean isDumpingArchive() Is the VM writing to a (static or dynamic) CDS archive.

isDumpingStaticArchive	back to summary
public static boolean isDumpingStaticArchive() Is dumping static archive.

isLoggingLambdaFormInvokers	back to summary
public static boolean isLoggingLambdaFormInvokers() Should we log the use of lambda form invokers?

isSingleThreadVM	back to summary
public static boolean isSingleThreadVM()

isUsingArchive	back to summary
public static boolean isUsingArchive() Is the VM using at least one CDS archive?

isValidHolderName	back to summary
private static boolean isValidHolderName(String name)

isValidMethodType	back to summary
private static boolean isValidMethodType(String type)

keepAlive	back to summary
public static void keepAlive(Object s)

logLambdaFormInvoker	back to summary
private static native void logLambdaFormInvoker(String line)

logLambdaFormInvoker	back to summary
public static void logLambdaFormInvoker(String prefix, String holder, String name, String type) log lambda form invoker holder, name and method type

logSpeciesType	back to summary
public static void logSpeciesType(String prefix, String cn) log species

needsClassInitBarrier back to summary

needsClassInitBarrier	back to summary
public static boolean needsClassInitBarrier(Class<?> c) Detects if we need to emit explicit class initialization checks in AOT-cached MethodHandles and VarHandles before accessing static fields and methods. Returns:boolean false only if a call to `ensureClassInitialized` would have no effect during the application's production run. See Also `jdk.internal.misc.Unsafe::shouldBeInitialized`

public static boolean needsClassInitBarrier(Class<?> c)

Detects if we need to emit explicit class initialization checks in AOT-cached MethodHandles and VarHandles before accessing static fields and methods.

Returns:boolean: false only if a call to ensureClassInitialized would have no effect during the application's production run.
See Also: jdk.internal.misc.Unsafe::shouldBeInitialized

needsClassInitBarrier0	back to summary
private static native boolean needsClassInitBarrier0(Class<?> c)

validateInputLines	back to summary
private static void validateInputLines(String[] lines)

jdk.internal.misc back to summary

private Class CDS.ProcessLauncher

Class Inheritance

extends Object

java.lang.Object
jdk.internal.misc.CDS.ProcessLauncher

This class is used only by native JVM code to spawn a child JVM process to assemble the AOT cache. args[] are passed in the JAVA_TOOL_OPTIONS environment variable.

Constructor Summary

Access	Constructor and Description
private	ProcessLauncher()

Method Summary

Modifier and Type	Method and Description
pack-priv static int	execWithJavaToolOptions(String javaLauncher, String[] args)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Constructor Detail

ProcessLauncher	back to summary
private ProcessLauncher()

Method Detail

execWithJavaToolOptions	back to summary
pack-priv static int execWithJavaToolOptions(String javaLauncher, String[] args) throws IOException, InterruptedException

jdk.internal.misc back to summary

private Class CDS.UnregisteredClassLoader

Class Inheritance

extends ClassLoader

java.lang.Object
java.lang.ClassLoader
jdk.internal.misc.CDS.UnregisteredClassLoader

This class is used only by native JVM code at CDS dump time for loading "unregistered classes", which are archived classes that are intended to be loaded by custom class loaders during runtime. See src/hotspot/share/cds/unregisteredClasses.cpp.

Nested and Inner Type Summary

Modifier and Type	Class and Description
pack-priv static class	CDS.UnregisteredClassLoader.DirSource
pack-priv static class	CDS.UnregisteredClassLoader.JarSource
pack-priv static interface	CDS.UnregisteredClassLoader.Source

Field Summary

Modifier and Type	Field and Description
private final HashMap<String, CDS.UnregisteredClassLoader.Source>	sources

Constructor Summary

Access	Constructor and Description
private	UnregisteredClassLoader()

Method Summary

Modifier and Type	Method and Description
private Class<?>	load(String the name of the class to be loaded. name, String path to a directory or a JAR file from which the named class should be loaded. source) Load the class of the given `name` from the given `source`.
private CDS.UnregisteredClassLoader.Source	resolveSource(String path)

Field Detail

sources	back to summary
private final HashMap<String, CDS.UnregisteredClassLoader.Source> sources

Constructor Detail

UnregisteredClassLoader	back to summary
private UnregisteredClassLoader()

Method Detail

load back to summary

private Class<?> load(String name, String source) throws IOException

Load the class of the given name from the given source.

All super classes and interfaces of the named class must have already been loaded: either defined by this class loader (unregistered ones) or loaded, possibly indirectly, by the system class loader (registered ones).

If the named class has a registered super class or interface named N there should be no unregistered class or interface named N loaded yet.

Parameters

name:String: the name of the class to be loaded.
source:String: path to a directory or a JAR file from which the named class should be loaded.

resolveSource	back to summary
private CDS.UnregisteredClassLoader.Source resolveSource(String path) throws IOException

jdk.internal.misc back to summary

pack-priv Class CDS.UnregisteredClassLoader.DirSource

Class Inheritance

extends Object
implements Source

java.lang.Object
jdk.internal.misc.CDS.UnregisteredClassLoader.DirSource

All Implemented Interfaces

jdk.internal.misc.CDS.UnregisteredClassLoader.Source

Field Summary

Modifier and Type	Field and Description
private final String	basePath

Constructor Summary

Access	Constructor and Description
pack-priv	DirSource(File dir)

Method Summary

Modifier and Type	Method and Description
public byte[]	readClassFile(String className) Implements jdk.internal.misc.CDS.UnregisteredClassLoader.Source.readClassFile.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

basePath	back to summary
private final String basePath

Constructor Detail

DirSource	back to summary
pack-priv DirSource(File dir)

Method Detail

readClassFile

back to summary

public byte[] readClassFile(String className) throws IOException

Implements jdk.internal.misc.CDS.UnregisteredClassLoader.Source.readClassFile.

Annotations

@Override

jdk.internal.misc back to summary

pack-priv Class CDS.UnregisteredClassLoader.JarSource

Class Inheritance

extends Object
implements Source

java.lang.Object
jdk.internal.misc.CDS.UnregisteredClassLoader.JarSource

All Implemented Interfaces

jdk.internal.misc.CDS.UnregisteredClassLoader.Source

Field Summary

Modifier and Type	Field and Description
private final JarFile	jar

Constructor Summary

Access	Constructor and Description
pack-priv	JarSource(File file)

Method Summary

Modifier and Type	Method and Description
public byte[]	readClassFile(String className) Implements jdk.internal.misc.CDS.UnregisteredClassLoader.Source.readClassFile.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

jar	back to summary
private final JarFile jar

Constructor Detail

JarSource	back to summary
pack-priv JarSource(File file) throws IOException

Method Detail

readClassFile

back to summary

public byte[] readClassFile(String className) throws IOException

Implements jdk.internal.misc.CDS.UnregisteredClassLoader.Source.readClassFile.

Annotations

@Override

jdk.internal.misc back to summary

pack-priv Interface CDS.UnregisteredClassLoader.Source

Known Direct Implementers: jdk.internal.misc.CDS.UnregisteredClassLoader.JarSource, jdk.internal.misc.CDS.UnregisteredClassLoader.DirSource

Method Summary

Modifier and Type	Method and Description
public byte[]	readClassFile(String className)

Method Detail

readClassFile	back to summary
public byte[] readClassFile(String className) throws IOException

public Class CDS

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class CDS.ProcessLauncher

Constructor Summary

Method Summary

Constructor Detail

Method Detail

private Class CDS.UnregisteredClassLoader

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

pack-priv Class CDS.UnregisteredClassLoader.DirSource

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

pack-priv Class CDS.UnregisteredClassLoader.JarSource

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

pack-priv Interface CDS.UnregisteredClassLoader.Source

Method Summary

Method Detail