org.spongepowered.asm.mixin.injection.modify

Class LocalVariableDiscriminator

java.lang.Object

org.spongepowered.asm.mixin.injection.modify.LocalVariableDiscriminator

public class LocalVariableDiscriminator
extends java.lang.Object

Encapsulates logic for identifying a local variable in a target method using 3 criteria: ordinal, index and name. This is used by the ModifyVariableInjector and its associated injection points.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	LocalVariableDiscriminator.Context Discriminator context information, wraps all relevant information about a target location for use when performing discrimination

Constructor Summary

Constructors

Constructor and Description
LocalVariableDiscriminator(boolean argsOnly, int ordinal, int index, java.util.Set<java.lang.String> names, boolean print)

Method Summary

Modifier and Type	Method and Description
int	findLocal(LocalVariableDiscriminator.Context context) Find a local variable for the specified context
int	findLocal(org.objectweb.asm.Type returnType, boolean argsOnly, Target target, org.objectweb.asm.tree.AbstractInsnNode node) Find a matching local variable in the specified target
int	getIndex() Get the local variable absolute index
java.util.Set<java.lang.String>	getNames() Get valid names for consideration
int	getOrdinal() Get the local variable ordinal (nth variable of type)
boolean	hasNames() Returns true if names is not empty
boolean	isArgsOnly() True if this discriminator will examine only the target method args and won't consider the rest of the LVT at the target location
protected boolean	isImplicit(LocalVariableDiscriminator.Context context) If the user specifies no values for ordinal, index or names then we are considered to be operating in "implicit mode" where only a single local variable of the specified type is expected to exist.
static LocalVariableDiscriminator	parse(org.objectweb.asm.tree.AnnotationNode annotation) Parse a local variable discriminator from the supplied annotation
boolean	printLVT() True if the injector should print the LVT

Methods inherited from class java.lang.Object

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

Constructor Detail

LocalVariableDiscriminator

public LocalVariableDiscriminator(boolean argsOnly,
                                  int ordinal,
                                  int index,
                                  java.util.Set<java.lang.String> names,
                                  boolean print)

Parameters:

argsOnly - true to only search within the method arguments

ordinal - target variable ordinal

index - target variable index

names - target variable names

print - true to print lvt

Method Detail

isArgsOnly

public boolean isArgsOnly()

True if this discriminator will examine only the target method args and won't consider the rest of the LVT at the target location

getOrdinal

public int getOrdinal()

Get the local variable ordinal (nth variable of type)

getIndex

public int getIndex()

Get the local variable absolute index

getNames

public java.util.Set<java.lang.String> getNames()

Get valid names for consideration

hasNames

public boolean hasNames()

Returns true if names is not empty

printLVT

public boolean printLVT()

True if the injector should print the LVT

isImplicit

protected boolean isImplicit(LocalVariableDiscriminator.Context context)

If the user specifies no values for ordinal, index or names then we are considered to be operating in "implicit mode" where only a single local variable of the specified type is expected to exist.

Parameters:

context - Target context

Returns:

true if operating in implicit mode

findLocal

public int findLocal(org.objectweb.asm.Type returnType,
                     boolean argsOnly,
                     Target target,
                     org.objectweb.asm.tree.AbstractInsnNode node)

Find a matching local variable in the specified target

Parameters:

returnType - variable tyoe

argsOnly - only match in the method args

target - target method

node - current instruction

Returns:

index of local or -1 if not matched

findLocal

public int findLocal(LocalVariableDiscriminator.Context context)

Find a local variable for the specified context

Parameters:

context - search context

Returns:

index of local or -1 if not found

parse

public static LocalVariableDiscriminator parse(org.objectweb.asm.tree.AnnotationNode annotation)

Parse a local variable discriminator from the supplied annotation

Parameters:

annotation - annotation to parse

Returns:

discriminator configured using values from the annoation