TruffleConstantReflectionProvider (Graal OpenJDK Project Documentation)

java.lang.Object
- com.oracle.graal.truffle.TruffleConstantReflectionProvider

All Implemented Interfaces:: ConstantReflectionProvider

public class TruffleConstantReflectionProvider
extends Object
implements ConstantReflectionProvider

Field Summary

Fields
Modifier and Type Field and Description

private ConstantReflectionProvider graalConstantReflection

private MetaAccessProvider metaAccess

Fields
Modifier and Type	Field and Description
`private ConstantReflectionProvider`	`graalConstantReflection`
`private MetaAccessProvider`	`metaAccess`

Constructor Summary

Constructors
Constructor and Description
`TruffleConstantReflectionProvider(ConstantReflectionProvider graalConstantReflection, MetaAccessProvider metaAccess)`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`ResolvedJavaType`	`asJavaType(Constant constant)` Returns the `ResolvedJavaType` for a `Class` object (or any other object regarded as a class by the VM) encapsulated in the given constant.
`JavaConstant`	`boxPrimitive(JavaConstant source)` Converts the given `primitive` constant to a boxed `object` constant, according to the Java boxing rules.
`Boolean`	`constantEquals(Constant x, Constant y)` Compares two constants for equality.
`JavaConstant`	`forString(String value)` Gets a string as a `JavaConstant`.
`MemoryAccessProvider`	`getMemoryAccessProvider()` Gets raw memory access.
`MethodHandleAccessProvider`	`getMethodHandleAccess()` Gets access to the internals of `MethodHandle`.
`JavaConstant`	`readArrayElement(JavaConstant array, int index)` Reads a value from the given array at the given index.
`Integer`	`readArrayLength(JavaConstant array)` Returns the length of the array constant.
`JavaConstant`	`readConstantArrayElement(JavaConstant array, int index)` Reads a value from the given array at the given index if it is a stable array.
`JavaConstant`	`readConstantArrayElementForOffset(JavaConstant array, long offset)` Reads a value from the given array at the given offset if it is a stable array.
`JavaConstant`	`readConstantFieldValue(JavaField field0, JavaConstant receiver)` Gets the constant value of this field.
`JavaConstant`	`readFieldValue(JavaField field, JavaConstant receiver)` Gets the current value of this field for a given object, if available.
`JavaConstant`	`readStableFieldValue(JavaField field, JavaConstant receiver, boolean isDefaultStable)` Gets the current value of this field for a given object, if available.
`JavaConstant`	`unboxPrimitive(JavaConstant source)` Converts the given `object` constant to a `primitive` constant, according to the Java unboxing rules.
`private boolean`	`verifyFieldValue(ResolvedJavaField field, JavaConstant constant)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - graalConstantReflection
```
private final ConstantReflectionProvider graalConstantReflection
```
  - metaAccess
```
private final MetaAccessProvider metaAccess
```
- Constructor Detail
  - TruffleConstantReflectionProvider
```
public TruffleConstantReflectionProvider(ConstantReflectionProvider graalConstantReflection,
                                         MetaAccessProvider metaAccess)
```
- Method Detail
  - constantEquals
```
public Boolean constantEquals(Constant x,
                              Constant y)
```
    Description copied from interface: ConstantReflectionProvider
    
    Compares two constants for equality. The equality relationship is symmetric. Returns true if the two constants represent the same run time value, false if they are different. Returns null if the constants cannot be compared at this point.
    
    Specified by:
    
    constantEquals in interface ConstantReflectionProvider
  - readArrayLength
```
public Integer readArrayLength(JavaConstant array)
```
    Description copied from interface: ConstantReflectionProvider
    
    Returns the length of the array constant. Returns null if the constant is not an array, or if the array length is not available at this point.
    
    Specified by:
    
    readArrayLength in interface ConstantReflectionProvider
  - readArrayElement
```
public JavaConstant readArrayElement(JavaConstant array,
                                     int index)
```
    Description copied from interface: ConstantReflectionProvider
    
    Reads a value from the given array at the given index. Returns null if the constant is not an array, if the index is out of bounds, or if the value is not available at this point.
    
    Specified by:
    
    readArrayElement in interface ConstantReflectionProvider
  - readConstantArrayElement
```
public JavaConstant readConstantArrayElement(JavaConstant array,
                                             int index)
```
    Description copied from interface: ConstantReflectionProvider
    
    Reads a value from the given array at the given index if it is a stable array. Returns null if the constant is not a stable array, if it is a default value, if the index is out of bounds, or if the value is not available at this point.
    
    Specified by:
    
    readConstantArrayElement in interface ConstantReflectionProvider
  - readConstantArrayElementForOffset
```
public JavaConstant readConstantArrayElementForOffset(JavaConstant array,
                                                      long offset)
```
    Description copied from interface: ConstantReflectionProvider
    
    Reads a value from the given array at the given offset if it is a stable array. The offset will be decoded relative to the platform addressing into an index into the array. Returns null if the constant is not a stable array, if it is a default value, if the offset is out of bounds, or if the value is not available at this point.
    
    Specified by:
    
    readConstantArrayElementForOffset in interface ConstantReflectionProvider
  - readConstantFieldValue
```
public JavaConstant readConstantFieldValue(JavaField field0,
                                           JavaConstant receiver)
```
    Description copied from interface: ConstantReflectionProvider
    
    Gets the constant value of this field. Note that a static final field may not be considered constant if its declaring class is not yet initialized or if it is a well known field that can be updated via other means (e.g., System.setOut(java.io.PrintStream)).
    
    Specified by:
    
    readConstantFieldValue in interface ConstantReflectionProvider
    
    receiver - object from which this field's value is to be read. This value is ignored if this field is static.
    
    Returns:
    
    the constant value of this field or null if this field is not considered constant by the runtime
  - verifyFieldValue
```
private boolean verifyFieldValue(ResolvedJavaField field,
                                 JavaConstant constant)
```
  - readFieldValue
```
public JavaConstant readFieldValue(JavaField field,
                                   JavaConstant receiver)
```
    Description copied from interface: ConstantReflectionProvider
    
    Gets the current value of this field for a given object, if available. There is no guarantee that the same value will be returned by this method for a field unless the field is considered to be constant by the runtime.
    
    Specified by:
    
    readFieldValue in interface ConstantReflectionProvider
    
    receiver - object from which this field's value is to be read. This value is ignored if this field is static.
    
    Returns:
    
    the value of this field or null if the value is not available (e.g., because the field holder is not yet initialized).
  - readStableFieldValue
```
public JavaConstant readStableFieldValue(JavaField field,
                                         JavaConstant receiver,
                                         boolean isDefaultStable)
```
    Description copied from interface: ConstantReflectionProvider
    
    Gets the current value of this field for a given object, if available. Like ConstantReflectionProvider.readFieldValue(JavaField, JavaConstant) but treats array fields as stable. There is no guarantee that the same value will be returned by this method for a field unless the field is considered to be constant by the runtime.
    
    Specified by:
    
    readStableFieldValue in interface ConstantReflectionProvider
    
    receiver - object from which this field's value is to be read. This value is ignored if this field is static.
    
    isDefaultStable - if true, default values are considered stable
    
    Returns:
    
    the value of this field or null if the value is not available (e.g., because the field holder is not yet initialized).
  - boxPrimitive
```
public JavaConstant boxPrimitive(JavaConstant source)
```
    Description copied from interface: ConstantReflectionProvider
    
    Converts the given primitive constant to a boxed object constant, according to the Java boxing rules. Returns null if the source is is not a primitive constant, or the boxed value is not available at this point.
    
    Specified by:
    
    boxPrimitive in interface ConstantReflectionProvider
  - unboxPrimitive
```
public JavaConstant unboxPrimitive(JavaConstant source)
```
    Description copied from interface: ConstantReflectionProvider
    
    Converts the given object constant to a primitive constant, according to the Java unboxing rules. Returns null if the source is is not an object constant that can be unboxed, or the unboxed value is not available at this point.
    
    Specified by:
    
    unboxPrimitive in interface ConstantReflectionProvider
  - forString
```
public JavaConstant forString(String value)
```
    Description copied from interface: ConstantReflectionProvider
    
    Gets a string as a JavaConstant.
    
    Specified by:
    
    forString in interface ConstantReflectionProvider
  - asJavaType
```
public ResolvedJavaType asJavaType(Constant constant)
```
    Description copied from interface: ConstantReflectionProvider
    
    Returns the ResolvedJavaType for a Class object (or any other object regarded as a class by the VM) encapsulated in the given constant. Returns null if the constant does not encapsulate a class, or if the type is not available at this point.
    
    Specified by:
    
    asJavaType in interface ConstantReflectionProvider
  - getMethodHandleAccess
```
public MethodHandleAccessProvider getMethodHandleAccess()
```
    Description copied from interface: ConstantReflectionProvider
    
    Gets access to the internals of MethodHandle.
    
    Specified by:
    
    getMethodHandleAccess in interface ConstantReflectionProvider
  - getMemoryAccessProvider
```
public MemoryAccessProvider getMemoryAccessProvider()
```
    Description copied from interface: ConstantReflectionProvider
    
    Gets raw memory access.
    
    Specified by:
    
    getMemoryAccessProvider in interface ConstantReflectionProvider

Class TruffleConstantReflectionProvider

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

graalConstantReflection

metaAccess

Constructor Detail

TruffleConstantReflectionProvider

Method Detail

constantEquals

readArrayLength

readArrayElement

readConstantArrayElement

readConstantArrayElementForOffset

readConstantFieldValue

verifyFieldValue

readFieldValue

readStableFieldValue

boxPrimitive

unboxPrimitive

forString

asJavaType

getMethodHandleAccess

getMemoryAccessProvider