Modifier and Type	Class and Description
public static interface	VMSupport.AnnotationDecoder< type to which a type name is resolved T, type of the object representing a decoded annotation A, type of the object representing a decoded enum constant E, type of the object representing a decoded error X> Helper for `decodeAnnotations(byte[], AnnotationDecoder)` to convert a byte array (ostensibly produced by `VMSupport#encodeAnnotations`) into objects.
pack-priv static interface	VMSupport.IOReader

Modifier and Type	Field and Description
private static Properties	agentProps
private static final Unsafe	U

Access	Constructor and Description
public	VMSupport()

Method Summary

Modifier and Type	Method and Description
private static byte[]	bufferToBytes(long buffer)
public static void	decodeAndThrowThrowable(int specifies how to interpret `buffer`: 0: `buffer` was created by `encodeThrowable` 1: native memory for `buffer` could not be allocated 2: an OutOfMemoryError was thrown while encoding the exception 3: some other problem occured while encoding the exception. If `buffer != 0`, it contains a `struct { u4 len; char[len] desc}` where `desc` describes the problem format, long encoded info about the exception to throw (depends on `format`) buffer, boolean [@code true} if executing in the JVM heap, `false` otherwise inJVMHeap, boolean specifies whether debug stack traces should be enabled in case of translation failure debug) Decodes the exception described by `format` and `buffer` and throws it.
private static <T, A, E, X> A	decodeAnnotation(DataInputStream dis, VMSupport.AnnotationDecoder<T, A, E, X> decoder)
public static < type to which a type name is resolved T, type of the object representing a decoded annotation A, type of the object representing a decoded enum constant E, type of the object representing a decoded error X> List<A>	Returns: an immutable list of `A` objects decodeAnnotations(byte[] encoded, VMSupport.AnnotationDecoder<T, A, E, X> decoder) Decodes annotations serialized in `encoded` to objects.
private static <T, A, E, X> Object	decodeArray(DataInputStream dis, VMSupport.AnnotationDecoder<T, A, E, X> decoder)
private static void	encodeAnnotation(DataOutputStream dos, Annotation a)
public static byte[]	encodeAnnotations(byte[] rawAnnotations, Class<?> declaringClass, ConstantPool cp, boolean forClass, Class<? extends Annotation>[] selectAnnotationClasses) Parses `rawAnnotations` into a list of `Annotation`s and then serializes them to a byte array with `encodeAnnotations(Collection)`.
public static byte[]	encodeAnnotations(Collection<Annotation> annotations) Encodes annotations to a byte array.
public static int	Returns: the number of bytes written into `buffer` if `bufferSize` is large enough, otherwise `-N` where `N` is the value `bufferSize` needs to be to fit the encoding encodeThrowable(Throwable the exception to encode throwable, long a native byte buffer buffer, int the size of `buffer` in bytes bufferSize) If `bufferSize` is large enough, encodes `throwable` into a byte array and writes it to `buffer`.
public static synchronized Properties	getAgentProperties() Returns the agent properties.
public static native String	getVMTemporaryDirectory()
private static native Properties	initAgentProperties(Properties props)
private static Properties	Returns: a Properties object containing only the entries in `p` whose key and value are both Strings onlyStrings(Properties p)
private static List<Object>	Returns: an immutable list of `A` objects readArray(DataInputStream dis, VMSupport.IOReader reads array elements from `dis` reader) Reads an array encoded at the current read position of `dis` and returns it in an immutable list.
private static <T, A, E, X> T	readClass(DataInputStream dis, VMSupport.AnnotationDecoder<T, A, E, X> decoder) Reads a class encoded at the current read position of `dis` and returns it as an object of type `T`.
private static <T, A, E, X> E	readEnum(DataInputStream dis, VMSupport.AnnotationDecoder<T, A, E, X> decoder, T enumType) Reads an enum encoded at the current read position of `dis` and returns it as an object of type `E`.
private static int	readLength(DataInputStream dis)
public static byte[]	serializeAgentPropertiesToByteArray()
private static byte[]	serializePropertiesToByteArray(Properties p) Writes the given properties list to a byte array and return it.
public static byte[]	serializePropertiesToByteArray()
private static void	writeLength(DataOutputStream dos, int length) Encodes `length` in 1 byte if it is less than 128.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

agentProps	back to summary
private static Properties agentProps

U	back to summary
private static final Unsafe U

Constructor Detail

VMSupport	back to summary
public VMSupport()

Method Detail

bufferToBytes	back to summary
private static byte[] bufferToBytes(long buffer)

decodeAndThrowThrowable back to summary

