net.lenni0451.classtransform.annotations.injection

Annotation Type CWrapCondition

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

This annotation is used to wrap a method call or a field with a condition (if statement).
The return type of the transformer method must always be a boolean.

When wrapping a method call:

• If the wrapped method is not static, the instance of the method owner should be the first argument.
• The remaining arguments should be the same as the arguments of the method being wrapped.
• The return value of the wrapped method has to be void.

When wrapping a field:

• If the wrapped field is not static, the instance of the field owner should be the first argument.
• The second argument should be the new value for the field.
• Only field sets are supported (PUTFIELD, PUTSTATIC).

Example usage:

 @CWrapCondition(method = "print", target = @CTarget(value = "INVOKE", target = "..."))
 public boolean condition(Object instance, String arg) {
     // Return true or false based on some condition
 }
 

If your target has to be chosen more precisely you can use a slice() to narrow down the search.

See Also:

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 which should be wrapped with a condition. This can be used to wrap multiple targets at once.

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 which should be wrapped with a condition.
This can be used to wrap multiple targets at once.

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