org.graalvm.compiler.nodes.extended

Class BytecodeExceptionNode

java.lang.Object

org.graalvm.compiler.graph.Node

org.graalvm.compiler.nodes.ValueNode

org.graalvm.compiler.nodes.FixedNode

org.graalvm.compiler.nodes.FixedWithNextNode

org.graalvm.compiler.nodes.AbstractStateSplit

org.graalvm.compiler.nodes.memory.AbstractMemoryCheckpoint

org.graalvm.compiler.nodes.extended.BytecodeExceptionNode

All Implemented Interfaces:

Cloneable, Formattable, MemoryKillMarker, CanonicalizableMarker, FixedNodeInterface, FixedWithNextNodeInterface, MemoryKill, SingleMemoryKill, Canonicalizable, Lowerable, NodeWithState, StateSplit, ValueNodeInterface

public final class BytecodeExceptionNode
extends AbstractMemoryCheckpoint
implements Lowerable, SingleMemoryKill, Canonicalizable

A node that represents an exception thrown implicitly by a Java bytecode. It can be lowered to either a foreign call or a pre-allocated exception object.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	BytecodeExceptionNode.BytecodeExceptionKind

Nested classes/interfaces inherited from class org.graalvm.compiler.graph.Node

Node.ConstantNodeParameter, Node.EdgeVisitor, Node.IndirectCanonicalization, Node.InjectedNodeParameter, Node.Input, Node.NodeInsertionStackTrace, Node.NodeIntrinsic, Node.NodeIntrinsicFactory, Node.OptionalInput, Node.Successor, Node.ValueNumberable

Nested classes/interfaces inherited from interface org.graalvm.compiler.nodes.memory.MemoryKill

MemoryKill.NoLocation

Nested classes/interfaces inherited from interface org.graalvm.compiler.nodes.spi.Canonicalizable

Canonicalizable.Binary<T extends Node>, Canonicalizable.BinaryCommutative<T extends Node>, Canonicalizable.Ternary<T extends Node>, Canonicalizable.Unary<T extends Node>

Field Summary

Fields

Modifier and Type	Field and Description
protected BytecodeExceptionNode.BytecodeExceptionKind	exceptionKind
static NodeClass<BytecodeExceptionNode>	TYPE

Fields inherited from class org.graalvm.compiler.nodes.AbstractStateSplit

stateAfter

Fields inherited from class org.graalvm.compiler.nodes.FixedWithNextNode

next

Fields inherited from class org.graalvm.compiler.nodes.ValueNode

EMPTY_ARRAY, stamp

Fields inherited from class org.graalvm.compiler.graph.Node

NODE_LIST, NOT_ITERABLE, TRACK_CREATION_POSITION, WithAllEdges, WithNoEdges, WithOnlyInputEdges, WithOnlySucessorEdges

Fields inherited from interface org.graalvm.compiler.nodes.memory.MemoryKill

MULTI_KILL_NO_LOCATION, NO_LOCATION

Constructor Summary

Constructors

Constructor and Description
BytecodeExceptionNode(MetaAccessProvider metaAccess, BytecodeExceptionNode.BytecodeExceptionKind exceptionKind, ValueNode... arguments)

Method Summary

Modifier and Type	Method and Description
Node	canonical(CanonicalizerTool tool) Implementations of this method can provide local optimizations like constant folding and strength reduction.
FrameState	createStateDuring() Create a new stateDuring for use by a foreign call.
NodeInputList<ValueNode>	getArguments()
BytecodeExceptionNode.BytecodeExceptionKind	getExceptionKind()
org.graalvm.word.LocationIdentity	getKilledLocationIdentity() This method is used to determine which memory location is killed by this node.
String	toString(Verbosity verbosity) Creates a String representation for this with a given Verbosity.

Methods inherited from class org.graalvm.compiler.nodes.AbstractStateSplit

hasSideEffect, setStateAfter, stateAfter, verify

Methods inherited from class org.graalvm.compiler.nodes.FixedWithNextNode

asFixedWithNextNode, next, setNext

Methods inherited from class org.graalvm.compiler.nodes.FixedNode

asFixedNode

Methods inherited from class org.graalvm.compiler.nodes.ValueNode

asConstant, asJavaConstant, asNode, asSerializableConstant, checkReplaceAtUsagesInvariants, getStackKind, graph, hasUsagesOtherThan, inferStamp, isAllowedUsageType, isConstant, isConstantPredicate, isDefaultConstant, isIllegalConstant, isJavaConstant, isNullConstant, isSerializableConstant, recursivelyDataFlowEqualsUpTo, setStamp, stamp, updateStamp, updateUsagesInterface

