net.lenni0451.classtransform.annotations.injection

Annotation Type CRedirect

@Retention(value=CLASS)
 @Target(value=METHOD)
public @interface CRedirect

Redirect a specified method call or field access.
The following target types are supported:

• INVOKE
• FIELD
• GETFIELD
• PUTFIELD
• NEW

When redirecting a method call:

• The transformer method must have the same parameters and return type as the redirected method.
• If the redirected method is not static, the instance of the method owner has to be the first parameter of the transformer method.

When redirecting a field access:

• The transformer method must have the same return type as the redirected field.
• If the redirected field is not static the instance of the field owner has to be the first parameter of the transformer method.
• No other parameters than the non-static instance are allowed.

The transformer method has to be static if the target method/field is static.

Redirecting a method call:

 @CRedirect(method = "print", target = @CTarget(value = "INVOKE", target = "..."))
 public String redirect(Object instance, int arg1, String arg2) {
     //Do something with the arguments and return the new value
 }
 

Redirecting a field access:

 @CRedirect(method = "print", target = @CTarget(value = "GETFIELD", target = "..."))
 public String redirect(Object instance) {
     //Do something with the instance and return the new value
 }
 

See CTarget for more information about targets.
If your target has to be chosen more precisely you can use a slice() to narrow down the search.

See Also:

CTarget, CSlice, GitHub Wiki

Required Element Summary

Required Elements

Modifier and Type	Required Element and Description
java.lang.String[]	method The method name and descriptor to inject into. This supports multiple targets and wildcards. e.g.
CTarget	target The target for the redirect.

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
CSlice	slice The slice to narrow down the search for the target.

Element Detail

method

public abstract java.lang.String[] method

The method name and descriptor to inject into.
This supports multiple targets and wildcards.
e.g. print(Ljava/lang/String;)V or print*

Returns:

The method name and descriptor

target

public abstract CTarget target

The target for the redirect.

Returns:

The target

slice

public abstract CSlice slice

The slice to narrow down the search for the target.

Returns:

The slice

Default:

@net.lenni0451.classtransform.annotations.CSlice