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 gets are supported (GETFIELD, GETSTATIC).

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

Required Element Summary

Required Elements

Modifier and Type	Required Element and Description
java.lang.String[]	method The method name and descriptor to inject into.
CTarget[]	target The target which should be wrapped with a condition.

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