org.graalvm.compiler.nodes.java

Class AccessFieldNode

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.java.AccessFieldNode

All Implemented Interfaces:

Cloneable, Formattable, FixedNodeInterface, FixedWithNextNodeInterface, MemoryAccess, OrderedMemoryAccess, Lowerable, ValueNodeInterface

Direct Known Subclasses:

LoadFieldNode, StoreFieldNode

public abstract class AccessFieldNode
extends FixedWithNextNode
implements Lowerable, OrderedMemoryAccess, MemoryAccess

The base class of all instructions that access fields.

Nested Class Summary

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

Field Summary

Fields

Modifier and Type	Field and Description
protected ResolvedJavaField	field
protected FieldLocationIdentity	location
protected MemoryOrderMode	memoryOrder
static NodeClass<AccessFieldNode>	TYPE

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

Constructor Summary

Constructors

Constructor and Description
AccessFieldNode(NodeClass<? extends AccessFieldNode> c, Stamp stamp, ValueNode object, ResolvedJavaField field) Constructs a new access field object.
AccessFieldNode(NodeClass<? extends AccessFieldNode> c, Stamp stamp, ValueNode object, ResolvedJavaField field, MemoryOrderMode memoryOrder) Constructs a new access field object.

Method Summary

Modifier and Type	Method and Description
protected NodeSize	dynamicNodeSizeEstimate() Node subclasses should override this method if they need to specify a dynamically calculated NodeSize value.
ResolvedJavaField	field() Gets the compiler interface field for this field access.
org.graalvm.word.LocationIdentity	getLocationIdentity()
MemoryOrderMode	getMemoryOrder() Note the field access semantics are coupled to the access and not to the field.
boolean	isStatic() Checks whether this field access is an access to a static field.
ValueNode	object()
String	toString(Verbosity verbosity) Creates a String representation for this with a given Verbosity.
boolean	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, 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.OrderedMemoryAccess

ordersMemoryAccesses

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

getLastLocationAccess, setLastLocationAccess

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

asNode

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

asFixedNode

Field Detail

TYPE

public static final NodeClass<AccessFieldNode> TYPE

location

protected final FieldLocationIdentity location

field

protected final ResolvedJavaField field

memoryOrder

protected final MemoryOrderMode memoryOrder

Constructor Detail

AccessFieldNode

public AccessFieldNode(NodeClass<? extends AccessFieldNode> c,
                       Stamp stamp,
                       ValueNode object,
                       ResolvedJavaField field,
                       MemoryOrderMode memoryOrder)

Constructs a new access field object.

Parameters:

object - the instruction producing the receiver object

field - the compiler interface representation of the field

memoryOrder - specifies the memory ordering requirements of the access. This overrides the field volatile modifier.

AccessFieldNode

public AccessFieldNode(NodeClass<? extends AccessFieldNode> c,
                       Stamp stamp,
                       ValueNode object,
                       ResolvedJavaField field)

Constructs a new access field object.

Parameters:

object - the instruction producing the receiver object

field - the compiler interface representation of the field

Method Detail

object

public ValueNode object()

getLocationIdentity

public org.graalvm.word.LocationIdentity getLocationIdentity()

Specified by:

getLocationIdentity in interface MemoryAccess

field

public ResolvedJavaField field()

Gets the compiler interface field for this field access.

Returns:

the compiler interface field for this field access

isStatic

public boolean isStatic()

Checks whether this field access is an access to a static field.

Returns:

true if this field access is to a static field

getMemoryOrder

public MemoryOrderMode getMemoryOrder()

Note the field access semantics are coupled to the access and not to the field. e.g. it's possible to access volatile fields using non-volatile semantics via VarHandles.

Specified by:

getMemoryOrder in interface OrderedMemoryAccess

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

verify

public boolean verify()

Overrides:

verify in class FixedNode

dynamicNodeSizeEstimate

protected NodeSize dynamicNodeSizeEstimate()

Description copied from class: Node

Node subclasses should override this method if they need to specify a dynamically calculated NodeSize value. If the node size is static please use NodeInfo.size(). NOTE: When overriding this method, make sure that *all* field reads are null checked (even if Java semantics seemingly make the value of the field non-null). This is necessary because node size estimates are needed even during graph decoding which, for some nodes, first reflectively creates a stub and then later, reflectively, populates its fields. This method could be invoked between these two points. For this reason, when overriding this method assume that all fields can and will be null.

Overrides:

dynamicNodeSizeEstimate in class Node

Returns:

The estimated node size for this node.