org.graalvm.nativeimage.hosted

Class RuntimeReflection

java.lang.Object

org.graalvm.nativeimage.hosted.RuntimeReflection

public final class RuntimeReflection
extends Object

This class provides methods that can be called during native image generation to register classes, methods, and fields for reflection at run time.

Since:

19.0

Method Summary

Modifier and Type	Method and Description
static void	register(boolean finalIsWritable, boolean allowUnsafeAccess, Field... fields) Makes the provided fields available for reflection at run time.
static void	register(boolean finalIsWritable, Field... fields) Makes the provided fields available for reflection at run time.
static void	register(Class<?>... classes) Makes the provided classes available for reflection at run time.
static void	register(Executable... methods) Makes the provided methods available for reflection at run time.
static void	register(Field... fields) Makes the provided fields available for reflection at run time.
static void	registerForReflectiveInstantiation(Class<?>... classes) Makes the provided classes available for reflective instantiation by Class.newInstance().

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

register

public static void register(Class<?>... classes)

Makes the provided classes available for reflection at run time. A call to Class.forName(java.lang.String) for the names of the classes will return the classes at run time.

Since:

19.0

register

public static void register(Executable... methods)

Makes the provided methods available for reflection at run time. The methods will be returned by Class.getMethod(java.lang.String, java.lang.Class<?>...), Class.getMethods(),and all the other methods on Class that return a single or a list of methods.

Since:

19.0

register

public static void register(Field... fields)

Makes the provided fields available for reflection at run time. The fields will be returned by Class.getField(java.lang.String), Class.getFields(),and all the other methods on Class that return a single or a list of fields.

Since:

19.0

register

public static void register(boolean finalIsWritable,
                            Field... fields)

Makes the provided fields available for reflection at run time. The fields will be returned by Class.getField(java.lang.String), Class.getFields(),and all the other methods on Class that return a single or a list of fields.

Parameters:

finalIsWritable - for all of the passed fields which are marked final, indicates whether it should be possible to change their value using reflection.

Since:

19.0

register

public static void register(boolean finalIsWritable,
                            boolean allowUnsafeAccess,
                            Field... fields)

Makes the provided fields available for reflection at run time. The fields will be returned by Class.getField(java.lang.String), Class.getFields(),and all the other methods on Class that return a single or a list of fields.

Parameters:

finalIsWritable - for all of the passed fields which are marked final, indicates whether it should be possible to change their value using reflection.

allowUnsafeAccess - for all of the passed fields, indicates whether it should be possible to access by unsafe operations.

Since:

21.0

registerForReflectiveInstantiation

public static void registerForReflectiveInstantiation(Class<?>... classes)

Makes the provided classes available for reflective instantiation by Class.newInstance(). This is equivalent to registering the nullary constructors of the classes.

Since:

19.0