org.graalvm.compiler.nodes.spi

Class DelegatingReplacements

java.lang.Object

org.graalvm.compiler.nodes.spi.DelegatingReplacements

All Implemented Interfaces:

GeneratedPluginInjectionProvider, Replacements

public class DelegatingReplacements
extends Object
implements Replacements

A convenience class for overriding just a portion of the Replacements API.

Field Summary

Fields

Modifier and Type	Field and Description
protected Replacements	delegate

Constructor Summary

Constructors

Constructor and Description
DelegatingReplacements(Replacements delegate)

Method Summary

Modifier and Type	Method and Description
BytecodeProvider	getDefaultReplacementBytecodeProvider() Gets the provider for accessing the bytecode of a substitution method if no other provider is associated with the substitution method.
GraphBuilderConfiguration.Plugins	getGraphBuilderPlugins() Gets the object managing the various graph builder plugins used by this object when parsing bytecode into a graph.
<T> T	getInjectedArgument(Class<T> type)
Stamp	getInjectedStamp(Class<?> type, boolean nonNull) Gets a stamp denoting a given type and non-nullness property.
StructuredGraph	getInlineSubstitution(ResolvedJavaMethod method, int invokeBci, Invoke.InlineControl inlineControl, boolean trackNodeSourcePosition, NodeSourcePosition replaceePosition, StructuredGraph.AllowAssumptions allowAssumptions, OptionValues options) Gets a graph that is a substitution for a given method.
StructuredGraph	getIntrinsicGraph(ResolvedJavaMethod method, CompilationIdentifier compilationId, DebugContext debug, StructuredGraph.AllowAssumptions allowAssumptions, Cancellable cancellable) Gets a graph produced from the intrinsic for a given method that can be compiled and installed for the method.
Class<? extends GraphBuilderPlugin>	getIntrinsifyingPlugin(ResolvedJavaMethod method) Gets the plugin type that intrinsifies calls to method.
CoreProviders	getProviders()
StructuredGraph	getSnippet(ResolvedJavaMethod method, ResolvedJavaMethod recursiveEntry, Object[] args, BitSet nonNullParameters, boolean trackNodeSourcePosition, NodeSourcePosition replaceePosition, OptionValues options) Gets the snippet graph derived from a given method.
SnippetParameterInfo	getSnippetParameterInfo(ResolvedJavaMethod method) Get the snippet metadata required to inline the snippet.
<T extends SnippetTemplateCache> T	getSnippetTemplateCache(Class<T> templatesClass) Get snippet templates that were registered with Replacements.registerSnippetTemplateCache(SnippetTemplateCache).
JavaKind	getWordKind() Gets the JavaKind corresponding to word values.
boolean	hasSubstitution(ResolvedJavaMethod method, OptionValues options) Determines if there may be a substitution graph for a given method.
boolean	isEncodingSnippets() Returns true if this Replacements is being used for preparation of snippets and substitutions for libgraal.
boolean	isSnippet(ResolvedJavaMethod method) Return true if the method is a Snippet.
DebugContext	openSnippetDebugContext(DebugContext.Description description, DebugContext outer, OptionValues options) Create a DebugContext for use with Snippet related work.
void	registerConditionalPlugin(InvocationPlugin plugin) Marks a plugin as conditionally applied.
void	registerSnippet(ResolvedJavaMethod method, ResolvedJavaMethod original, Object receiver, boolean trackNodeSourcePosition, OptionValues options) Registers a method as snippet.
void	registerSnippetTemplateCache(SnippetTemplateCache snippetTemplates) Register snippet templates.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.graalvm.compiler.nodes.spi.Replacements

closeSnippetRegistration

Field Detail

delegate

protected final Replacements delegate

Constructor Detail

DelegatingReplacements

public DelegatingReplacements(Replacements delegate)

Method Detail

getProviders

public CoreProviders getProviders()

Specified by:

getProviders in interface Replacements

getInjectedArgument

public <T> T getInjectedArgument(Class<T> type)

Specified by:

getInjectedArgument in interface GeneratedPluginInjectionProvider

getInjectedStamp

public Stamp getInjectedStamp(Class<?> type,
                              boolean nonNull)

Description copied from interface: GeneratedPluginInjectionProvider

Gets a stamp denoting a given type and non-nullness property.

Specified by:

getInjectedStamp in interface GeneratedPluginInjectionProvider

Parameters:

type - the type the returned stamp represents

nonNull - specifies if the returned stamp denotes a value that is guaranteed to be non-null

getGraphBuilderPlugins

public GraphBuilderConfiguration.Plugins getGraphBuilderPlugins()

Description copied from interface: Replacements

Gets the object managing the various graph builder plugins used by this object when parsing bytecode into a graph.

Specified by:

getGraphBuilderPlugins in interface Replacements

getIntrinsifyingPlugin

public Class<? extends GraphBuilderPlugin> getIntrinsifyingPlugin(ResolvedJavaMethod method)

Description copied from interface: Replacements

Gets the plugin type that intrinsifies calls to method.

Specified by:

getIntrinsifyingPlugin in interface Replacements

openSnippetDebugContext

public DebugContext openSnippetDebugContext(DebugContext.Description description,
                                            DebugContext outer,
                                            OptionValues options)

Description copied from interface: Replacements

Create a DebugContext for use with Snippet related work. Snippet processingis hidden by default using the flags DebugStubsAndSnippets.

