org.spongepowered.asm.mixin.injection.invoke

Class InvokeInjector

java.lang.Object

org.spongepowered.asm.mixin.injection.code.Injector

org.spongepowered.asm.mixin.injection.invoke.InvokeInjector

Direct Known Subclasses:

ModifyArgInjector, ModifyArgsInjector, RedirectInjector

public abstract class InvokeInjector
extends Injector

Base class for injectors which inject at method invokes

Nested Class Summary

Nested classes/interfaces inherited from class org.spongepowered.asm.mixin.injection.code.Injector

Injector.TargetNode

Field Summary

Fields

Modifier and Type	Field and Description
protected java.lang.String	annotationType

Fields inherited from class org.spongepowered.asm.mixin.injection.code.Injector

classNode, info, isStatic, logger, methodArgs, methodNode, returnType

Constructor Summary

Constructors

Constructor and Description
InvokeInjector(InjectionInfo info, java.lang.String annotationType)

Method Summary

Modifier and Type	Method and Description
protected void	checkTarget(Target target) Sanity checks on target
protected void	checkTargetForNode(Target target, InjectionNodes.InjectionNode node) The normal staticness check is not location-aware, in that it merely enforces static modifiers of handlers to match their targets.
protected void	checkTargetModifiers(Target target, boolean exactMatch) Check that the static modifier of the target method matches the handler
protected void	inject(Target target, InjectionNodes.InjectionNode node)
protected abstract void	injectAtInvoke(Target target, InjectionNodes.InjectionNode node) Perform a single injection
protected org.spongepowered.asm.lib.tree.AbstractInsnNode	invokeHandlerWithArgs(org.spongepowered.asm.lib.Type[] args, org.spongepowered.asm.lib.tree.InsnList insns, int[] argMap)
protected org.spongepowered.asm.lib.tree.AbstractInsnNode	invokeHandlerWithArgs(org.spongepowered.asm.lib.Type[] args, org.spongepowered.asm.lib.tree.InsnList insns, int[] argMap, int startArg, int endArg)
protected void	pushArgs(org.spongepowered.asm.lib.Type[] args, org.spongepowered.asm.lib.tree.InsnList insns, int[] argMap, int start, int end) Load args onto the stack from their positions allocated in argMap
protected void	sanityCheck(Target target, java.util.List<InjectionPoint> injectionPoints)
protected int[]	storeArgs(Target target, org.spongepowered.asm.lib.Type[] args, org.spongepowered.asm.lib.tree.InsnList insns, int start) Store args on the stack starting at the end and working back to position specified by start, return the generated argMap
protected void	storeArgs(org.spongepowered.asm.lib.Type[] args, org.spongepowered.asm.lib.tree.InsnList insns, int[] argMap, int start, int end) Store args on the stack to their positions allocated based on argMap

Methods inherited from class org.spongepowered.asm.mixin.injection.code.Injector

addTargetNode, canCoerce, canCoerce, canCoerce, find, findTargetNodes, inject, invokeHandler, invokeHandler, postInject, throwException, toString

Methods inherited from class java.lang.Object

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

Field Detail

annotationType

protected final java.lang.String annotationType

Constructor Detail

InvokeInjector

public InvokeInjector(InjectionInfo info,
                      java.lang.String annotationType)

Parameters:

info - Information about this injection

annotationType - Annotation type, used for error messages

Method Detail

sanityCheck

protected void sanityCheck(Target target,
                           java.util.List<InjectionPoint> injectionPoints)

Overrides:

sanityCheck in class Injector

checkTarget

protected void checkTarget(Target target)

Sanity checks on target

Parameters:

target - target

checkTargetModifiers

protected final void checkTargetModifiers(Target target,
                                          boolean exactMatch)

Check that the static modifier of the target method matches the handler

Parameters:

target - Target to check

exactMatch - True if static must match, false to only check if an instance handler is targetting a static method

checkTargetForNode

protected void checkTargetForNode(Target target,
                                  InjectionNodes.InjectionNode node)

The normal staticness check is not location-aware, in that it merely enforces static modifiers of handlers to match their targets. For injecting into constructors however (which are ostensibly instance methods) calls which are injected before the call to super() cannot access this and must therefore be declared as static.

Parameters:

target - Target method

node - Injection location

inject

protected void inject(Target target,
                      InjectionNodes.InjectionNode node)

Specified by:

inject in class Injector

injectAtInvoke

protected abstract void injectAtInvoke(Target target,
                                       InjectionNodes.InjectionNode node)

Perform a single injection

Parameters:

target - Target to inject into

node - Discovered instruction node

invokeHandlerWithArgs

protected org.spongepowered.asm.lib.tree.AbstractInsnNode invokeHandlerWithArgs(org.spongepowered.asm.lib.Type[] args,
                                                                                org.spongepowered.asm.lib.tree.InsnList insns,
                                                                                int[] argMap)

Parameters:

args - handler arguments

insns - InsnList to inject insns into

argMap - Mapping of args to local variables

Returns:

injected insn node

invokeHandlerWithArgs

protected org.spongepowered.asm.lib.tree.AbstractInsnNode invokeHandlerWithArgs(org.spongepowered.asm.lib.Type[] args,
                                                                                org.spongepowered.asm.lib.tree.InsnList insns,
                                                                                int[] argMap,
                                                                                int startArg,
                                                                                int endArg)

Parameters:

args - handler arguments

insns - InsnList to inject insns into

argMap - Mapping of args to local variables

startArg - Starting arg to consume

endArg - Ending arg to consume

Returns:

injected insn node

storeArgs

protected int[] storeArgs(Target target,
                          org.spongepowered.asm.lib.Type[] args,
                          org.spongepowered.asm.lib.tree.InsnList insns,
                          int start)

Store args on the stack starting at the end and working back to position specified by start, return the generated argMap

Parameters:

target - target method

args - argument types

insns - instruction list to generate insns into

start - Starting index

Returns:

the generated argmap

storeArgs

protected void storeArgs(org.spongepowered.asm.lib.Type[] args,
                         org.spongepowered.asm.lib.tree.InsnList insns,
                         int[] argMap,
                         int start,
                         int end)

Store args on the stack to their positions allocated based on argMap

Parameters:

args - argument types

insns - instruction list to generate insns into

argMap - generated argmap containing local indices for all args

start - Starting index

end - Ending index

pushArgs

protected void pushArgs(org.spongepowered.asm.lib.Type[] args,
                        org.spongepowered.asm.lib.tree.InsnList insns,
                        int[] argMap,
                        int start,
                        int end)

Load args onto the stack from their positions allocated in argMap

Parameters:

args - argument types

insns - instruction list to generate insns into

argMap - generated argmap containing local indices for all args

start - Starting index

end - Ending index