Modifier and Type	Class and Description
pack-priv static class	ModuleBootstrap.Counters Counters for startup performance analysis.
public static enum	ModuleBootstrap.IllegalFinalFieldMutation
public static enum	ModuleBootstrap.IllegalNativeAccess
pack-priv static class	ModuleBootstrap.SafeModuleFinder Wraps a (potentially not thread safe) ModuleFinder created during startup for use after startup.

Field Summary

Modifier and Type	Field and Description
private static final String	ADD_EXPORTS
private static final String	ADD_MODULES
private static final String	ADD_OPENS
private static final String	ADD_READS
private static final String	ALL_DEFAULT
private static final String	ALL_MODULE_PATH
private static final String	ALL_SYSTEM
private static final String	ALL_UNNAMED
private static final String	ENABLE_NATIVE_ACCESS
private static final ModuleBootstrap.IllegalFinalFieldMutation	ILLEGAL_FINAL_FIELD_MUTATION
private static final ModuleBootstrap.IllegalNativeAccess	ILLEGAL_NATIVE_ACCESS
private static final String	JAVA_BASE
private static final Set<String>	JDK_NATIVE_ACCESS_MODULES
private static final JavaLangAccess	JLA
private static final JavaLangModuleAccess	JLMA
private static volatile ModuleFinder	limitedFinder
private static final String	PATCH_MODULE
private static final ModulePatcher	patcher
private static volatile ModuleFinder	unlimitedFinder
private static final Set<String>	USER_NATIVE_ACCESS_MODULES

Constructor Summary

Access	Constructor and Description
private	ModuleBootstrap()

Method Summary

Modifier and Type	Method and Description
private static void	addEnableFinalFieldMutation(ModuleLayer bootLayer) Process the modules specified to --enable-final-field-mutation and grant the capability to mutate finals to specified named modules or all unnamed modules.
private static void	addEnableNativeAccess(ModuleLayer layer) Grants native access to modules selected using the --enable-native-access command line option, and also to JDK modules that need the access.
private static void	addEnableNativeAccess(ModuleLayer layer, Set<String> moduleNames, boolean shouldWarn) Grants native access for the given modules in the given layer.
private static void	addExtraExportsAndOpens(ModuleLayer bootLayer) Process the --add-exports and --add-opens options to export/open additional packages specified on the command-line.
private static void	addExtraExportsOrOpens(ModuleLayer bootLayer, Map<String, List<String>> map, boolean opens)
private static void	addExtraReads(ModuleLayer bootLayer) Process the --add-reads options to add any additional read edges that are specified on the command-line.
private static Set<String>	addModules() Returns the set of module names specified by --add-module options.
private static boolean	allJrtOrModularJar(Configuration cf) Returns true if all modules in the configuration are in the run-time image or modular JAR files.
public static ModuleLayer	boot() Initialize the module system, returning the boot layer.
private static ModuleLayer	boot2()
private static boolean	canUseArchivedBootLayer() Returns true if the archived boot layer can be used.
private static void	checkIncubatingStatus(Configuration cf) Checks incubating status of modules in the configuration
private static void	checkSplitPackages(Configuration cf, Function<String, ClassLoader> clf) Checks for split packages between modules defined to the built-in class loaders.
private static boolean	containsIncubatorModule(Configuration cf) Returns true if the configuration contains an incubator module.
private static boolean	containsSplitPackages(Configuration cf) Returns true if the configuration contains modules with overlapping packages.
private static Map<String, List<String>>	decode(String the system property prefix prefix, String the regex for splitting the RHS of the option value regex, boolean allowDuplicates) Decodes the values of --add-reads, -add-exports, --add-opens or --patch-modules options that are encoded in system properties.
private static Map<String, List<String>>	decode(String prefix) Decodes the values of --add-reads, -add-exports or --add-opens which use the "," to separate the RHS of the option value.
private static Set<String>	decodeEnableFinalFieldMutation() Returns the set of module names specified by --enable-final-field-mutation options.
private static Set<String>	decodeEnableNativeAccess() Returns the set of module names specified by --enable-native-access options.
private static ModuleBootstrap.IllegalFinalFieldMutation	decodeIllegalFinalFieldMutation() Process the --illegal-final-field-mutation option.
private static ModuleBootstrap.IllegalNativeAccess	decodeIllegalNativeAccess() Process the --illegal-native-access option (and its default).
pack-priv static void	fail(String m) Throws a RuntimeException with the given message
private static ModuleFinder	finderFor(String prop) Creates a finder from the module path that is the value of the given system property and optionally patched by --patch-module
private static String	getAndRemoveProperty(String key) Gets and remove the named system property
private static String	getProperty(String key) Gets the named system property
public static ModuleBootstrap.IllegalFinalFieldMutation	illegalFinalFieldMutation()
public static ModuleBootstrap.IllegalNativeAccess	illegalNativeAccess()
private static ModulePatcher	initModulePatcher() Initialize the module patcher for the initial configuration passed on the value of the --patch-module options.
private static boolean	isJarFile(URI uri) Returns true if the given URI locates a jar file on the file system.
public static ModuleFinder	limitedFinder() Returns the ModuleFinder for the initial configuration.
private static ModuleFinder	limitFinder(ModuleFinder finder, Set<String> roots, Set<String> otherMods) Returns a ModuleFinder that limits observability to the given root modules, their transitive dependences, plus a set of other modules.
private static Set<String>	limitModules() Returns the set of module names specified by --limit-modules.
private static void	loadModules(Configuration cf, Function<String, ClassLoader> clf) Load/register the modules to the built-in class loaders.
pack-priv static String	option(String prefix)
public static ModulePatcher	patcher() Returns the ModulePatcher for the initial configuration.
pack-priv static String	unableToParse(String option, String text, String value)
public static ModuleFinder	unlimitedFinder() Returns the ModuleFinder for the initial configuration before observability is limited by the --limit-modules command line option.
pack-priv static void	warn(String m)
pack-priv static void	warnUnknownModule(String option, String mn)

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

