com.oracle.truffle.api.dsl

Interface NodeFactory<T>

public interface NodeFactory<T>

Enables the dynamic creation of generated nodes. It provides an convenient way to instantiate generated node classes without using reflection.

Since:

0.8 or earlier

Method Summary

Modifier and Type	Method and Description
T	createNode(Object... arguments) Instantiates the node using the arguments array.
List<Class<? extends Node>>	getExecutionSignature() Returns a list of children that will be executed by the created node.
Class<T>	getNodeClass() Returns the node class that will get created by NodeFactory.createNode(Object...).
List<List<Class<?>>>	getNodeSignatures() Returns a list of signatures that can be used to invoke NodeFactory.createNode(Object...).
default T	getUncachedInstance() Returns the uncached version of this node or null if GenerateUncached was not applied to the node.

Method Detail

createNode

T createNode(Object... arguments)

Instantiates the node using the arguments array. The arguments length and types must suffice one of the returned signatures in NodeFactory.getNodeSignatures(). If the arguments array does not suffice one of the node signatures an IllegalArgumentException is thrown.

Parameters:

arguments - the argument values

Returns:

the instantiated node

Throws:

IllegalArgumentException

Since:

0.8 or earlier

getNodeClass

Class<T> getNodeClass()

Returns the node class that will get created by NodeFactory.createNode(Object...). The node class does not match exactly to the instantiated object but they are guaranteed to be assignable.

Since:

0.8 or earlier

getNodeSignatures

List<List<Class<?>>> getNodeSignatures()

Returns a list of signatures that can be used to invoke NodeFactory.createNode(Object...).

Since:

0.8 or earlier

getExecutionSignature

List<Class<? extends Node>> getExecutionSignature()

Returns a list of children that will be executed by the created node. This is useful for base nodes that can execute a variable amount of nodes.

Since:

0.8 or earlier

getUncachedInstance

default T getUncachedInstance()

Returns the uncached version of this node or null if GenerateUncached was not applied to the node.

Since:

19.1.0