com.oracle.truffle.api.instrumentation

Annotation Type TruffleInstrument.Registration

@Retention(value=RUNTIME)
 @Target(value=TYPE)
public static @interface TruffleInstrument.Registration

Annotation that registers an instrument implementations for automatic discovery.

Since:

0.12

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
String	id A custom machine identifier for this instrument.
boolean	internal Specifies whether the instrument is accessible using the polyglot API.
String	name The name of the instrument in an arbitrary format for humans.
Class<?>[]	services Declarative list of classes this instrument is known to provide.
String	version The version for instrument in an arbitrary format.
String	website A link to a website with more information about the instrument.

Element Detail

id

public abstract String id

A custom machine identifier for this instrument. If not defined then the fully qualified class name is used.

Since:

0.12

Default:

""

name

public abstract String name

The name of the instrument in an arbitrary format for humans.

Since:

0.12

Default:

""

version

public abstract String version

The version for instrument in an arbitrary format. It inherits from Engine.getVersion() by default.

Since:

0.12

Default:

"inherit"

internal

public abstract boolean internal

Specifies whether the instrument is accessible using the polyglot API. Internal instruments are only accessible from other instruments or guest languages.

Since:

0.27

Default:

false

services

public abstract Class<?>[] services

Declarative list of classes this instrument is known to provide. The instrument is supposed to override its onCreate method and instantiate and register all here in defined services.

Instruments automatically get created when their registered service is requested.

Returns:

list of service types that this instrument can provide

Since:

0.25

Default:

{}

website

public abstract String website

A link to a website with more information about the instrument. Will be shown in the help text of GraalVM launchers.

Since:

22.1.0

Default:

""