Field Detail

ADD_EXPORTS	back to summary
private static final String ADD_EXPORTS

ADD_MODULES	back to summary
private static final String ADD_MODULES

ADD_OPENS	back to summary
private static final String ADD_OPENS

ADD_READS	back to summary
private static final String ADD_READS

ALL_DEFAULT	back to summary
private static final String ALL_DEFAULT

ALL_MODULE_PATH	back to summary
private static final String ALL_MODULE_PATH

ALL_SYSTEM	back to summary
private static final String ALL_SYSTEM

ALL_UNNAMED	back to summary
private static final String ALL_UNNAMED

ENABLE_NATIVE_ACCESS	back to summary
private static final String ENABLE_NATIVE_ACCESS

ILLEGAL_FINAL_FIELD_MUTATION	back to summary
private static final ModuleBootstrap.IllegalFinalFieldMutation ILLEGAL_FINAL_FIELD_MUTATION

ILLEGAL_NATIVE_ACCESS	back to summary
private static final ModuleBootstrap.IllegalNativeAccess ILLEGAL_NATIVE_ACCESS

JAVA_BASE	back to summary
private static final String JAVA_BASE

JDK_NATIVE_ACCESS_MODULES	back to summary
private static final Set<String> JDK_NATIVE_ACCESS_MODULES

JLA	back to summary
private static final JavaLangAccess JLA

JLMA	back to summary
private static final JavaLangModuleAccess JLMA

limitedFinder	back to summary
private static volatile ModuleFinder limitedFinder

PATCH_MODULE	back to summary
private static final String PATCH_MODULE

patcher	back to summary
private static final ModulePatcher patcher

unlimitedFinder	back to summary
private static volatile ModuleFinder unlimitedFinder

USER_NATIVE_ACCESS_MODULES	back to summary
private static final Set<String> USER_NATIVE_ACCESS_MODULES

Constructor Detail

ModuleBootstrap	back to summary
private ModuleBootstrap()

Method Detail

addEnableFinalFieldMutation	back to summary
private static void addEnableFinalFieldMutation(ModuleLayer bootLayer) Process the modules specified to --enable-final-field-mutation and grant the capability to mutate finals to specified named modules or all unnamed modules.

addEnableNativeAccess	back to summary
private static void addEnableNativeAccess(ModuleLayer layer) Grants native access to modules selected using the --enable-native-access command line option, and also to JDK modules that need the access. In case of being in "source" launcher mode, warnings about unknown modules are deferred to the source launcher logic in the jdk.compiler module, as those modules might be not compiled, yet.

addEnableNativeAccess

back to summary

private static void addEnableNativeAccess(ModuleLayer layer)

Grants native access to modules selected using the --enable-native-access command line option, and also to JDK modules that need the access.

In case of being in "source" launcher mode, warnings about unknown modules are deferred to the source launcher logic in the jdk.compiler module, as those modules might be not compiled, yet.

addEnableNativeAccess	back to summary
private static void addEnableNativeAccess(ModuleLayer layer, Set<String> moduleNames, boolean shouldWarn) Grants native access for the given modules in the given layer. Warns optionally about modules that were specified, but not present in the layer.

