Class FAWEReflectionUtilsTransformer

java.lang.Object

eu.cloudnetservice.wrapper.transform.bukkit.FAWEReflectionUtilsTransformer

All Implemented Interfaces:

ClassTransformer

@Internal
public final class FAWEReflectionUtilsTransformer
extends Object
implements ClassTransformer

FAWEReflectionUtilsTransformer relies on preview features of the Java platform:

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

Programs can only use FAWEReflectionUtilsTransformer 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 implementation that rewrites the setFailsafeFieldValue method in the ReflectionUtils class on old FAWE versions. This is due to the fact that the method uses illegal reflection in the attempt to set a final field which is not possible anymore on newer java versions.

Nested Class Summary

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

ClassTransformer.TransformWillingness

Field Summary

Fields

Modifier and Type	Field	Description
private static final ClassDesc	CD_FIELD
private static final String	CNI_REFLECTION_UTILS
private static final String	MN_FIELD_SET
private static final String	MN_FIELD_SET_ACCESSIBLE
private static final String	MN_SET_FAILSAFE_FIELD_VALUE
private static final MethodTypeDesc	MTD_SET
private static final MethodTypeDesc	MTD_SET_ACCESSIBLE

Constructor Summary

Constructors

Constructor	Description
FAWEReflectionUtilsTransformer()	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

CNI_REFLECTION_UTILS

private static final String CNI_REFLECTION_UTILS

See Also:

• Constant Field Values

MN_SET_FAILSAFE_FIELD_VALUE

private static final String MN_SET_FAILSAFE_FIELD_VALUE

See Also:

• Constant Field Values

CD_FIELD

private static final ClassDesc CD_FIELD

MN_FIELD_SET_ACCESSIBLE

private static final String MN_FIELD_SET_ACCESSIBLE

See Also:

• Constant Field Values

MTD_SET_ACCESSIBLE

private static final MethodTypeDesc MTD_SET_ACCESSIBLE

MN_FIELD_SET

private static final String MN_FIELD_SET

See Also:

• Constant Field Values

MTD_SET

private static final MethodTypeDesc MTD_SET

Constructor Details

FAWEReflectionUtilsTransformer

public FAWEReflectionUtilsTransformer()

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.