net.lenni0451.classtransform.annotations.injection

Annotation Type CASM

@Retention(value=CLASS)
 @Target(value={METHOD,CONSTRUCTOR})
public @interface CASM

Inject into a method using direct ASM.
You get direct access to the class/method node of the target.
The transformer methods have to be static and return void.

By default, the transformer will be executed at the top of the handler chain.
You can change this by setting the shift() value to CASM.Shift.BOTTOM.

The code inside the method is isolated from the rest of the class and loaded.
Fields inside the transformer class are not accessible from the isolated method.
Methods accessed from the isolated method are getting copied into the isolated class.
Lambdas are not supported and will throw an exception during the isolation process.

Injecting into a class:

 @CASM
 public static void inject(ClassNode classNode) {
     //Do something with the class node
 }
 

Injecting into a method:

 @CASM("print")
 public static void inject(MethodNode methodNode) {
     //Do something with the method node
 }
 

See Also:

GitHub Wiki

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
CASM.Shift	shift The shift of the CASM injection (before or after the other transformer).
java.lang.String[]	value The method name and descriptor to inject into. This supports multiple targets and wildcards. To get the class node keep the target empty. e.g.

Element Detail

value

public abstract java.lang.String[] value

The method name and descriptor to inject into.
This supports multiple targets and wildcards.
To get the class node keep the target empty.
e.g. print(Ljava/lang/String;)V or print*

Returns:

The method name and descriptor

Default:

{}

shift

public abstract CASM.Shift shift

The shift of the CASM injection (before or after the other transformer).

Returns:

The shift

Default:

net.lenni0451.classtransform.annotations.injection.CASM.Shift.TOP