addExtraExportsAndOpens	back to summary
private static void addExtraExportsAndOpens(ModuleLayer bootLayer) Process the --add-exports and --add-opens options to export/open additional packages specified on the command-line.

addExtraExportsOrOpens	back to summary
private static void addExtraExportsOrOpens(ModuleLayer bootLayer, Map<String, List<String>> map, boolean opens)

addExtraReads	back to summary
private static void addExtraReads(ModuleLayer bootLayer) Process the --add-reads options to add any additional read edges that are specified on the command-line.

addModules	back to summary
private static Set<String> addModules() Returns the set of module names specified by --add-module options.

allJrtOrModularJar	back to summary
private static boolean allJrtOrModularJar(Configuration cf) Returns true if all modules in the configuration are in the run-time image or modular JAR files.

boot back to summary

boot	back to summary
public static ModuleLayer boot() Initialize the module system, returning the boot layer. The boot layer is obtained from the CDS archive if possible, otherwise it is generated from the module graph. See Also `java.lang.System#initPhase2(boolean, boolean)`

public static ModuleLayer boot()

Initialize the module system, returning the boot layer. The boot layer is obtained from the CDS archive if possible, otherwise it is generated from the module graph.

See Also: java.lang.System#initPhase2(boolean, boolean)

boot2	back to summary
private static ModuleLayer boot2()

canUseArchivedBootLayer	back to summary
private static boolean canUseArchivedBootLayer() Returns true if the archived boot layer can be used. The system properties are checked in the order that they are used by boot2.

checkIncubatingStatus	back to summary
private static void checkIncubatingStatus(Configuration cf) Checks incubating status of modules in the configuration

checkSplitPackages	back to summary
private static void checkSplitPackages(Configuration cf, Function<String, ClassLoader> clf) Checks for split packages between modules defined to the built-in class loaders.

containsIncubatorModule	back to summary
private static boolean containsIncubatorModule(Configuration cf) Returns true if the configuration contains an incubator module.

containsSplitPackages	back to summary
private static boolean containsSplitPackages(Configuration cf) Returns true if the configuration contains modules with overlapping packages.

decode	back to summary
private static Map<String, List<String>> decode(String prefix, String regex, boolean allowDuplicates) Decodes the values of --add-reads, -add-exports, --add-opens or --patch-modules options that are encoded in system properties. Parameters prefix:String the system property prefix regex:String the regex for splitting the RHS of the option value

decode

back to summary

private static Map<String, List<String>> decode(String prefix, String regex, boolean allowDuplicates)

Decodes the values of --add-reads, -add-exports, --add-opens or --patch-modules options that are encoded in system properties.

Parameters

prefix:String: the system property prefix
regex:String: the regex for splitting the RHS of the option value

decode	back to summary
private static Map<String, List<String>> decode(String prefix) Decodes the values of --add-reads, -add-exports or --add-opens which use the "," to separate the RHS of the option value.

decodeEnableFinalFieldMutation	back to summary
private static Set<String> decodeEnableFinalFieldMutation() Returns the set of module names specified by --enable-final-field-mutation options.

decodeEnableNativeAccess	back to summary
private static Set<String> decodeEnableNativeAccess() Returns the set of module names specified by --enable-native-access options.

decodeIllegalFinalFieldMutation	back to summary
private static ModuleBootstrap.IllegalFinalFieldMutation decodeIllegalFinalFieldMutation() Process the --illegal-final-field-mutation option.

decodeIllegalNativeAccess	back to summary
private static ModuleBootstrap.IllegalNativeAccess decodeIllegalNativeAccess() Process the --illegal-native-access option (and its default).

fail	back to summary
pack-priv static void fail(String m) Throws a RuntimeException with the given message

finderFor	back to summary
private static ModuleFinder finderFor(String prop) Creates a finder from the module path that is the value of the given system property and optionally patched by --patch-module

getAndRemoveProperty	back to summary
private static String getAndRemoveProperty(String key) Gets and remove the named system property

getProperty	back to summary
private static String getProperty(String key) Gets the named system property

illegalFinalFieldMutation	back to summary
public static ModuleBootstrap.IllegalFinalFieldMutation illegalFinalFieldMutation()

illegalNativeAccess	back to summary
public static ModuleBootstrap.IllegalNativeAccess illegalNativeAccess()

initModulePatcher	back to summary
private static ModulePatcher initModulePatcher() Initialize the module patcher for the initial configuration passed on the value of the --patch-module options.

