com.oracle.svm.reflect.hosted

Class MethodMetadataEncoderImpl

java.lang.Object

com.oracle.svm.reflect.hosted.MethodMetadataEncoderImpl

All Implemented Interfaces:

NativeImageCodeCache.MethodMetadataEncoder

public class MethodMetadataEncoderImpl
extends Object
implements NativeImageCodeCache.MethodMetadataEncoder

The method metadata encoding puts data in the image for three distinct types of methods.

1. Methods that are queried for reflection, but never accessed: in that case, the encoding includes everything required to recreate an Executable object at runtime.
2. Methods that hide a method registered for reflection, but are not registered themselves: only basic method information is stored for those methods (declaring class, name and parameter types). They are used to ensure that the hidden superclass method is not incorrectly returned by a reflection query on the subclass where it is hidden.
3. Methods that are included in the image: all reachable methods have their basic information included to enable introspecting the produced executable.

Emitting the metadata happens in two phases. In the first phase, the string and class encoders are filled with the necessary values (in the add*MethodMetadata functions). In a second phase, the values are encoded as byte arrays and stored in MethodMetadataEncoding (see MethodMetadataEncoderImpl.encodeAllAndInstall()).

Constructor Summary

Constructors

Constructor and Description
MethodMetadataEncoderImpl(CodeInfoEncoder.Encoders encoders)

Method Summary

Modifier and Type	Method and Description
void	addHidingMethodMetadata(HostedType declaringType, String name, HostedType[] parameterTypes)
void	addReachableMethodMetadata(HostedMethod method)
void	addReflectionMethodMetadata(jdk.vm.ci.meta.MetaAccessProvider metaAccess, HostedMethod hostedMethod, Executable reflectMethod)
void	encodeAllAndInstall()
byte[]	encodeAnnotations(Annotation[] annotations) The following methods encode annotations attached to a method or parameter in a format based on the one used internally by the JDK (AnnotationParser).

Methods inherited from class java.lang.Object

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

Constructor Detail

MethodMetadataEncoderImpl

public MethodMetadataEncoderImpl(CodeInfoEncoder.Encoders encoders)

Method Detail

addReflectionMethodMetadata

public void addReflectionMethodMetadata(jdk.vm.ci.meta.MetaAccessProvider metaAccess,
                                        HostedMethod hostedMethod,
                                        Executable reflectMethod)

Specified by:

addReflectionMethodMetadata in interface NativeImageCodeCache.MethodMetadataEncoder

addHidingMethodMetadata

public void addHidingMethodMetadata(HostedType declaringType,
                                    String name,
                                    HostedType[] parameterTypes)

Specified by:

addHidingMethodMetadata in interface NativeImageCodeCache.MethodMetadataEncoder

addReachableMethodMetadata

public void addReachableMethodMetadata(HostedMethod method)

Specified by:

addReachableMethodMetadata in interface NativeImageCodeCache.MethodMetadataEncoder

encodeAllAndInstall

public void encodeAllAndInstall()

Specified by:

encodeAllAndInstall in interface NativeImageCodeCache.MethodMetadataEncoder

encodeAnnotations

public byte[] encodeAnnotations(Annotation[] annotations)

The following methods encode annotations attached to a method or parameter in a format based on the one used internally by the JDK (AnnotationParser). The format we use differs from that one on a few points, based on the fact that the JDK encoding is based on constant pool indices, which are not available in that form at runtime. Class and String values are represented by their index in the source metadata encoders instead of their constant pool indices. Additionally, Class objects are encoded directly instead of through their type signature. Primitive values are written directly into the encoding. This means that our encoding can be of a different length from the JDK one. We use a modified version of the ConstantPool and AnnotationParser classes to decode the data, since those are not used in their original functions at runtime. (see Target_jdk_internal_reflect_ConstantPool and Target_sun_reflect_annotation_AnnotationParser)