Package io.papermc.asm.rules.method.rewrite

Interface MethodRewrite<D extends GeneratedMethodHolder.CallData>

Type Parameters:

D - the type of call data

All Known Implementing Classes:

ConstructorRewrite, SimpleRewrite

public interface MethodRewrite<D extends GeneratedMethodHolder.CallData>

Represents a change/rewrite to bytecode.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final record	MethodRewrite.GeneratorInfo<D extends GeneratedMethodHolder.CallData>
static interface	MethodRewrite.MethodGenerator

Field Summary

Fields

Modifier and Type	Field	Description
static final int	BOOTSTRAP_HANDLE_IDX
static final int	DYNAMIC_TYPE_IDX
static final String	GENERATED_PREFIX

Method Summary

Modifier and Type	Method	Description
void	apply(MethodVisitor delegate, MethodNode context)	Called to apply the rewrite when a matching invoke non-dynamic instruction is found.
void	applyToBootstrapArguments(Object[] arguments)	Called to apply the rewrite to a matching invokedynamic instruction is found.
@Nullable MethodRewrite.MethodGenerator	createMethodGenerator()	Creates a MethodRewrite.MethodGenerator for this rewrite.
MethodRewrite<D>	withGeneratorInfo(GeneratedMethodHolder holder, D original)	Creates a new MethodRewrite with the given generator info.
default MethodRewrite<D>	withHandleExtras(Consumer<Object[]> extras)	Creates a new MethodRewrite with the given "extras" handler.

Field Details

BOOTSTRAP_HANDLE_IDX

static final int BOOTSTRAP_HANDLE_IDX

See Also:

• Constant Field Values

DYNAMIC_TYPE_IDX

static final int DYNAMIC_TYPE_IDX

See Also:

• Constant Field Values

GENERATED_PREFIX

static final String GENERATED_PREFIX

See Also:

• Constant Field Values

Method Details

apply

void apply(MethodVisitor delegate,
 MethodNode context)

Called to apply the rewrite when a matching invoke non-dynamic instruction is found.

Parameters:

delegate - the visitor to apply the change to

context - the surrounding context of the method's data including instructions

applyToBootstrapArguments

void applyToBootstrapArguments(Object[] arguments)

Called to apply the rewrite to a matching invokedynamic instruction is found.

Parameters:

arguments - the bootstrap arguments MethodVisitor.visitInvokeDynamicInsn(String, String, Handle, Object...)

withGeneratorInfo

MethodRewrite<D> withGeneratorInfo(GeneratedMethodHolder holder,
 D original)

Creates a new MethodRewrite with the given generator info.

Parameters:

holder - the generator holder

original - the original call data

Returns:

the new rewrite

withHandleExtras

default MethodRewrite<D> withHandleExtras(Consumer<Object[]> extras)

Creates a new MethodRewrite with the given "extras" handler. This is when extra changes are required for invokedynamic instructions.

Parameters:

extras - the extras handler

Returns:

the new rewrite (or the same if not supported on the rewrite type)

createMethodGenerator

@Nullable MethodRewrite.MethodGenerator createMethodGenerator()

Creates a MethodRewrite.MethodGenerator for this rewrite.

Returns:

a method generator, or null if this rewrite doesn't have one

See Also:

• withGeneratorInfo(GeneratedMethodHolder, GeneratedMethodHolder.CallData)