isJarFile	back to summary
private static boolean isJarFile(URI uri) Returns true if the given URI locates a jar file on the file system.

limitedFinder	back to summary
public static ModuleFinder limitedFinder() Returns the ModuleFinder for the initial configuration. API Note Used to support "`java --list-modules`".

limitFinder	back to summary
private static ModuleFinder limitFinder(ModuleFinder finder, Set<String> roots, Set<String> otherMods) Returns a ModuleFinder that limits observability to the given root modules, their transitive dependences, plus a set of other modules.

limitModules	back to summary
private static Set<String> limitModules() Returns the set of module names specified by --limit-modules.

loadModules	back to summary
private static void loadModules(Configuration cf, Function<String, ClassLoader> clf) Load/register the modules to the built-in class loaders.

option	back to summary
pack-priv static String option(String prefix)

patcher	back to summary
public static ModulePatcher patcher() Returns the ModulePatcher for the initial configuration.

unableToParse	back to summary
pack-priv static String unableToParse(String option, String text, String value)

unlimitedFinder	back to summary
public static ModuleFinder unlimitedFinder() Returns the ModuleFinder for the initial configuration before observability is limited by the --limit-modules command line option. API Note Used to support locating modules `java.instrument` and `jdk.management.agent` modules when they are loaded dynamically.

warn	back to summary
pack-priv static void warn(String m)

warnUnknownModule	back to summary
pack-priv static void warnUnknownModule(String option, String mn)

jdk.internal.module back to summary

pack-priv Class ModuleBootstrap.Counters

Class Inheritance

extends Object

java.lang.Object
jdk.internal.module.ModuleBootstrap.Counters

Counters for startup performance analysis.

Field Summary

Modifier and Type	Field and Description
private static Map<String, Long>	counters
private static long	previousTime
private static final boolean	PRINT_COUNTERS
private static final boolean	PUBLISH_COUNTERS
private static long	startTime

Constructor Summary

Access	Constructor and Description
pack-priv	Counters()

Method Summary

Modifier and Type	Method and Description
pack-priv static void	add(String name) Add a counter - storing the time difference between now and the previous add or the start.
pack-priv static void	publish(String totalTimeName) Publish the counters to the instrumentation buffer or stdout.
pack-priv static void	start() Start counting time.

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

Field Detail

counters	back to summary
private static Map<String, Long> counters

previousTime	back to summary
private static long previousTime

PRINT_COUNTERS	back to summary
private static final boolean PRINT_COUNTERS

PUBLISH_COUNTERS	back to summary
private static final boolean PUBLISH_COUNTERS

startTime	back to summary
private static long startTime

Constructor Detail

Counters	back to summary
pack-priv Counters()

Method Detail

add	back to summary
pack-priv static void add(String name) Add a counter - storing the time difference between now and the previous add or the start.

publish	back to summary
pack-priv static void publish(String totalTimeName) Publish the counters to the instrumentation buffer or stdout.

start	back to summary
pack-priv static void start() Start counting time.

jdk.internal.module back to summary

public final Enum ModuleBootstrap.IllegalFinalFieldMutation

Class Inheritance

extends Enum<ModuleBootstrap.IllegalFinalFieldMutation>

java.lang.Object
java.lang.Enum
jdk.internal.module.ModuleBootstrap.IllegalFinalFieldMutation

Field Summary

Modifier and Type	Field and Description
public static final ModuleBootstrap.IllegalFinalFieldMutation	ALLOW
public static final ModuleBootstrap.IllegalFinalFieldMutation	DEBUG
public static final ModuleBootstrap.IllegalFinalFieldMutation	DENY
public static final ModuleBootstrap.IllegalFinalFieldMutation	WARN

Constructor Summary

Access	Constructor and Description
private	IllegalFinalFieldMutation()

Method Summary

Modifier and Type	Method and Description
public static ModuleBootstrap.IllegalFinalFieldMutation	valueOf(String name)
public static ModuleBootstrap.IllegalFinalFieldMutation[]	values()

Inherited from java.lang.Enum:: clone compareTo describeConstable equals finalize getDeclaringClass hashCode name ordinal toString valueOf

Field Detail

ALLOW	back to summary
public static final ModuleBootstrap.IllegalFinalFieldMutation ALLOW

DEBUG	back to summary
public static final ModuleBootstrap.IllegalFinalFieldMutation DEBUG

DENY	back to summary
public static final ModuleBootstrap.IllegalFinalFieldMutation DENY

