com.oracle.graal.graphbuilderconf

Interface InvocationPlugin

All Superinterfaces:

GraphBuilderPlugin

All Known Implementing Classes:

ForeignCallPlugin, MethodSubstitutionPlugin, StandardGraphBuilderPlugins.BoxPlugin, StandardGraphBuilderPlugins.UnboxPlugin, StandardGraphBuilderPlugins.UnsafeGetPlugin, StandardGraphBuilderPlugins.UnsafePutPlugin, StandardGraphBuilderPlugins.UnsignedMathPlugin, TruffleGraphBuilderPlugins.CustomizedUnsafeLoadPlugin, TruffleGraphBuilderPlugins.CustomizedUnsafeStorePlugin

public interface InvocationPlugin
extends GraphBuilderPlugin

Plugin for handling a specific method invocation.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	InvocationPlugin.Receiver The receiver in a non-static method.

Method Summary

Modifier and Type	Method and Description
default boolean	apply(GraphBuilderContext b, ResolvedJavaMethod targetMethod, InvocationPlugin.Receiver receiver)
default boolean	apply(GraphBuilderContext b, ResolvedJavaMethod targetMethod, InvocationPlugin.Receiver receiver, ValueNode arg)
default boolean	apply(GraphBuilderContext b, ResolvedJavaMethod targetMethod, InvocationPlugin.Receiver receiver, ValueNode arg1, ValueNode arg2)
default boolean	apply(GraphBuilderContext b, ResolvedJavaMethod targetMethod, InvocationPlugin.Receiver receiver, ValueNode arg1, ValueNode arg2, ValueNode arg3)
default boolean	apply(GraphBuilderContext b, ResolvedJavaMethod targetMethod, InvocationPlugin.Receiver receiver, ValueNode arg1, ValueNode arg2, ValueNode arg3, ValueNode arg4)
default boolean	apply(GraphBuilderContext b, ResolvedJavaMethod targetMethod, InvocationPlugin.Receiver receiver, ValueNode arg1, ValueNode arg2, ValueNode arg3, ValueNode arg4, ValueNode arg5)
default boolean	applyPolymorphic(GraphBuilderContext b, ResolvedJavaMethod targetMethod, InvocationPlugin.Receiver receiver, ValueNode... argsIncludingReceiver) Handles invocation of a signature polymorphic method.
default boolean	defaultHandler(GraphBuilderContext b, ResolvedJavaMethod targetMethod, InvocationPlugin.Receiver receiver, ValueNode... args) Handles an invocation when a specific apply method is not available.
default boolean	execute(GraphBuilderContext b, ResolvedJavaMethod targetMethod, InvocationPlugin.Receiver receiver, ValueNode[] argsIncludingReceiver) Executes this plugin against a set of invocation arguments.
default StackTraceElement	getApplySourceLocation(MetaAccessProvider metaAccess)
default boolean	inlineOnly() Determines if this plugin can only be used when inlining the method is it associated with.
default boolean	isSignaturePolymorphic() Determines if this plugin is for a method with a polymorphic signature (e.g.

Method Detail

isSignaturePolymorphic

default boolean isSignaturePolymorphic()

Determines if this plugin is for a method with a polymorphic signature (e.g. MethodHandle.invokeExact(Object...)).

inlineOnly

default boolean inlineOnly()

Determines if this plugin can only be used when inlining the method is it associated with. That is, this plugin cannot be used when the associated method is the compilation root.

applyPolymorphic

default boolean applyPolymorphic(GraphBuilderContext b,
                                 ResolvedJavaMethod targetMethod,
                                 InvocationPlugin.Receiver receiver,
                                 ValueNode... argsIncludingReceiver)

Handles invocation of a signature polymorphic method.

Parameters:

receiver - access to the receiver, null if targetMethod is static

argsIncludingReceiver - all arguments to the invocation include the raw receiver in position 0 if targetMethod is not static

See Also:

execute(com.oracle.graal.graphbuilderconf.GraphBuilderContext, jdk.internal.jvmci.meta.ResolvedJavaMethod, com.oracle.graal.graphbuilderconf.InvocationPlugin.Receiver, com.oracle.graal.nodes.ValueNode[])

apply

default boolean apply(GraphBuilderContext b,
                      ResolvedJavaMethod targetMethod,
                      InvocationPlugin.Receiver receiver)

See Also:

execute(com.oracle.graal.graphbuilderconf.GraphBuilderContext, jdk.internal.jvmci.meta.ResolvedJavaMethod, com.oracle.graal.graphbuilderconf.InvocationPlugin.Receiver, com.oracle.graal.nodes.ValueNode[])

apply

default boolean apply(GraphBuilderContext b,
                      ResolvedJavaMethod targetMethod,
                      InvocationPlugin.Receiver receiver,
                      ValueNode arg)

See Also:

execute(com.oracle.graal.graphbuilderconf.GraphBuilderContext, jdk.internal.jvmci.meta.ResolvedJavaMethod, com.oracle.graal.graphbuilderconf.InvocationPlugin.Receiver, com.oracle.graal.nodes.ValueNode[])

apply

default boolean apply(GraphBuilderContext b,
                      ResolvedJavaMethod targetMethod,
                      InvocationPlugin.Receiver receiver,
                      ValueNode arg1,
                      ValueNode arg2)

See Also:

execute(com.oracle.graal.graphbuilderconf.GraphBuilderContext, jdk.internal.jvmci.meta.ResolvedJavaMethod, com.oracle.graal.graphbuilderconf.InvocationPlugin.Receiver, com.oracle.graal.nodes.ValueNode[])

apply

default boolean apply(GraphBuilderContext b,
                      ResolvedJavaMethod targetMethod,
                      InvocationPlugin.Receiver receiver,
                      ValueNode arg1,
                      ValueNode arg2,
                      ValueNode arg3)

See Also:

execute(com.oracle.graal.graphbuilderconf.GraphBuilderContext, jdk.internal.jvmci.meta.ResolvedJavaMethod, com.oracle.graal.graphbuilderconf.InvocationPlugin.Receiver, com.oracle.graal.nodes.ValueNode[])

apply

default boolean apply(GraphBuilderContext b,
                      ResolvedJavaMethod targetMethod,
                      InvocationPlugin.Receiver receiver,
                      ValueNode arg1,
                      ValueNode arg2,
                      ValueNode arg3,
                      ValueNode arg4)

See Also:

execute(com.oracle.graal.graphbuilderconf.GraphBuilderContext, jdk.internal.jvmci.meta.ResolvedJavaMethod, com.oracle.graal.graphbuilderconf.InvocationPlugin.Receiver, com.oracle.graal.nodes.ValueNode[])

apply

default boolean apply(GraphBuilderContext b,
                      ResolvedJavaMethod targetMethod,
                      InvocationPlugin.Receiver receiver,
                      ValueNode arg1,
                      ValueNode arg2,
                      ValueNode arg3,
                      ValueNode arg4,
                      ValueNode arg5)

See Also:

execute(com.oracle.graal.graphbuilderconf.GraphBuilderContext, jdk.internal.jvmci.meta.ResolvedJavaMethod, com.oracle.graal.graphbuilderconf.InvocationPlugin.Receiver, com.oracle.graal.nodes.ValueNode[])

execute

default boolean execute(GraphBuilderContext b,
                        ResolvedJavaMethod targetMethod,
                        InvocationPlugin.Receiver receiver,
                        ValueNode[] argsIncludingReceiver)

Executes this plugin against a set of invocation arguments. The default implementation in InvocationPlugin dispatches to the apply(...) method that matches the number of arguments or to applyPolymorphic(com.oracle.graal.graphbuilderconf.GraphBuilderContext, jdk.internal.jvmci.meta.ResolvedJavaMethod, com.oracle.graal.graphbuilderconf.InvocationPlugin.Receiver, com.oracle.graal.nodes.ValueNode...) if plugin is signature polymorphic.

Parameters:

targetMethod - the method for which this plugin is being applied

receiver - access to the receiver, null if targetMethod is static

argsIncludingReceiver - all arguments to the invocation include the receiver in position 0 if targetMethod is not static

Returns:

true if this plugin handled the invocation of targetMethod false if the graph builder should process the invoke further (e.g., by inlining it or creating an Invoke node). A plugin that does not handle an invocation must not modify the graph being constructed.

defaultHandler

default boolean defaultHandler(GraphBuilderContext b,
                               ResolvedJavaMethod targetMethod,
                               InvocationPlugin.Receiver receiver,
                               ValueNode... args)

Handles an invocation when a specific apply method is not available.

getApplySourceLocation

default StackTraceElement getApplySourceLocation(MetaAccessProvider metaAccess)