org.graalvm.compiler.nodes.graphbuilderconf

Interface InvocationPlugin

All Superinterfaces:

GraphBuilderPlugin

All Known Implementing Classes:

ForeignCallPlugin, GeneratedFoldInvocationPlugin, GeneratedInvocationPlugin, GeneratedNodeIntrinsicInvocationPlugin, MethodSubstitutionPlugin, StandardGraphBuilderPlugins.BoxPlugin, StandardGraphBuilderPlugins.StringIndexOfConstantPlugin, StandardGraphBuilderPlugins.StringLatin1IndexOfConstantPlugin, StandardGraphBuilderPlugins.StringUTF16IndexOfConstantPlugin, StandardGraphBuilderPlugins.UnboxPlugin, StandardGraphBuilderPlugins.UnsafeAccessPlugin, StandardGraphBuilderPlugins.UnsafeFencePlugin, StandardGraphBuilderPlugins.UnsafeGetPlugin, StandardGraphBuilderPlugins.UnsafePutPlugin, StandardGraphBuilderPlugins.UnsignedMathPlugin

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, jdk.vm.ci.meta.ResolvedJavaMethod targetMethod, InvocationPlugin.Receiver receiver)
default boolean	apply(GraphBuilderContext b, jdk.vm.ci.meta.ResolvedJavaMethod targetMethod, InvocationPlugin.Receiver receiver, ValueNode arg)
default boolean	apply(GraphBuilderContext b, jdk.vm.ci.meta.ResolvedJavaMethod targetMethod, InvocationPlugin.Receiver receiver, ValueNode arg1, ValueNode arg2)
default boolean	apply(GraphBuilderContext b, jdk.vm.ci.meta.ResolvedJavaMethod targetMethod, InvocationPlugin.Receiver receiver, ValueNode arg1, ValueNode arg2, ValueNode arg3)
default boolean	apply(GraphBuilderContext b, jdk.vm.ci.meta.ResolvedJavaMethod targetMethod, InvocationPlugin.Receiver receiver, ValueNode arg1, ValueNode arg2, ValueNode arg3, ValueNode arg4)
default boolean	apply(GraphBuilderContext b, jdk.vm.ci.meta.ResolvedJavaMethod targetMethod, InvocationPlugin.Receiver receiver, ValueNode arg1, ValueNode arg2, ValueNode arg3, ValueNode arg4, ValueNode arg5)
default boolean	apply(GraphBuilderContext b, jdk.vm.ci.meta.ResolvedJavaMethod targetMethod, InvocationPlugin.Receiver receiver, ValueNode arg1, ValueNode arg2, ValueNode arg3, ValueNode arg4, ValueNode arg5, ValueNode arg6)
default boolean	apply(GraphBuilderContext b, jdk.vm.ci.meta.ResolvedJavaMethod targetMethod, InvocationPlugin.Receiver receiver, ValueNode arg1, ValueNode arg2, ValueNode arg3, ValueNode arg4, ValueNode arg5, ValueNode arg6, ValueNode arg7)
default boolean	defaultHandler(GraphBuilderContext b, jdk.vm.ci.meta.ResolvedJavaMethod targetMethod, InvocationPlugin.Receiver receiver, ValueNode... args) Handles an invocation when a specific apply method is not available.
default boolean	execute(GraphBuilderContext b, jdk.vm.ci.meta.ResolvedJavaMethod targetMethod, InvocationPlugin.Receiver receiver, ValueNode[] argsIncludingReceiver) Executes this plugin against a set of invocation arguments.
default StackTraceElement	getApplySourceLocation(jdk.vm.ci.meta.MetaAccessProvider metaAccess)
default boolean	inlineOnly() Determines if this plugin can only be used when inlining the method is it associated with.
default boolean	isDecorator() Determines if this plugin only decorates the method is it associated with.

Method Detail

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.

isDecorator

default boolean isDecorator()

