Package dev.denwav.hypo.mappings.changes

Class AddNewMappingChange

java.lang.Object

dev.denwav.hypo.mappings.changes.AbstractMappingsChange

dev.denwav.hypo.mappings.changes.AddNewMappingChange

All Implemented Interfaces:

MappingsChange, MergeableMappingsChange<AddNewMappingChange>

public class AddNewMappingChange
extends AbstractMappingsChange
implements MergeableMappingsChange<AddNewMappingChange>

MappingsChange which adds a new member mapping.

Method Summary

Modifier and Type	Method	Description
void	applyChange(@NotNull MappingSet input, @NotNull MemberReference target)	Same as AbstractMappingsChange.applyChange(MappingSet) but it also includes this change's AbstractMappingsChange.target().
@NotNull MergeResult<AddNewMappingChange>	mergeWith(@NotNull AddNewMappingChange that)	Merge this with that, returning a new instance of this which applies the combination of both of the given changes.
static @NotNull AddNewMappingChange	of(@NotNull MemberReference target, @NotNull String newName)	Create a new AddNewMappingChange for the given target with the newName for the deobfuscated name.
String	toString()

Methods inherited from class dev.denwav.hypo.mappings.changes.AbstractMappingsChange

applyChange, equals, hashCode, target

Methods inherited from class java.lang.Object

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

Methods inherited from interface dev.denwav.hypo.mappings.MappingsChange

applyChange, target

Method Details

of

@Contract(value="_, _ -> new",
          pure=true)
@NotNull
public static @NotNull AddNewMappingChange of(@NotNull
 @NotNull MemberReference target,
 @NotNull
 @NotNull String newName)

Create a new AddNewMappingChange for the given target with the newName for the deobfuscated name.

Parameters:

target - The MemberReference this change targets.

newName - The deobfuscated name for the new mapping.

Returns:

A new AddNewMappingChange instance.

applyChange

public void applyChange(@NotNull
 @NotNull MappingSet input,
 @NotNull
 @NotNull MemberReference target)

Description copied from class: AbstractMappingsChange

Same as AbstractMappingsChange.applyChange(MappingSet) but it also includes this change's AbstractMappingsChange.target().

Specified by:

applyChange in class AbstractMappingsChange

Parameters:

input - The mapping set to change.

target - The member this change targets.

mergeWith

@NotNull
public @NotNull MergeResult<AddNewMappingChange> mergeWith(@NotNull
 @NotNull AddNewMappingChange that)

Description copied from interface: MergeableMappingsChange

Merge this with that, returning a new instance of this which applies the combination of both of the given changes. If the 2 changes cannot be merged such that both changes are completely satisfied without issues, then this method will return a failed merge result. If this method returns a successful merge result it will be considered successful.

For an example of a change which is compatible, imagine if this and that both request a mapping change with a new deobfuscated name, where both changes are requesting the same deobfuscated name. These changes would be compatible with each other as they are requesting the same change.

For another example, imagine if this and that both request changes to a method mapping, but each change is requesting a change to a different method parameter index. These changes are compatible because they have different targets (different method parameters) but the returned mappings change much apply both sets of changes to be considered properly merged.

For an example of an unmergeable case, if the 2 changes target the same member but have different deobfuscated names there is no way to successfully handle both cases, so the merge should fail.

Specified by:

mergeWith in interface MergeableMappingsChange<AddNewMappingChange>

Parameters:

that - The change, which must be the same type as this, to merge.

Returns:

The new mappings change, which must be the same type as this, which applies the combination of changes from both mappings changes.

toString

public String toString()

Overrides:

toString in class Object