net.lenni0451.classtransform.annotations.injection

Annotation Type CModifyConstant

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

Modify a constant value in a method.
The target constant must exactly match the given value.
If the target is not found an exception will be thrown unless optional() is set to true.
The following types are supported:

• nullValue()
• intValue()
• longValue()
• floatValue()
• doubleValue()
• stringValue()
• typeValue()

The transformer method has to return the same type as the target constant and needs to be static if the target method is static.
The transformer method can optionally take the same type as the target constant as the first argument (except for nullValue()). This argument will be the original value of the constant.

Modifying a constant in a method:

 @CModifyConstant(method = "print", stringValue = "test")
 public String modifyConstant(String original) {
     //Do something with the original value and return the new value
     return original + "!";
 }
 

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.

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
double	doubleValue Set the given double as the target. The transformer method must return a double and can optionally take a double as the first argument.
float	floatValue Set the given float as the target. The transformer method must return a float and can optionally take a float as the first argument.
int	intValue Set the given int as the target. The transformer method must return an int and can optionally take an int as the first argument.
long	longValue Set the given long as the target. The transformer method must return a long and can optionally take a long as the first argument.
boolean	nullValue Set ACONST_NULL as the target. The transformer method must return any object and does not take any arguments. The return value type is not verified so make sure to return the correct type.
boolean	optional Make this injection optional. If the target is not found an exception will be thrown unless this is set to true.
int	ordinal The ordinal of target constant.
CSlice	slice The slice to narrow down the search for the target.
java.lang.String	stringValue Set the given String as the target. The transformer method must return a String and can optionally take a String as the first argument.
java.lang.Class<?>	typeValue Set the given class as the target. The transformer method must return a class and can optionally take a class as the first argument.

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

ordinal

public abstract int ordinal

The ordinal of target constant.

Returns:

The ordinal

Default:

-1

slice

public abstract CSlice slice

The slice to narrow down the search for the target.

Returns:

The slice

Default:

@net.lenni0451.classtransform.annotations.CSlice

optional

public abstract boolean optional

Make this injection optional.
If the target is not found an exception will be thrown unless this is set to true.

Returns:

If the target is optional

Default:

false

nullValue

public abstract boolean nullValue

Set ACONST_NULL as the target.
The transformer method must return any object and does not take any arguments.
The return value type is not verified so make sure to return the correct type.

Returns:

If ACONST_NULL should be modified

Default:

false

intValue

public abstract int intValue

Set the given int as the target.
The transformer method must return an int and can optionally take an int as the first argument.

Returns:

The int constant to modify

Default:

0

longValue

public abstract long longValue

Set the given long as the target.
The transformer method must return a long and can optionally take a long as the first argument.

Returns:

The long constant to modify

Default:

0L

floatValue

public abstract float floatValue

Set the given float as the target.
The transformer method must return a float and can optionally take a float as the first argument.

Returns:

The float constant to modify

Default:

0.0f

doubleValue

public abstract double doubleValue

Set the given double as the target.
The transformer method must return a double and can optionally take a double as the first argument.

Returns:

The double constant to modify

Default:

0.0

stringValue

public abstract java.lang.String stringValue

Set the given String as the target.
The transformer method must return a String and can optionally take a String as the first argument.

Returns:

The String constant to modify

Default:

""

typeValue

public abstract java.lang.Class<?> typeValue

Set the given class as the target.
The transformer method must return a class and can optionally take a class as the first argument.

Returns:

The class constant to modify

Default:

java.lang.Object.class