WARN	back to summary
public static final ModuleBootstrap.IllegalFinalFieldMutation WARN

Constructor Detail

IllegalFinalFieldMutation	back to summary
private IllegalFinalFieldMutation()

Method Detail

valueOf	back to summary
public static ModuleBootstrap.IllegalFinalFieldMutation valueOf(String name)

values	back to summary
public static ModuleBootstrap.IllegalFinalFieldMutation[] values()

jdk.internal.module back to summary

public final Enum ModuleBootstrap.IllegalNativeAccess

Class Inheritance

extends Enum<ModuleBootstrap.IllegalNativeAccess>

java.lang.Object
java.lang.Enum
jdk.internal.module.ModuleBootstrap.IllegalNativeAccess

Field Summary

Modifier and Type	Field and Description
public static final ModuleBootstrap.IllegalNativeAccess	ALLOW
public static final ModuleBootstrap.IllegalNativeAccess	DENY
public static final ModuleBootstrap.IllegalNativeAccess	WARN

Constructor Summary

Access	Constructor and Description
private	IllegalNativeAccess()

Method Summary

Modifier and Type	Method and Description
public static ModuleBootstrap.IllegalNativeAccess	valueOf(String name)
public static ModuleBootstrap.IllegalNativeAccess[]	values()

Inherited from java.lang.Enum:: clone compareTo describeConstable equals finalize getDeclaringClass hashCode name ordinal toString valueOf

Field Detail

ALLOW	back to summary
public static final ModuleBootstrap.IllegalNativeAccess ALLOW

DENY	back to summary
public static final ModuleBootstrap.IllegalNativeAccess DENY

WARN	back to summary
public static final ModuleBootstrap.IllegalNativeAccess WARN

Constructor Detail

IllegalNativeAccess	back to summary
private IllegalNativeAccess()

Method Detail

valueOf	back to summary
public static ModuleBootstrap.IllegalNativeAccess valueOf(String name)

values	back to summary
public static ModuleBootstrap.IllegalNativeAccess[] values()

jdk.internal.module back to summary

pack-priv Class ModuleBootstrap.SafeModuleFinder

Class Inheritance

extends Object
implements ModuleFinder

java.lang.Object
jdk.internal.module.ModuleBootstrap.SafeModuleFinder

All Implemented Interfaces

java.lang.module.ModuleFinder

Wraps a (potentially not thread safe) ModuleFinder created during startup for use after startup.

Field Summary

Modifier and Type	Field and Description
private final Set<ModuleReference>	mrefs
private volatile Map<String, ModuleReference>	nameToModule

Constructor Summary

Access	Constructor and Description
pack-priv	SafeModuleFinder(ModuleFinder finder)

Method Summary

Modifier and Type	Method and Description
public Optional<ModuleReference>	find(String name) Implements java.lang.module.ModuleFinder.find. Finds a reference to a module of a given name.
public Set<ModuleReference>	findAll() Implements java.lang.module.ModuleFinder.findAll. Returns the set of all module references that this finder can locate.

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

Field Detail

mrefs	back to summary
private final Set<ModuleReference> mrefs

nameToModule	back to summary
private volatile Map<String, ModuleReference> nameToModule

Constructor Detail

SafeModuleFinder	back to summary
pack-priv SafeModuleFinder(ModuleFinder finder)

Method Detail

find back to summary

public Optional<ModuleReference> find(String name)

Implements java.lang.module.ModuleFinder.find.

Doc from java.lang.module.ModuleFinder.find.

Finds a reference to a module of a given name.

A ModuleFinder provides a consistent view of the modules that it locates. If find is invoked several times to locate the same module (by name) then it will return the same result each time. If a module is located then it is guaranteed to be a member of the set of modules returned by the findAll method.

Annotations

@Override

findAll back to summary

public Set<ModuleReference> findAll()

Implements java.lang.module.ModuleFinder.findAll.

Doc from java.lang.module.ModuleFinder.findAll.

Returns the set of all module references that this finder can locate.

A ModuleFinder provides a consistent view of the modules that it locates. If findAll is invoked several times then it will return the same (equals) result each time. For each ModuleReference element in the returned set then it is guaranteed that find will locate the ModuleReference if invoked to find that module.

Annotations

@Override

public final Class ModuleBootstrap

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

pack-priv Class ModuleBootstrap.Counters

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public final Enum ModuleBootstrap.IllegalFinalFieldMutation

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public final Enum ModuleBootstrap.IllegalNativeAccess

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

pack-priv Class ModuleBootstrap.SafeModuleFinder

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail