org.graalvm.compiler.api.replacements

Interface SnippetReflectionProvider

All Known Implementing Classes:

HotSpotSnippetReflectionProvider

public interface SnippetReflectionProvider

Reflection operations on values represented as constants for the processing of snippets. Snippets need a direct access to the value of object constants, which is not allowed in other parts of Graal to enforce compiler-VM separation.

This interface must not be used in Graal code that is not related to snippet processing.

Method Summary

Modifier and Type	Method and Description
<T> T	asObject(Class<T> type, JavaConstant constant) Gets the object reference a given constant represents if it is of a given type.
default JavaConstant	forBoxed(JavaKind kind, Object value) Creates a boxed constant for the given kind from an Object.
JavaConstant	forObject(Object object) Creates a boxed object constant.
<T> T	getInjectedNodeIntrinsicParameter(Class<T> type) Gets the value to bind to an injected parameter in a node intrinsic.
Class<?>	originalClass(ResolvedJavaType type) Get the original Java class corresponding to a ResolvedJavaType.

Method Detail

forObject

JavaConstant forObject(Object object)

Creates a boxed object constant.

Parameters:

object - the object value to box

Returns:

a constant containing object

asObject

<T> T asObject(Class<T> type,
               JavaConstant constant)

Gets the object reference a given constant represents if it is of a given type. The constant must have kind JavaKind.Object.

Parameters:

type - the expected type of the object represented by constant. If the object is required to be of this type, then wrap the call to this method in Objects.requireNonNull(Object).

constant - an object constant

Returns:

the object value represented by constant cast to type if it is an instance of type otherwise null

forBoxed

default JavaConstant forBoxed(JavaKind kind,
                              Object value)

Creates a boxed constant for the given kind from an Object. The object needs to be of the Java boxed type corresponding to the kind.

Parameters:

kind - the kind of the constant to create

value - the Java boxed value: a Byte instance for JavaKind.Byte, etc.

Returns:

the boxed copy of value

getInjectedNodeIntrinsicParameter

<T> T getInjectedNodeIntrinsicParameter(Class<T> type)

Gets the value to bind to an injected parameter in a node intrinsic.

Parameters:

type - the type of a parameter in a node intrinsic constructor

Returns:

the value that should be bound to the parameter when invoking the constructor or null if this provider cannot provide a value of the requested type

originalClass

Class<?> originalClass(ResolvedJavaType type)

Get the original Java class corresponding to a ResolvedJavaType.

Parameters:

type - the type for which the original Java class is requested

Returns:

the original Java class corresponding to type or null if this object cannot map ResolvedJavaType instances to Class instances