decodeAndThrowThrowable	back to summary
public static void decodeAndThrowThrowable(int format, long buffer, boolean inJVMHeap, boolean debug) throws Throwable Decodes the exception described by `format` and `buffer` and throws it. Parameters format:int specifies how to interpret `buffer`: 0: `buffer` was created by `encodeThrowable` 1: native memory for `buffer` could not be allocated 2: an OutOfMemoryError was thrown while encoding the exception 3: some other problem occured while encoding the exception. If `buffer != 0`, it contains a `struct { u4 len; char[len] desc}` where `desc` describes the problem buffer:long encoded info about the exception to throw (depends on `format`) inJVMHeap:boolean [@code true} if executing in the JVM heap, `false` otherwise debug:boolean specifies whether debug stack traces should be enabled in case of translation failure

public static void decodeAndThrowThrowable(int format, long buffer, boolean inJVMHeap, boolean debug) throws Throwable

Decodes the exception described by format and buffer and throws it.

Parameters

format:int

specifies how to interpret buffer:

            0: buffer was created by encodeThrowable
            1: native memory for buffer could not be allocated
            2: an OutOfMemoryError was thrown while encoding the exception
            3: some other problem occured while encoding the exception. If buffer != 0,
               it contains a struct { u4 len; char[len] desc} where desc describes the problem

buffer:long

encoded info about the exception to throw (depends on format)

inJVMHeap:boolean

[@code true} if executing in the JVM heap, false otherwise

debug:boolean

specifies whether debug stack traces should be enabled in case of translation failure

decodeAnnotation	back to summary
private static <T, A, E, X> A decodeAnnotation(DataInputStream dis, VMSupport.AnnotationDecoder<T, A, E, X> decoder) throws IOException Annotations @SuppressWarnings:rawtypes, unchecked

decodeAnnotations back to summary

decodeAnnotations	back to summary
public static <T, A, E, X> List<A> decodeAnnotations(byte[] encoded, VMSupport.AnnotationDecoder<T, A, E, X> decoder) Decodes annotations serialized in `encoded` to objects. Parameters <T> type to which a type name is resolved <A> type of the object representing a decoded annotation <E> type of the object representing a decoded enum constant <X> type of the object representing a decoded error Returns:List<A> an immutable list of `A` objects Annotations @SuppressWarnings:rawtypes, unchecked

public static <T, A, E, X> List<A> decodeAnnotations(byte[] encoded, VMSupport.AnnotationDecoder<T, A, E, X> decoder)

Decodes annotations serialized in encoded to objects.

Parameters

<T>: type to which a type name is resolved
<A>: type of the object representing a decoded annotation
<E>: type of the object representing a decoded enum constant
<X>: type of the object representing a decoded error

Returns:List<A>

an immutable list of A objects

Annotations

@SuppressWarnings:rawtypes, unchecked

decodeArray	back to summary
private static <T, A, E, X> Object decodeArray(DataInputStream dis, VMSupport.AnnotationDecoder<T, A, E, X> decoder) throws IOException

encodeAnnotation	back to summary
private static void encodeAnnotation(DataOutputStream dos, Annotation a) throws Exception

encodeAnnotations	back to summary
public static byte[] encodeAnnotations(byte[] rawAnnotations, Class<?> declaringClass, ConstantPool cp, boolean forClass, Class<? extends Annotation>[] selectAnnotationClasses) Parses `rawAnnotations` into a list of `Annotation`s and then serializes them to a byte array with `encodeAnnotations(Collection)`.

encodeAnnotations	back to summary
public static byte[] encodeAnnotations(Collection<Annotation> annotations) Encodes annotations to a byte array. The byte array can be decoded with `decodeAnnotations(byte[], AnnotationDecoder)`.

encodeThrowable back to summary

encodeThrowable	back to summary
public static int encodeThrowable(Throwable throwable, long buffer, int bufferSize) If `bufferSize` is large enough, encodes `throwable` into a byte array and writes it to `buffer`. The encoding in `buffer` can be decoded by `decodeAndThrowThrowable`. Parameters throwable:Throwable the exception to encode buffer:long a native byte buffer bufferSize:int the size of `buffer` in bytes Returns:int the number of bytes written into `buffer` if `bufferSize` is large enough, otherwise `-N` where `N` is the value `bufferSize` needs to be to fit the encoding

public static int encodeThrowable(Throwable throwable, long buffer, int bufferSize)

If bufferSize is large enough, encodes throwable into a byte array and writes it to buffer. The encoding in buffer can be decoded by decodeAndThrowThrowable.

Parameters

throwable:Throwable: the exception to encode
buffer:long: a native byte buffer
bufferSize:int: the size of buffer in bytes

Returns:int

the number of bytes written into buffer if bufferSize is large enough, otherwise -N where N is the value bufferSize needs to be to fit the encoding

