com.oracle.svm.core.annotate

Annotation Type RecomputeFieldValue

@Retention(value=RUNTIME)
 @Target(value=FIELD)
public @interface RecomputeFieldValue

Supported API is available to replace this non-API annotation: Use Feature.BeforeAnalysisAccess.registerFieldValueTransformer(java.lang.reflect.Field, org.graalvm.nativeimage.hosted.FieldValueTransformer). Mechanism to change the value of a field. Normally, field values in the native image heap of the Substrate VM are just taken from the host VM. This annotation allows the field value to be intercepted and recomputed.

This annotation must be used on a field also annotated with Alias to specify the field whose value needs to be changed.

Since:

22.3

Required Element Summary

Required Elements

Modifier and Type	Required Element and Description
RecomputeFieldValue.Kind	kind The kind of the recomputation performed.

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
Class<?>	declClass The class parameter for the recomputation.
String	declClassName The class parameter for the recomputation.
boolean	disableCaching If true, ignores previously computed values and calculates the value for every field read.
boolean	isFinal Treat the value as final, to enforce constant folding already during static analysis.
String	name The name parameter for the recomputation.

Element Detail

kind

public abstract RecomputeFieldValue.Kind kind

The kind of the recomputation performed.

Since:

22.3

declClass

public abstract Class<?> declClass

The class parameter for the recomputation. If this attribute is not specified, then the class specified by RecomputeFieldValue.declClassName() is used. If neither RecomputeFieldValue.declClass() nor RecomputeFieldValue.declClassName() is specified, then the class specified by the TargetClass annotation is used.

Since:

22.3

Default:

com.oracle.svm.core.annotate.RecomputeFieldValue.class

declClassName

public abstract String declClassName

The class parameter for the recomputation. If this attribute is not specified, then the class specified by RecomputeFieldValue.declClass() is used. If neither RecomputeFieldValue.declClass() nor RecomputeFieldValue.declClassName() is specified, then the class specified by the TargetClass annotation is used.

Since:

22.3

Default:

""

name

public abstract String name

The name parameter for the recomputation.

Since:

22.3

Default:

""

isFinal

public abstract boolean isFinal

Treat the value as final, to enforce constant folding already during static analysis.

Since:

22.3

Default:

false

disableCaching

public abstract boolean disableCaching

If true, ignores previously computed values and calculates the value for every field read.

Since:

22.3

Default:

false