org.graalvm.compiler.nodes.graphbuilderconf

Interface ClassInitializationPlugin

All Superinterfaces:

GraphBuilderPlugin

All Known Implementing Classes:

HotSpotJITClassInitializationPlugin

public interface ClassInitializationPlugin
extends GraphBuilderPlugin

Plugin for emitting a class initialization barrier (i.e., initializes a class if it's not already initialized). This plugin also supports separating class resolution from class initialization with ClassInitializationPlugin.supportsLazyInitialization(ConstantPool) and ClassInitializationPlugin.loadReferencedType(GraphBuilderContext, ConstantPool, int, int).

See Also:

"https://bugs.openjdk.java.net/browse/JDK-8146201"

Method Summary

Modifier and Type	Method and Description
default boolean	apply(GraphBuilderContext builder, ResolvedJavaType type, Supplier<FrameState> frameState) Emits a class initialization barrier for type.
boolean	apply(GraphBuilderContext builder, ResolvedJavaType type, Supplier<FrameState> frameState, ValueNode[] classInit) Emits a class initialization barrier for type.
void	loadReferencedType(GraphBuilderContext builder, ConstantPool cp, int cpi, int bytecode) Ensures that the type referenced by the constant pool entry specified by cp and cpi is loaded.
boolean	supportsLazyInitialization(ConstantPool cp) Determines if cp has a variation of ConstantPool.loadReferencedType(int, int) that can resolved a type without initializing it.

Method Detail

apply

boolean apply(GraphBuilderContext builder,
              ResolvedJavaType type,
              Supplier<FrameState> frameState,
              ValueNode[] classInit)

Emits a class initialization barrier for type.

Parameters:

frameState - supplier to create a frame state representing the state just prior to execution of the class initialization barrier

classInit - if non-null, the node representing the class initialization barrier should be returned in element 0 of this array

Returns:

true if this method emitted a barrier,false if not

apply

default boolean apply(GraphBuilderContext builder,
                      ResolvedJavaType type,
                      Supplier<FrameState> frameState)

Emits a class initialization barrier for type.

Parameters:

frameState - supplier to create a frame state representing the state just prior to execution of the class initialization barrier

Returns:

true if this method emitted a barrier,false if not

supportsLazyInitialization

boolean supportsLazyInitialization(ConstantPool cp)

Determines if cp has a variation of ConstantPool.loadReferencedType(int, int) that can resolved a type without initializing it.

loadReferencedType

void loadReferencedType(GraphBuilderContext builder,
                        ConstantPool cp,
                        int cpi,
                        int bytecode)

Ensures that the type referenced by the constant pool entry specified by cp and cpi is loaded. If cp does not support lazy initialization, then the type is initialized after resolution.

Parameters:

cpi - the index of the constant pool entry that references the type

bytecode - the opcode of the instruction that references the type