getAgentProperties	back to summary
public static synchronized Properties getAgentProperties() Returns the agent properties.

getVMTemporaryDirectory	back to summary
public static native String getVMTemporaryDirectory()

initAgentProperties	back to summary
private static native Properties initAgentProperties(Properties props)

onlyStrings	back to summary
private static Properties onlyStrings(Properties p) Returns:Properties a Properties object containing only the entries in `p` whose key and value are both Strings

readArray back to summary

readArray	back to summary
private static List<Object> readArray(DataInputStream dis, VMSupport.IOReader reader) throws IOException Reads an array encoded at the current read position of `dis` and returns it in an immutable list. Parameters reader:VMSupport.IOReader reads array elements from `dis` Returns:List<Object> an immutable list of `A` objects

private static List<Object> readArray(DataInputStream dis, VMSupport.IOReader reader) throws IOException

Reads an array encoded at the current read position of dis and returns it in an immutable list.

Parameters

reader:VMSupport.IOReader: reads array elements from dis

Returns:List<Object>

an immutable list of A objects

readClass	back to summary
private static <T, A, E, X> T readClass(DataInputStream dis, VMSupport.AnnotationDecoder<T, A, E, X> decoder) throws IOException Reads a class encoded at the current read position of `dis` and returns it as an object of type `T`.

readEnum	back to summary
private static <T, A, E, X> E readEnum(DataInputStream dis, VMSupport.AnnotationDecoder<T, A, E, X> decoder, T enumType) throws IOException Reads an enum encoded at the current read position of `dis` and returns it as an object of type `E`.

readLength	back to summary
private static int readLength(DataInputStream dis) throws IOException

serializeAgentPropertiesToByteArray	back to summary
public static byte[] serializeAgentPropertiesToByteArray() throws IOException

serializePropertiesToByteArray	back to summary
private static byte[] serializePropertiesToByteArray(Properties p) throws IOException Writes the given properties list to a byte array and return it. The stream written to the byte array is ISO 8859-1 encoded.

serializePropertiesToByteArray	back to summary
public static byte[] serializePropertiesToByteArray() throws IOException

writeLength	back to summary
private static void writeLength(DataOutputStream dos, int length) throws IOException Encodes `length` in 1 byte if it is less than 128.

jdk.internal.vm back to summary

public Interface VMSupport.AnnotationDecoder<T, A, E, X>

Type Parameters

<T>: type to which a type name is resolved
<A>: type of the object representing a decoded annotation
<E>: type of the object representing a decoded enum constant
<X>: type of the object representing a decoded error

Helper for decodeAnnotations(byte[], AnnotationDecoder) to convert a byte array (ostensibly produced by VMSupport#encodeAnnotations) into objects.

Method Summary

Modifier and Type	Method and Description
public A	newAnnotation(T the annotation interface of the annotation type, Map.Entry<String, Object>[] elements of the annotation elements) Creates an object representing a decoded annotation.
public E	newEnumValue(T the enum type enumType, String the name of the enum constant name) Creates an object representing a decoded enum constant.
public X	newErrorValue(String of the error description) Creates an object representing a decoded error value.
public T	resolveType(String name) Resolves a name in `Class#getName()` format to an object of type `T`.

Method Detail

newAnnotation	back to summary
public A newAnnotation(T type, Map.Entry<String, Object>[] elements) Creates an object representing a decoded annotation. Parameters type:T the annotation interface of the annotation elements:Map.Entry<String, Object>[] elements of the annotation

newAnnotation

back to summary

public A newAnnotation(T type, Map.Entry<String, Object>[] elements)

Creates an object representing a decoded annotation.

Parameters

type:T: the annotation interface of the annotation
elements:Map.Entry<String, Object>[]: elements of the annotation

newEnumValue	back to summary
public E newEnumValue(T enumType, String name) Creates an object representing a decoded enum constant. Parameters enumType:T the enum type name:String the name of the enum constant

newEnumValue

back to summary

public E newEnumValue(T enumType, String name)

Creates an object representing a decoded enum constant.

Parameters

enumType:T: the enum type
name:String: the name of the enum constant

newErrorValue	back to summary
public X newErrorValue(String description) Creates an object representing a decoded error value. Parameters description:String of the error

newErrorValue

back to summary

public X newErrorValue(String description)

Creates an object representing a decoded error value.

Parameters

description:String: of the error

resolveType	back to summary
public T resolveType(String name) Resolves a name in `Class#getName()` format to an object of type `T`.

public Class VMSupport

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public Interface VMSupport.AnnotationDecoder<T, A, E, X>

Method Summary

Method Detail

pack-priv Interface VMSupport.IOReader

Method Summary

Method Detail