Package cpw.mods.modlauncher

Class TransformerHolder<T>

java.lang.Object

cpw.mods.modlauncher.TransformerHolder<T>

All Implemented Interfaces:

ITransformer<T>

public class TransformerHolder<T>
extends Object
implements ITransformer<T>

Nested Class Summary

Nested classes/interfaces inherited from interface cpw.mods.modlauncher.api.ITransformer

ITransformer.Target<T>

Field Summary

Fields

Modifier and Type	Field	Description
private final ITransformationService	owner
private final ITransformer<T>	wrapped

Fields inherited from interface cpw.mods.modlauncher.api.ITransformer

DEFAULT_LABEL

Constructor Summary

Constructors

Constructor	Description
TransformerHolder(ITransformer<T> wrapped, ITransformationService owner)

Method Summary

Modifier and Type	Method	Description
TransformerVoteResult	castVote(ITransformerVotingContext context)	Return the TransformerVoteResult for this transformer.
TargetType<T>	getTargetType()
String[]	labels()
ITransformationService	owner()
Set<ITransformer.Target<T>>	targets()	Return a set of ITransformer.Target identifying which elements this transformer wishes to try and apply to.
T	transform(T input, ITransformerVotingContext context)	Transform the input to the ITransformer's desire.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

wrapped

private final ITransformer<T> wrapped

owner

private final ITransformationService owner

Constructor Details

TransformerHolder

public TransformerHolder(ITransformer<T> wrapped,
 ITransformationService owner)

Method Details

transform

public T transform(T input,
 ITransformerVotingContext context)

Description copied from interface: ITransformer

Transform the input to the ITransformer's desire. The context from the last vote is provided as well.

Specified by:

transform in interface ITransformer<T>

Parameters:

input - The ASM input node, which can be mutated directly

context - The voting context

Returns:

An ASM node of the same type as that supplied. It will be used for subsequent rounds of voting.

castVote

public TransformerVoteResult castVote(ITransformerVotingContext context)

Description copied from interface: ITransformer

Return the TransformerVoteResult for this transformer. The transformer should evaluate whether or not is is a candidate to apply during the round of voting in progress, represented by the context parameter. How the vote works:

• If the transformer wishes to be a candidate, it should return TransformerVoteResult.YES.
• If the transformer wishes to exit the voting (the transformer has already has its intended change applied, for example), it should return TransformerVoteResult.NO
• If the transformer wishes to wait for future rounds of voting it should return TransformerVoteResult.DEFER. Note that if there is no YES candidate, but DEFER candidates remain, this is a DEFERRAL stalemate and the game will crash.
• If the transformer wishes to crash the game, it should return TransformerVoteResult.REJECT. This is extremely frowned upon, and should not be used except in extreme circumstances. If an incompatibility is present, it should detect and handle it in the ITransformationService.onLoad(cpw.mods.modlauncher.api.IEnvironment, java.util.Set<java.lang.String>)

After all votes from candidate transformers are collected, the NOs are removed from the current set of voters, one from the set of YES voters is selected and it's ITransformer.transform(Object, ITransformerVotingContext) method called. It is then removed from the set of transformers and another round is performed.

Specified by:

castVote in interface ITransformer<T>

Parameters:

context - The context of the vote

Returns:

A TransformerVoteResult indicating the desire of this transformer

targets

public Set<ITransformer.Target<T>> targets()

Description copied from interface: ITransformer

Return a set of ITransformer.Target identifying which elements this transformer wishes to try and apply to. The ITransformer.getTargetType() must match the T variable for the transformer as documented in TargetType, other combinations will be rejected.

Specified by:

targets in interface ITransformer<T>

Returns:

The set of targets this transformer wishes to apply to

getTargetType

public TargetType<T> getTargetType()

Specified by:

getTargetType in interface ITransformer<T>

labels

public String[] labels()

Specified by:

labels in interface ITransformer<T>

Returns:

A string array for uniquely identifying this transformer instance within the service.

owner

public ITransformationService owner()