Class BukkitCommodoreTransformer

java.lang.Object

eu.cloudnetservice.wrapper.transform.bukkit.BukkitCommodoreTransformer

All Implemented Interfaces:

ClassTransformer

@Internal
public final class BukkitCommodoreTransformer
extends Object
implements ClassTransformer

BukkitCommodoreTransformer relies on preview features of the Java platform:

• BukkitCommodoreTransformer refers to one or more preview APIs: ClassTransform.

Programs can only use BukkitCommodoreTransformer when preview features are enabled.

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

A transformer which adds a try-catch block around the Commodore.convert method content to prevent issues with older ASM versions on newer Java versions (f. ex. exceptions due to unsupported class file versions).

Since:

4.0

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static final class	BukkitCommodoreTransformer.ConvertMethodTryCatchWrapperCodeTransformPREVIEW	A code transform for CraftBukkit Commodore.transform method that records all instructions in the method and wraps them into a try-catch block at the end, just returning the class input data if there is a failure.

Nested classes/interfaces inherited from interface eu.cloudnetservice.wrapper.transform.ClassTransformer

ClassTransformer.TransformWillingness

Field Summary

Fields

Modifier and Type	Field	Description
private static final String	CN_COMMODORE
private static final String	MN_CONVERT
private static final String	PNI_COMMODORE

Constructor Summary

Constructors

Constructor	Description
BukkitCommodoreTransformer()	Constructs a new instance of this transformer, usually done via SPI.

Method Summary

Modifier and Type	Method	Description
@NonNull ClassTransformer.TransformWillingness	classTransformWillingness(@NonNull String internalClassName)	Checks if this class transformer is willing to transform the class with the given internal name.
@NonNull ClassTransformPREVIEW	provideClassTransform()	Provides the class transform that will be used to transform the class data.

Methods inherited from class java.lang.Object

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

Field Details

MN_CONVERT

private static final String MN_CONVERT

See Also:

• Constant Field Values

CN_COMMODORE

private static final String CN_COMMODORE

See Also:

• Constant Field Values

PNI_COMMODORE

private static final String PNI_COMMODORE

See Also:

• Constant Field Values

Constructor Details

BukkitCommodoreTransformer

public BukkitCommodoreTransformer()

Constructs a new instance of this transformer, usually done via SPI.

Method Details

provideClassTransform

@NonNull
public @NonNull ClassTransformPREVIEW provideClassTransform()

Provides the class transform that will be used to transform the class data. This method should only be called if a prior check to ClassTransformer.classTransformWillingness(String) did not indicate a rejection of the class.

Specified by:

provideClassTransform in interface ClassTransformer

Returns:

the class transform to apply to the target class.

classTransformWillingness

@NonNull
public @NonNull ClassTransformer.TransformWillingness classTransformWillingness(@NonNull
 @NonNull String internalClassName)

Checks if this class transformer is willing to transform the class with the given internal name. If this method is not returning a rejection status, the ClassTransformer.provideClassTransform()^PREVIEW method is called and the transform gets applied to the target class.

Specified by:

classTransformWillingness in interface ClassTransformer

Parameters:

internalClassName - the internal class name of the class being checked for transformation.

Returns:

the willingness of transformation for the class with the given name.