Package io.papermc.asm.rules.method.params

Record Class SuperTypeParamRewrite

java.lang.Object

java.lang.Record

io.papermc.asm.rules.method.params.SuperTypeParamRewrite

Record Components:

owners - owners of the methods to change

methodMatcher - method matcher to find methods with (target is the type to be found in bytecode that needs to be transformed)

newParamType - the parameter type that is valid for existing method

All Implemented Interfaces:

MethodRewriteRule, OwnableMethodRewriteRule, OwnableMethodRewriteRule.Filtered, OwnableRewriteRule, RewriteRule

public record SuperTypeParamRewrite(Set<ClassDesc> owners, TargetedMethodMatcher methodMatcher, ClassDesc newParamType)
extends Record
implements OwnableMethodRewriteRule.Filtered

Changes a parameter type to a super type. This isn't a compile break, but it is an ABI break. We just change the offending parameter in the descriptor and move on.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	SuperTypeParamRewrite.Versioned

Nested classes/interfaces inherited from interface io.papermc.asm.rules.method.OwnableMethodRewriteRule

OwnableMethodRewriteRule.Filtered

Nested classes/interfaces inherited from interface io.papermc.asm.rules.RewriteRule

RewriteRule.Chain, RewriteRule.ChainBuilder, RewriteRule.Delegate, RewriteRule.GeneratorAdapterFactory

Field Summary

Fields inherited from interface io.papermc.asm.rules.method.MethodRewriteRule

LAMBDA_METAFACTORY_OWNER

Fields inherited from interface io.papermc.asm.rules.RewriteRule

EMPTY

Constructor Summary

Constructors

Constructor	Description
SuperTypeParamRewrite(Set<ClassDesc> owners, TargetedMethodMatcher methodMatcher, ClassDesc newParamType)	Creates an instance of a SuperTypeParamRewrite record class.

Method Summary

Modifier and Type	Method	Description
final boolean	equals(Object o)	Indicates whether some other object is "equal to" this one.
final int	hashCode()	Returns a hash code value for this object.
TargetedMethodMatcher	methodMatcher()	Returns the value of the methodMatcher record component.
ClassDesc	newParamType()	Returns the value of the newParamType record component.
ClassDesc	oldParamType()
Set<ClassDesc>	owners()	Returns the value of the owners record component.
MethodRewrite<?>	rewrite(ClassProcessingContext context, boolean isInvokeDynamic, int opcode, ClassDesc owner, String name, MethodTypeDesc descriptor, boolean isInterface)	Creates a MethodRewrite which will be applied to the processed bytecode.
final String	toString()	Returns a string representation of this record class.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface io.papermc.asm.rules.method.MethodRewriteRule

createVisitor

Methods inherited from interface io.papermc.asm.rules.method.OwnableMethodRewriteRule.Filtered

shouldProcess

Methods inherited from interface io.papermc.asm.rules.OwnableRewriteRule

matchesOwner

Constructor Details

SuperTypeParamRewrite

public SuperTypeParamRewrite(Set<ClassDesc> owners,
 TargetedMethodMatcher methodMatcher,
 ClassDesc newParamType)

Creates an instance of a SuperTypeParamRewrite record class.

Parameters:

owners - the value for the owners record component

methodMatcher - the value for the methodMatcher record component

newParamType - the value for the newParamType record component

Method Details

oldParamType

public ClassDesc oldParamType()

rewrite

public MethodRewrite<?> rewrite(ClassProcessingContext context,
 boolean isInvokeDynamic,
 int opcode,
 ClassDesc owner,
 String name,
 MethodTypeDesc descriptor,
 boolean isInterface)

Description copied from interface: MethodRewriteRule

Creates a MethodRewrite which will be applied to the processed bytecode.

Specified by:

rewrite in interface MethodRewriteRule

Parameters:

context - the current context

isInvokeDynamic - if this is in an invokedynamic instruction

opcode - the opcode of the invoke instruction or the invokedynamic handle tag

owner - the owner of the invoke method or the owner of the invokedynamic handle

name - the name of the invoke method or the name of the invokedynamic handle

descriptor - the descriptor of the invoke method or the descriptor of the invokedynamic handle

isInterface - if the method is an interface method

Returns:

the rewrite or null if no rewrite should be applied

toString

public final String toString()

Returns a string representation of this record class. The representation contains the name of the class, followed by the name and value of each of the record components.

Specified by:

toString in class Record

Returns:

a string representation of this object

hashCode

public final int hashCode()

Returns a hash code value for this object. The value is derived from the hash code of each of the record components.

Specified by:

hashCode in class Record

Returns:

a hash code value for this object

equals

public final boolean equals(Object o)

Indicates whether some other object is "equal to" this one. The objects are equal if the other object is of the same class and if all the record components are equal. All components in this record class are compared with Objects::equals(Object,Object).

Specified by:

equals in class Record

Parameters:

o - the object with which to compare

Returns:

true if this object is the same as the o argument; false otherwise.

owners

public Set<ClassDesc> owners()

Returns the value of the owners record component.

Specified by:

owners in interface OwnableRewriteRule

Returns:

the value of the owners record component

methodMatcher

public TargetedMethodMatcher methodMatcher()

Returns the value of the methodMatcher record component.

Specified by:

methodMatcher in interface OwnableMethodRewriteRule.Filtered

Returns:

the value of the methodMatcher record component

newParamType

public ClassDesc newParamType()

Returns the value of the newParamType record component.

Returns:

the value of the newParamType record component