com.oracle.svm.hosted.classinitialization

Class ConfigurableClassInitialization

java.lang.Object

com.oracle.svm.hosted.classinitialization.ConfigurableClassInitialization

All Implemented Interfaces:

ClassInitializationSupport, org.graalvm.nativeimage.impl.RuntimeClassInitializationSupport

public class ConfigurableClassInitialization
extends Object
implements ClassInitializationSupport

The core class for deciding whether a class should be initialized during image building or class initialization should be delayed to runtime.

Field Summary

Fields

Modifier and Type	Field and Description
protected jdk.vm.ci.meta.MetaAccessProvider	metaAccess

Constructor Summary

Constructors

Constructor and Description
ConfigurableClassInitialization(jdk.vm.ci.meta.MetaAccessProvider metaAccess, ImageClassLoader loader)

Method Summary

Modifier and Type	Method and Description
boolean	checkDelayedInitialization() Check that all registered classes are here, regardless if the AnalysisType got actually marked as used.
Set<Class<?>>	classesWithKind(InitKind kind) Returns all classes of a single InitKind.
void	forceInitializeHosted(Class<?> clazz, String reason, boolean allowInitializationErrors) Initializes the class during image building, and reports an error if the user requested to delay initialization to runtime.
List<ClassOrPackageConfig>	getClassInitializationConfiguration()
void	initializeAtBuildTime(Class<?> aClass, String reason)
void	initializeAtBuildTime(String name, String reason)
void	initializeAtRunTime(Class<?> clazz, String reason)
void	initializeAtRunTime(String name, String reason)
void	maybeInitializeHosted(jdk.vm.ci.meta.ResolvedJavaType type) Initializes the class during image building, unless initialization must be delayed to runtime.
void	rerunInitialization(Class<?> clazz, String reason)
void	rerunInitialization(String name, String reason)
void	setUnsupportedFeatures(com.oracle.graal.pointsto.constraints.UnsupportedFeatures unsupportedFeatures)
boolean	shouldInitializeAtRuntime(Class<?> clazz) Returns true if the provided class should be initialized at runtime.
boolean	shouldInitializeAtRuntime(jdk.vm.ci.meta.ResolvedJavaType type) Returns true if the provided type should be initialized at runtime.
InitKind	specifiedInitKindFor(Class<?> clazz) Returns an init kind for clazz.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

metaAccess

protected jdk.vm.ci.meta.MetaAccessProvider metaAccess

Constructor Detail

ConfigurableClassInitialization

public ConfigurableClassInitialization(jdk.vm.ci.meta.MetaAccessProvider metaAccess,
                                       ImageClassLoader loader)

Method Detail

setUnsupportedFeatures

public void setUnsupportedFeatures(com.oracle.graal.pointsto.constraints.UnsupportedFeatures unsupportedFeatures)

Specified by:

setUnsupportedFeatures in interface ClassInitializationSupport

specifiedInitKindFor

public InitKind specifiedInitKindFor(Class<?> clazz)

Description copied from interface: ClassInitializationSupport

Returns an init kind for clazz.

Specified by:

specifiedInitKindFor in interface ClassInitializationSupport

classesWithKind

public Set<Class<?>> classesWithKind(InitKind kind)

Description copied from interface: ClassInitializationSupport

Returns all classes of a single InitKind.

Specified by:

classesWithKind in interface ClassInitializationSupport

shouldInitializeAtRuntime

public boolean shouldInitializeAtRuntime(jdk.vm.ci.meta.ResolvedJavaType type)

Description copied from interface: ClassInitializationSupport

Returns true if the provided type should be initialized at runtime.

Specified by:

shouldInitializeAtRuntime in interface ClassInitializationSupport

shouldInitializeAtRuntime

public boolean shouldInitializeAtRuntime(Class<?> clazz)

Description copied from interface: ClassInitializationSupport

Returns true if the provided class should be initialized at runtime.

Specified by:

shouldInitializeAtRuntime in interface ClassInitializationSupport

maybeInitializeHosted

public void maybeInitializeHosted(jdk.vm.ci.meta.ResolvedJavaType type)

Description copied from interface: ClassInitializationSupport

Initializes the class during image building, unless initialization must be delayed to runtime.

Specified by:

maybeInitializeHosted in interface ClassInitializationSupport

initializeAtRunTime

public void initializeAtRunTime(String name,
                                String reason)

Specified by:

initializeAtRunTime in interface org.graalvm.nativeimage.impl.RuntimeClassInitializationSupport

initializeAtBuildTime

public void initializeAtBuildTime(String name,
                                  String reason)

Specified by:

initializeAtBuildTime in interface org.graalvm.nativeimage.impl.RuntimeClassInitializationSupport

rerunInitialization

public void rerunInitialization(String name,
                                String reason)

Specified by:

rerunInitialization in interface org.graalvm.nativeimage.impl.RuntimeClassInitializationSupport

initializeAtRunTime

public void initializeAtRunTime(Class<?> clazz,
                                String reason)

Specified by:

initializeAtRunTime in interface org.graalvm.nativeimage.impl.RuntimeClassInitializationSupport

rerunInitialization

public void rerunInitialization(Class<?> clazz,
                                String reason)

Specified by:

rerunInitialization in interface org.graalvm.nativeimage.impl.RuntimeClassInitializationSupport

initializeAtBuildTime

public void initializeAtBuildTime(Class<?> aClass,
                                  String reason)

Specified by:

initializeAtBuildTime in interface org.graalvm.nativeimage.impl.RuntimeClassInitializationSupport

forceInitializeHosted

public void forceInitializeHosted(Class<?> clazz,
                                  String reason,
                                  boolean allowInitializationErrors)

Description copied from interface: ClassInitializationSupport

Initializes the class during image building, and reports an error if the user requested to delay initialization to runtime.

Specified by:

forceInitializeHosted in interface ClassInitializationSupport

checkDelayedInitialization

public boolean checkDelayedInitialization()

Description copied from interface: ClassInitializationSupport

Check that all registered classes are here, regardless if the AnalysisType got actually marked as used. Class initialization can have side effects on other classes without the class being used itself, e.g., a class initializer can write a static field in another class.

Specified by:

checkDelayedInitialization in interface ClassInitializationSupport

getClassInitializationConfiguration

public List<ClassOrPackageConfig> getClassInitializationConfiguration()

Specified by:

getClassInitializationConfiguration in interface ClassInitializationSupport