Determines if this plugin only decorates the method is it associated with. That is, it inserts nodes prior to the invocation (e.g. some kind of marker nodes) but still expects the parser to process the invocation further.

apply

default boolean apply(GraphBuilderContext b,
                      jdk.vm.ci.meta.ResolvedJavaMethod targetMethod,
                      InvocationPlugin.Receiver receiver)

See Also:

InvocationPlugin.execute(org.graalvm.compiler.nodes.graphbuilderconf.GraphBuilderContext, jdk.vm.ci.meta.ResolvedJavaMethod, org.graalvm.compiler.nodes.graphbuilderconf.InvocationPlugin.Receiver, org.graalvm.compiler.nodes.ValueNode[])

apply

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

See Also:

InvocationPlugin.execute(org.graalvm.compiler.nodes.graphbuilderconf.GraphBuilderContext, jdk.vm.ci.meta.ResolvedJavaMethod, org.graalvm.compiler.nodes.graphbuilderconf.InvocationPlugin.Receiver, org.graalvm.compiler.nodes.ValueNode[])

apply

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

See Also:

InvocationPlugin.execute(org.graalvm.compiler.nodes.graphbuilderconf.GraphBuilderContext, jdk.vm.ci.meta.ResolvedJavaMethod, org.graalvm.compiler.nodes.graphbuilderconf.InvocationPlugin.Receiver, org.graalvm.compiler.nodes.ValueNode[])

apply

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

See Also:

InvocationPlugin.execute(org.graalvm.compiler.nodes.graphbuilderconf.GraphBuilderContext, jdk.vm.ci.meta.ResolvedJavaMethod, org.graalvm.compiler.nodes.graphbuilderconf.InvocationPlugin.Receiver, org.graalvm.compiler.nodes.ValueNode[])

apply

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

See Also:

InvocationPlugin.execute(org.graalvm.compiler.nodes.graphbuilderconf.GraphBuilderContext, jdk.vm.ci.meta.ResolvedJavaMethod, org.graalvm.compiler.nodes.graphbuilderconf.InvocationPlugin.Receiver, org.graalvm.compiler.nodes.ValueNode[])

apply

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

See Also:

InvocationPlugin.execute(org.graalvm.compiler.nodes.graphbuilderconf.GraphBuilderContext, jdk.vm.ci.meta.ResolvedJavaMethod, org.graalvm.compiler.nodes.graphbuilderconf.InvocationPlugin.Receiver, org.graalvm.compiler.nodes.ValueNode[])

apply

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

See Also:

InvocationPlugin.execute(org.graalvm.compiler.nodes.graphbuilderconf.GraphBuilderContext, jdk.vm.ci.meta.ResolvedJavaMethod, org.graalvm.compiler.nodes.graphbuilderconf.InvocationPlugin.Receiver, org.graalvm.compiler.nodes.ValueNode[])

apply

default boolean apply(GraphBuilderContext b,
                      jdk.vm.ci.meta.ResolvedJavaMethod targetMethod,
                      InvocationPlugin.Receiver receiver,
                      ValueNode arg1,
                      ValueNode arg2,
                      ValueNode arg3,
                      ValueNode arg4,
                      ValueNode arg5,
                      ValueNode arg6,
                      ValueNode arg7)

See Also:

InvocationPlugin.execute(org.graalvm.compiler.nodes.graphbuilderconf.GraphBuilderContext, jdk.vm.ci.meta.ResolvedJavaMethod, org.graalvm.compiler.nodes.graphbuilderconf.InvocationPlugin.Receiver, org.graalvm.compiler.nodes.ValueNode[])

execute

default boolean execute(GraphBuilderContext b,
                        jdk.vm.ci.meta.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.

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 unless it is a decorator.

defaultHandler

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

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

getApplySourceLocation

default StackTraceElement getApplySourceLocation(jdk.vm.ci.meta.MetaAccessProvider metaAccess)