org.graalvm.compiler.nodes.graphbuilderconf

Class InvocationPlugins

java.lang.Object

org.graalvm.compiler.nodes.graphbuilderconf.InvocationPlugins

public class InvocationPlugins
extends Object

Manages a set of InvocationPlugins. Most plugins are registered during initialization (i.e., before InvocationPlugins.lookupInvocation(ResolvedJavaMethod) or InvocationPlugins.getBindings(boolean) is called). These registrations can be made with InvocationPlugins.Registration, InvocationPlugins.register(InvocationPlugin, String, String, Type...), InvocationPlugins.register(InvocationPlugin, Type, String, Type...) or InvocationPlugins.registerOptional(InvocationPlugin, Type, String, Type...). Initialization is not thread-safe and so must only be performed by a single thread. Plugins that are not guaranteed to be made during initialization must use InvocationPlugins.LateRegistration.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	InvocationPlugins.Binding Associates an InvocationPlugin with the details of a method it substitutes.
static class	InvocationPlugins.InvocationPluginReceiver
static class	InvocationPlugins.LateRegistration Utility for registering plugins after Graal may have been initialized.
static class	InvocationPlugins.Registration Utility for registration of invocation plugins.
static class	InvocationPlugins.ResolvedJavaSymbol A symbol for an already resolved method.

Field Summary

Fields

Modifier and Type	Field and Description
protected InvocationPlugins	parent The plugins searched before searching in this object.

Constructor Summary

Constructors

Constructor and Description
InvocationPlugins() Creates a set of invocation plugins with no parent.
InvocationPlugins(InvocationPlugins parent) Creates a set of invocation plugins.
InvocationPlugins(Map<jdk.vm.ci.meta.ResolvedJavaMethod,InvocationPlugin> plugins, InvocationPlugins parent) Creates a closed set of invocation plugins for a set of resolved methods.

Method Summary

Modifier and Type	Method and Description
void	addTestPlugins(InvocationPlugins other, List<org.graalvm.collections.Pair<String,InvocationPlugins.Binding>> ignored) Extends the plugins in this object with those from other.
boolean	canBeIntrinsified(jdk.vm.ci.meta.ResolvedJavaType declaringClass) Determines if methods in a given class can have invocation plugins.
void	checkNewNodes(GraphBuilderContext b, InvocationPlugin plugin, NodeIterable<Node> newNodes) Checks a set of nodes added to the graph by an InvocationPlugin.
void	closeRegistration() Processes deferred registrations and then closes this object for future registration.
void	defer(Runnable deferrable) Adds a Runnable for doing registration deferred until the first time InvocationPlugins.get(ResolvedJavaMethod) or InvocationPlugins.closeRegistration() is called on this object.
org.graalvm.collections.EconomicMap<String,List<InvocationPlugins.Binding>>	getBindings(boolean includeParents) Gets the set of registered invocation plugins.
InvocationPlugins	getParent() Gets the invocation plugins searched before searching in this object.
boolean	isEmpty() Determines if this object currently contains any plugins (in any state of registration).
InvocationPlugin	lookupInvocation(jdk.vm.ci.meta.ResolvedJavaMethod method) Gets the plugin for a given method.
protected void	register(InvocationPlugin plugin, boolean isOptional, boolean allowOverwrite, Type declaringClass, String name, Type... argumentTypes)
void	register(InvocationPlugin plugin, String declaringClass, String name, Type... argumentTypes)
void	register(InvocationPlugin plugin, Type declaringClass, String name, Type... argumentTypes) Registers an invocation plugin for a given method.
void	registerOptional(InvocationPlugin plugin, Type declaringClass, String name, Type... argumentTypes) Registers an invocation plugin for a given, optional method.
void	removeTestPlugins(InvocationPlugins other) Removes the plugins from other in this object that were added by InvocationPlugins.addTestPlugins(org.graalvm.compiler.nodes.graphbuilderconf.InvocationPlugins, java.util.List<org.graalvm.collections.Pair<java.lang.String, org.graalvm.compiler.nodes.graphbuilderconf.InvocationPlugins.Binding>>).
static Class<?>	resolveClass(String className, boolean optional) Resolves a name to a class.
static Constructor<?>	resolveConstructor(Class<?> declaringClass, InvocationPlugins.Binding binding) Resolves a given binding to a constructor in a given class.
static jdk.vm.ci.meta.ResolvedJavaMethod	resolveJavaMethod(jdk.vm.ci.meta.ResolvedJavaType declaringClass, InvocationPlugins.Binding binding) Same as InvocationPlugins.resolveMethod(Class, Binding) and InvocationPlugins.resolveConstructor(Class, Binding) except in terms of ResolvedJavaType and ResolvedJavaMethod.
static Method	resolveMethod(Class<?> declaringClass, InvocationPlugins.Binding binding) Resolves a given binding to a method in a given class.
static Class<?>	resolveType(Type type, boolean optional) Resolves a Type to a Class.
String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

parent

protected final InvocationPlugins parent

The plugins searched before searching in this object.

Constructor Detail

InvocationPlugins

public InvocationPlugins()

Creates a set of invocation plugins with no parent.

InvocationPlugins

public InvocationPlugins(InvocationPlugins parent)

Creates a set of invocation plugins.

Parameters:

parent - if non-null, this object will be searched first when looking up plugins

InvocationPlugins

public InvocationPlugins(Map<jdk.vm.ci.meta.ResolvedJavaMethod,InvocationPlugin> plugins,
                         InvocationPlugins parent)

Creates a closed set of invocation plugins for a set of resolved methods. Such an object cannot have further plugins registered.

