Package io.papermc.asm.rules.method

Record Class MethodRewrites.SubTypeReturn

java.lang.Object

java.lang.Record

io.papermc.asm.rules.method.MethodRewrites.SubTypeReturn

Record Components:

owners - owners of the methods to change

methodMatcher - method matcher to find methods with

oldReturnType - the return type that will be found in bytecode that needs to be transformed

newReturnType - the return type that is valid for existing method

All Implemented Interfaces:

MethodRewriteRule, OwnableMethodRewriteRule, OwnableMethodRewriteRule.Filtered, OwnableRewriteRule, RewriteRule

Enclosing class:

MethodRewrites

public static record MethodRewrites.SubTypeReturn(Set<ClassDesc> owners, MethodMatcher methodMatcher, ClassDesc oldReturnType, ClassDesc newReturnType)
extends Record
implements OwnableMethodRewriteRule.Filtered

Changes a return type to a subtype of the old type. This isn't a compile break as subtypes inherit everything, but it is an ABI break. We just change the return type in the descriptor and move on.

Nested Class Summary

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

MethodRewriteRule.GeneratorInfo<D extends GeneratedMethodHolder.CallData>, MethodRewriteRule.MethodGenerator, MethodRewriteRule.Rewrite<D extends GeneratedMethodHolder.CallData>, MethodRewriteRule.RewriteSingle

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
SubTypeReturn(Set<ClassDesc> owners, MethodMatcher methodMatcher, ClassDesc oldReturnType, ClassDesc newReturnType)	Creates an instance of a SubTypeReturn 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.
MethodMatcher	methodMatcher()	Returns the value of the methodMatcher record component.
ClassDesc	newReturnType()	Returns the value of the newReturnType record component.
ClassDesc	oldReturnType()	Returns the value of the oldReturnType record component.
Set<ClassDesc>	owners()	Returns the value of the owners record component.
@Nullable MethodRewriteRule.Rewrite<?>	rewrite(ClassProcessingContext context, boolean isInvokeDynamic, int opcode, ClassDesc owner, String name, MethodTypeDesc descriptor, boolean isInterface)
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

SubTypeReturn

public SubTypeReturn(Set<ClassDesc> owners,
 MethodMatcher methodMatcher,
 ClassDesc oldReturnType,
 ClassDesc newReturnType)

Creates an instance of a SubTypeReturn record class.

Parameters:

owners - the value for the owners record component

methodMatcher - the value for the methodMatcher record component

oldReturnType - the value for the oldReturnType record component

newReturnType - the value for the newReturnType record component

Method Details

rewrite

public @Nullable MethodRewriteRule.Rewrite<?> rewrite(ClassProcessingContext context,
 boolean isInvokeDynamic,
 int opcode,
 ClassDesc owner,
 String name,
 MethodTypeDesc descriptor,
 boolean isInterface)

Specified by:

rewrite in interface MethodRewriteRule

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 MethodMatcher methodMatcher()

Returns the value of the methodMatcher record component.

Specified by:

methodMatcher in interface OwnableMethodRewriteRule.Filtered

Returns:

the value of the methodMatcher record component

oldReturnType

public ClassDesc oldReturnType()

Returns the value of the oldReturnType record component.

Returns:

the value of the oldReturnType record component

newReturnType

public ClassDesc newReturnType()

Returns the value of the newReturnType record component.

Returns:

the value of the newReturnType record component