Methods inherited from class org.graalvm.compiler.graph.Node

afterClone, applyInputs, applySuccessors, assertFalse, assertTrue, cfgPredecessors, cfgSuccessors, clearInputs, clearNodeSourcePosition, clearSuccessors, copyWithInputs, copyWithInputs, dataFlowEquals, dynamicNodeSizeEstimate, estimatedNodeCycles, estimatedNodeSize, fail, formatTo, getCreationPosition, getDebug, getDebugProperties, getDebugProperties, getInsertionPosition, getNodeClass, getNodeSourcePosition, getOptions, getUsageCount, hasExactlyOneUsage, hashCode, hasMoreThanOneUsage, hasNoUsages, hasOnlyUsagesOfType, hasUsages, hasUsagesOfType, inputPositions, inputs, isAlive, isDeleted, isUnregistered, markDeleted, maybeNotifyZeroUsages, modCount, predecessor, pushInputs, removeUsage, replaceAllInputs, replaceAndDelete, replaceAtAllUsages, replaceAtMatchingUsages, replaceAtPredecessor, replaceAtUsages, replaceAtUsages, replaceAtUsages, replaceAtUsages, replaceAtUsages, replaceAtUsagesAndDelete, replaceAtUsagesAndDelete, replaceFirstInput, replaceFirstSuccessor, safeDelete, setCreationPosition, setInsertionPosition, setNodeSourcePosition, singleUsage, successorPositions, successors, toString, updateNodeSourcePosition, updatePredecessor, updateUsages, usages, valueEquals, verifyEdges, verifyInputs, verifySourcePosition, withNodeSourcePosition

Methods inherited from class java.lang.Object

clone, equals, getClass, notify, notifyAll, wait, wait, wait

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

lower

Methods inherited from interface org.graalvm.compiler.nodes.memory.MemoryKill

asMultiMemoryKill, asSingleMemoryKill, isMemoryKill, isMultiMemoryKill, isSingleMemoryKill

Methods inherited from interface org.graalvm.compiler.nodes.ValueNodeInterface

asNode

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

states

Methods inherited from interface org.graalvm.compiler.nodes.FixedNodeInterface

asFixedNode

Field Detail

TYPE

public static final NodeClass<BytecodeExceptionNode> TYPE

exceptionKind

protected final BytecodeExceptionNode.BytecodeExceptionKind exceptionKind

Constructor Detail

BytecodeExceptionNode

public BytecodeExceptionNode(MetaAccessProvider metaAccess,
                             BytecodeExceptionNode.BytecodeExceptionKind exceptionKind,
                             ValueNode... arguments)

Method Detail

getExceptionKind

public BytecodeExceptionNode.BytecodeExceptionKind getExceptionKind()

toString

public String toString(Verbosity verbosity)

Description copied from class: Node

Creates a String representation for this with a given Verbosity.

Overrides:

toString in class Node

getKilledLocationIdentity

public org.graalvm.word.LocationIdentity getKilledLocationIdentity()

Description copied from interface: SingleMemoryKill

This method is used to determine which memory location is killed by this node. Returning the special value LocationIdentity.any() will kill all memory locations.

Specified by:

getKilledLocationIdentity in interface SingleMemoryKill

Returns:

the identity of the location killed by this node.

canonical

public Node canonical(CanonicalizerTool tool)

Description copied from interface: Canonicalizable

Implementations of this method can provide local optimizations like constant folding and strength reduction. Implementations should look at the properties and inputs of the current node and determine if there is a more optimal and always semantically correct replacement.
The return value determines the effect that the canonicalization will have:

• Returning an pre-existing node will replace the current node with the given one.
• Returning a newly created node (that was not yet added to the graph) will replace the current node with the given one, after adding it to the graph. If both the replacement and the replacee are anchored in control flow (fixed nodes), the replacement will be added to the control flow. It is invalid to replace a non-fixed node with a newly created fixed node (because its placement in the control flow cannot be determined without scheduling).
• Returning null will delete the current node and replace it with null at all usages. Note that it is not necessary to delete floating nodes that have no more usages this way - they will be deleted automatically.

Specified by:

canonical in interface Canonicalizable

Parameters:

tool - provides access to runtime interfaces like MetaAccessProvider

getArguments

public NodeInputList<ValueNode> getArguments()

createStateDuring

public FrameState createStateDuring()

Create a new stateDuring for use by a foreign call.