Class CodeGenerationUtil

java.lang.Object

eu.cloudnetservice.driver.util.CodeGenerationUtil

@Internal
public final class CodeGenerationUtil
extends Object

CodeGenerationUtil relies on preview features of the Java platform:

• CodeGenerationUtil refers to one or more preview APIs: CodeBuilder.

Programs can only use CodeGenerationUtil when preview features are enabled.

Preview features may be removed in a future release, or upgraded to permanent features of the Java platform.

Various utils to generate code using the java classfile api. For internal use only.

Since:

4.0

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static final record	CodeGenerationUtil.PrimitiveWrapperConverter	Holds all information required to generate code to box or unbox a primitive type.

Field Summary

Fields

Modifier and Type	Field	Description
private static final CodeGenerationUtil.PrimitiveWrapperConverter	C_BOOL
private static final CodeGenerationUtil.PrimitiveWrapperConverter	C_BYTE
private static final CodeGenerationUtil.PrimitiveWrapperConverter	C_CHAR
private static final CodeGenerationUtil.PrimitiveWrapperConverter	C_DOUBLE
private static final CodeGenerationUtil.PrimitiveWrapperConverter	C_FLOAT
private static final CodeGenerationUtil.PrimitiveWrapperConverter	C_INT
private static final CodeGenerationUtil.PrimitiveWrapperConverter	C_LONG
private static final CodeGenerationUtil.PrimitiveWrapperConverter	C_SHORT
private static final MethodHandles.Lookup.ClassOption[]	NEST_MATE_DEFINE_OPTIONS
private static final MethodHandles.Lookup	TRUSTED_LOOKUP

Constructor Summary

Constructors

Modifier	Constructor	Description
private	CodeGenerationUtil()

Method Summary

Modifier and Type	Method	Description
private static void	boxPrimitive(@NonNull CodeBuilderPREVIEW codeBuilder, @NonNull CodeGenerationUtil.PrimitiveWrapperConverter converter)	Applies the conversion from a primitive type to the corresponding wrapper type on the given code builder.
static void	boxPrimitive(@NonNull CodeBuilderPREVIEW codeBuilder, @NonNull String sourceDescriptor)	Boxes the given primitive type on the stack of the given code builder (excluding void).
static @NonNull Class<?>	defineClass(@NonNull Class<?> parentClass, byte[] classData)	Defines a class based on the given class bytes using the class loader of the given parent class.
static MethodHandles.Lookup	defineNestedClass(@NonNull Class<?> hostClass, byte[] classData)	Defines a hidden nest mate class in the given host class, which grants the defined class full access to everything that is present in the class (for example private members).
private static void	unboxPrimitive(@NonNull CodeBuilderPREVIEW codeBuilder, @NonNull CodeGenerationUtil.PrimitiveWrapperConverter converter)	Applies the primitive to wrapper conversion by first casting to the wrapper type and then invoking the method to convert the wrapper to the primitive representation.
static void	unboxPrimitive(@NonNull CodeBuilderPREVIEW codeBuilder, @NonNull String targetDescriptor)	Unboxes the current object on the stack of the given code builder into the given primitive type (excluding void).

Methods inherited from class java.lang.Object

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

Field Details

C_BYTE

private static final CodeGenerationUtil.PrimitiveWrapperConverter C_BYTE

C_SHORT

private static final CodeGenerationUtil.PrimitiveWrapperConverter C_SHORT

C_INT

private static final CodeGenerationUtil.PrimitiveWrapperConverter C_INT

C_LONG

private static final CodeGenerationUtil.PrimitiveWrapperConverter C_LONG

C_FLOAT

private static final CodeGenerationUtil.PrimitiveWrapperConverter C_FLOAT

C_DOUBLE

private static final CodeGenerationUtil.PrimitiveWrapperConverter C_DOUBLE

C_CHAR

private static final CodeGenerationUtil.PrimitiveWrapperConverter C_CHAR

C_BOOL

private static final CodeGenerationUtil.PrimitiveWrapperConverter C_BOOL

TRUSTED_LOOKUP

private static final MethodHandles.Lookup TRUSTED_LOOKUP

NEST_MATE_DEFINE_OPTIONS

private static final MethodHandles.Lookup.ClassOption[] NEST_MATE_DEFINE_OPTIONS

Constructor Details

CodeGenerationUtil

private CodeGenerationUtil()

Method Details

unboxPrimitive

public static void unboxPrimitive(@NonNull
 @NonNull CodeBuilderPREVIEW codeBuilder,
 @NonNull
 @NonNull String targetDescriptor)

Unboxes the current object on the stack of the given code builder into the given primitive type (excluding void).

Parameters:

codeBuilder - the code builder to append the unbox operation to.

targetDescriptor - the descriptor of the target primitive type to convert to.

Throws:

NullPointerException - if the given code builder or target type is null.

IllegalArgumentException - if the given target type is not primitive or void.

unboxPrimitive

private static void unboxPrimitive(@NonNull
 @NonNull CodeBuilderPREVIEW codeBuilder,
 @NonNull
 @NonNull CodeGenerationUtil.PrimitiveWrapperConverter converter)

Applies the primitive to wrapper conversion by first casting to the wrapper type and then invoking the method to convert the wrapper to the primitive representation.

Parameters:

codeBuilder - the code builder to apply the operation to.

converter - the converter information for the wrapper type.

Throws:

NullPointerException - if the given code builder or converter is null.

boxPrimitive

public static void boxPrimitive(@NonNull
 @NonNull CodeBuilderPREVIEW codeBuilder,
 @NonNull
 @NonNull String sourceDescriptor)

Boxes the given primitive type on the stack of the given code builder (excluding void).

Parameters:

codeBuilder - the code builder to append the box operation to.

sourceDescriptor - the descriptor of the primitive type that should get boxed.

Throws:

NullPointerException - if the given code builder or target type is null.

IllegalArgumentException - if the given source type is not primitive or void.

boxPrimitive

private static void boxPrimitive(@NonNull
 @NonNull CodeBuilderPREVIEW codeBuilder,
 @NonNull
 @NonNull CodeGenerationUtil.PrimitiveWrapperConverter converter)

Applies the conversion from a primitive type to the corresponding wrapper type on the given code builder.

Parameters:

codeBuilder - the code builder to apply the operation to.

converter - the converter information for the wrapper type.

Throws:

NullPointerException - if the given code builder or converter is null.

defineClass

@NonNull
public static @NonNull Class<?> defineClass(@NonNull
 @NonNull Class<?> parentClass,
 byte[] classData)

Defines a class based on the given class bytes using the class loader of the given parent class. The returned class has not been initialized.

Parameters:

parentClass - the parent class to use the classloader for class defining of.

classData - the raw bytecode of the class to define.

Returns:

the class object of the defined class.

Throws:

NullPointerException - if the given parent class or class data is null.

defineNestedClass

@NonNull
public static MethodHandles.Lookup defineNestedClass(@NonNull
 @NonNull Class<?> hostClass,
 byte[] classData)

Defines a hidden nest mate class in the given host class, which grants the defined class full access to everything that is present in the class (for example private members). The returned class has not been initialized.

Parameters:

hostClass - the host class which should be used for the nested class.

classData - the raw bytecode of the nest class to define.

Returns:

a method handle with full access to the defined nest class.

Throws:

NullPointerException - if the given host class or class data is null.