Method Detail

defer

public void defer(Runnable deferrable)

Adds a Runnable for doing registration deferred until the first time InvocationPlugins.get(ResolvedJavaMethod) or InvocationPlugins.closeRegistration() is called on this object.

canBeIntrinsified

public boolean canBeIntrinsified(jdk.vm.ci.meta.ResolvedJavaType declaringClass)

Determines if methods in a given class can have invocation plugins.

Parameters:

declaringClass - the class to test

addTestPlugins

public void addTestPlugins(InvocationPlugins other,
                           List<org.graalvm.collections.Pair<String,InvocationPlugins.Binding>> ignored)

Extends the plugins in this object with those from other. The added plugins should be removed after the test. This extension mechanism exists only for tests that want to add extra invocation plugins after the compiler has been initialized.

Parameters:

ignored - if non-null, the bindings from other already in this object prior to calling this method are added to this list. These bindings are not added to this object.

removeTestPlugins

public void removeTestPlugins(InvocationPlugins other)

Removes the plugins from other in this object that were added by InvocationPlugins.addTestPlugins(org.graalvm.compiler.nodes.graphbuilderconf.InvocationPlugins, java.util.List<org.graalvm.collections.Pair<java.lang.String, org.graalvm.compiler.nodes.graphbuilderconf.InvocationPlugins.Binding>>).

closeRegistration

public void closeRegistration()

Processes deferred registrations and then closes this object for future registration.

isEmpty

public boolean isEmpty()

Determines if this object currently contains any plugins (in any state of registration). If this object has any deferred registrations, it is assumed that executing them will result in at least one plugin being registered.

register

protected void register(InvocationPlugin plugin,
                        boolean isOptional,
                        boolean allowOverwrite,
                        Type declaringClass,
                        String name,
                        Type... argumentTypes)

register

public final void register(InvocationPlugin plugin,
                           Type declaringClass,
                           String name,
                           Type... argumentTypes)

Registers an invocation plugin for a given method. There must be no plugin currently registered for method.

Parameters:

argumentTypes - the argument types of the method. Element 0 of this array must be the Class value for InvocationPlugin.Receiver iff the method is non-static. Upon returning, element 0 will have been rewritten to declaringClass

register

public final void register(InvocationPlugin plugin,
                           String declaringClass,
                           String name,
                           Type... argumentTypes)

registerOptional

public final void registerOptional(InvocationPlugin plugin,
                                   Type declaringClass,
                                   String name,
                                   Type... argumentTypes)

Registers an invocation plugin for a given, optional method. There must be no plugin currently registered for method.

Parameters:

argumentTypes - the argument types of the method. Element 0 of this array must be the Class value for InvocationPlugin.Receiver iff the method is non-static. Upon returning, element 0 will have been rewritten to declaringClass

lookupInvocation

public InvocationPlugin lookupInvocation(jdk.vm.ci.meta.ResolvedJavaMethod method)

Gets the plugin for a given method.

Parameters:

method - the method to lookup

Returns:

the plugin associated with method or null if none exists

getBindings

public org.graalvm.collections.EconomicMap<String,List<InvocationPlugins.Binding>> getBindings(boolean includeParents)

Gets the set of registered invocation plugins.

Returns:

a map from class names in internal form to the invocation plugin bindings for methods in the class

getParent

public InvocationPlugins getParent()

Gets the invocation plugins searched before searching in this object.

toString

public String toString()

Overrides:

toString in class Object

checkNewNodes

public void checkNewNodes(GraphBuilderContext b,
                          InvocationPlugin plugin,
                          NodeIterable<Node> newNodes)

Checks a set of nodes added to the graph by an InvocationPlugin.

Parameters:

b - the graph builder that applied the plugin

plugin - a plugin that was just applied

newNodes - the nodes added to the graph by plugin

Throws:

AssertionError - if any check fail

resolveClass

public static Class<?> resolveClass(String className,
                                    boolean optional)

Resolves a name to a class.

Parameters:

className - the name of the class to resolve

optional - if true, resolution failure returns null

Returns:

the resolved class or null if resolution fails and optional is true

resolveType

public static Class<?> resolveType(Type type,
                                   boolean optional)

Resolves a Type to a Class.

Parameters:

type - the type to resolve

optional - if true, resolution failure returns null

Returns:

the resolved class or null if resolution fails and optional is true

resolveMethod

public static Method resolveMethod(Class<?> declaringClass,
                                   InvocationPlugins.Binding binding)

Resolves a given binding to a method in a given class. If more than one method with the parameter types matching binding is found and the return types of all the matching methods form an inheritance chain, the one with the most specific type is returned; otherwise NoSuchMethodError is thrown.

Parameters:

declaringClass - the class to search for a method matching binding

Returns:

the method (if any) in declaringClass matching binding

resolveJavaMethod

public static jdk.vm.ci.meta.ResolvedJavaMethod resolveJavaMethod(jdk.vm.ci.meta.ResolvedJavaType declaringClass,
                                                                  InvocationPlugins.Binding binding)

Same as InvocationPlugins.resolveMethod(Class, Binding) and InvocationPlugins.resolveConstructor(Class, Binding) except in terms of ResolvedJavaType and ResolvedJavaMethod.

resolveConstructor

public static Constructor<?> resolveConstructor(Class<?> declaringClass,
                                                InvocationPlugins.Binding binding)

Resolves a given binding to a constructor in a given class.

Parameters:

declaringClass - the class to search for a constructor matching binding

Returns:

the constructor (if any) in declaringClass matching binding