Specified by:

openSnippetDebugContext in interface Replacements

getSnippet

public StructuredGraph getSnippet(ResolvedJavaMethod method,
                                  ResolvedJavaMethod recursiveEntry,
                                  Object[] args,
                                  BitSet nonNullParameters,
                                  boolean trackNodeSourcePosition,
                                  NodeSourcePosition replaceePosition,
                                  OptionValues options)

Description copied from interface: Replacements

Gets the snippet graph derived from a given method.

Specified by:

getSnippet in interface Replacements

recursiveEntry - XXX always null now?.

args - arguments to the snippet if available, otherwise null

Returns:

the snippet graph, if any, that is derived from method

getSnippetParameterInfo

public SnippetParameterInfo getSnippetParameterInfo(ResolvedJavaMethod method)

Description copied from interface: Replacements

Get the snippet metadata required to inline the snippet.

Specified by:

getSnippetParameterInfo in interface Replacements

isSnippet

public boolean isSnippet(ResolvedJavaMethod method)

Description copied from interface: Replacements

Return true if the method is a Snippet.

Specified by:

isSnippet in interface Replacements

isEncodingSnippets

public boolean isEncodingSnippets()

Description copied from interface: Replacements

Returns true if this Replacements is being used for preparation of snippets and substitutions for libgraal.

Specified by:

isEncodingSnippets in interface Replacements

registerSnippet

public void registerSnippet(ResolvedJavaMethod method,
                            ResolvedJavaMethod original,
                            Object receiver,
                            boolean trackNodeSourcePosition,
                            OptionValues options)

Description copied from interface: Replacements

Registers a method as snippet.

Specified by:

registerSnippet in interface Replacements

registerConditionalPlugin

public void registerConditionalPlugin(InvocationPlugin plugin)

Description copied from interface: Replacements

Marks a plugin as conditionally applied. In the contenxt of libgraal conditional plugins can't be used in during graph encoding for snippets and method substitutions and this is used to detect violations of this restriction.

Specified by:

registerConditionalPlugin in interface Replacements

getInlineSubstitution

public StructuredGraph getInlineSubstitution(ResolvedJavaMethod method,
                                             int invokeBci,
                                             Invoke.InlineControl inlineControl,
                                             boolean trackNodeSourcePosition,
                                             NodeSourcePosition replaceePosition,
                                             StructuredGraph.AllowAssumptions allowAssumptions,
                                             OptionValues options)

Description copied from interface: Replacements

Gets a graph that is a substitution for a given method.

Specified by:

getInlineSubstitution in interface Replacements

invokeBci - the call site BCI for the substitution

Returns:

the graph, if any, that is a substitution for method

getIntrinsicGraph

public StructuredGraph getIntrinsicGraph(ResolvedJavaMethod method,
                                         CompilationIdentifier compilationId,
                                         DebugContext debug,
                                         StructuredGraph.AllowAssumptions allowAssumptions,
                                         Cancellable cancellable)

Description copied from interface: Replacements

Gets a graph produced from the intrinsic for a given method that can be compiled and installed for the method.

Specified by:

getIntrinsicGraph in interface Replacements

Returns:

an intrinsic graph that can be compiled and installed for method or null

hasSubstitution

public boolean hasSubstitution(ResolvedJavaMethod method,
                               OptionValues options)

Description copied from interface: Replacements

Determines if there may be a substitution graph for a given method. A call to Replacements.getInlineSubstitution(ResolvedJavaMethod, int, org.graalvm.compiler.nodes.Invoke.InlineControl, boolean, org.graalvm.compiler.graph.NodeSourcePosition, org.graalvm.compiler.nodes.StructuredGraph.AllowAssumptions, org.graalvm.compiler.options.OptionValues) may still return null for method and substitution may be based on an InvocationPlugin that returns false for InvocationPlugin.execute(org.graalvm.compiler.nodes.graphbuilderconf.GraphBuilderContext, ResolvedJavaMethod, org.graalvm.compiler.nodes.graphbuilderconf.InvocationPlugin.Receiver, org.graalvm.compiler.nodes.ValueNode[]) making it impossible to create a substitute graph.

Specified by:

hasSubstitution in interface Replacements

Returns:

true iff there may be a substitution graph available for method

getDefaultReplacementBytecodeProvider

public BytecodeProvider getDefaultReplacementBytecodeProvider()

Description copied from interface: Replacements

Gets the provider for accessing the bytecode of a substitution method if no other provider is associated with the substitution method.

Specified by:

getDefaultReplacementBytecodeProvider in interface Replacements

registerSnippetTemplateCache

public void registerSnippetTemplateCache(SnippetTemplateCache snippetTemplates)

Description copied from interface: Replacements

Register snippet templates.

Specified by:

registerSnippetTemplateCache in interface Replacements

getSnippetTemplateCache

public <T extends SnippetTemplateCache> T getSnippetTemplateCache(Class<T> templatesClass)

Description copied from interface: Replacements

Get snippet templates that were registered with Replacements.registerSnippetTemplateCache(SnippetTemplateCache).

Specified by:

getSnippetTemplateCache in interface Replacements

getWordKind

public JavaKind getWordKind()

Description copied from interface: Replacements

Gets the JavaKind corresponding to word values.

Specified by:

getWordKind in interface Replacements