org.spongepowered.asm.mixin.injection.code

Class Injector

java.lang.Object

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

Direct Known Subclasses:

CallbackInjector, InvokeInjector, ModifyVariableInjector

public abstract class Injector
extends java.lang.Object

Base class for bytecode injectors

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Injector.TargetNode A nominated target node

Field Summary

Fields

Modifier and Type	Field and Description
protected org.spongepowered.asm.lib.tree.ClassNode	classNode Class node
protected InjectionInfo	info Injection info
protected boolean	isStatic True if the callback method is static
protected static org.apache.logging.log4j.Logger	logger Log more things
protected org.spongepowered.asm.lib.Type[]	methodArgs Arguments of the handler method
protected org.spongepowered.asm.lib.tree.MethodNode	methodNode Callback method
protected org.spongepowered.asm.lib.Type	returnType Return type of the handler method

Constructor Summary

Constructors

Constructor and Description
Injector(InjectionInfo info) Make a new CallbackInjector for the supplied InjectionInfo

Method Summary

Modifier and Type	Method and Description
protected void	addTargetNode(Target target, java.util.List<InjectionNodes.InjectionNode> myNodes, org.spongepowered.asm.lib.tree.AbstractInsnNode node, java.util.Set<InjectionPoint> nominators)
static boolean	canCoerce(char from, char to) Returns whether the from type can be coerced to the to type.
static boolean	canCoerce(java.lang.String from, java.lang.String to) Returns whether the from type can be coerced to the to type.
static boolean	canCoerce(org.spongepowered.asm.lib.Type from, org.spongepowered.asm.lib.Type to) Returns whether the from type can be coerced to the to type.
java.util.List<InjectionNodes.InjectionNode>	find(InjectorTarget injectorTarget, java.util.List<InjectionPoint> injectionPoints) ...
protected boolean	findTargetNodes(org.spongepowered.asm.lib.tree.MethodNode into, InjectionPoint injectionPoint, org.spongepowered.asm.lib.tree.InsnList insns, java.util.Collection<org.spongepowered.asm.lib.tree.AbstractInsnNode> nodes)
protected abstract void	inject(Target target, InjectionNodes.InjectionNode node)
void	inject(Target target, java.util.List<InjectionNodes.InjectionNode> nodes) Performs the injection on the specified target
protected org.spongepowered.asm.lib.tree.AbstractInsnNode	invokeHandler(org.spongepowered.asm.lib.tree.InsnList insns) Invoke the handler method
protected org.spongepowered.asm.lib.tree.AbstractInsnNode	invokeHandler(org.spongepowered.asm.lib.tree.InsnList insns, org.spongepowered.asm.lib.tree.MethodNode handler) Invoke a handler method
protected void	postInject(Target target, InjectionNodes.InjectionNode node)
protected void	sanityCheck(Target target, java.util.List<InjectionPoint> injectionPoints)
protected void	throwException(org.spongepowered.asm.lib.tree.InsnList insns, java.lang.String exceptionType, java.lang.String message) Throw an exception.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

logger

protected static final org.apache.logging.log4j.Logger logger

Log more things

info

protected InjectionInfo info

Injection info

classNode

protected final org.spongepowered.asm.lib.tree.ClassNode classNode

Class node

methodNode

protected final org.spongepowered.asm.lib.tree.MethodNode methodNode

Callback method

methodArgs

protected final org.spongepowered.asm.lib.Type[] methodArgs

Arguments of the handler method

returnType

protected final org.spongepowered.asm.lib.Type returnType

Return type of the handler method

isStatic

protected final boolean isStatic

True if the callback method is static

Constructor Detail

Injector

public Injector(InjectionInfo info)

Make a new CallbackInjector for the supplied InjectionInfo

Parameters:

info - Information about this injection

Method Detail

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

find

public final java.util.List<InjectionNodes.InjectionNode> find(InjectorTarget injectorTarget,
                                                               java.util.List<InjectionPoint> injectionPoints)

...

Parameters:

injectorTarget - Target method to inject into

injectionPoints - InjectionPoint instances which will identify target insns in the target method

Returns:

discovered injection points

addTargetNode

protected void addTargetNode(Target target,
                             java.util.List<InjectionNodes.InjectionNode> myNodes,
                             org.spongepowered.asm.lib.tree.AbstractInsnNode node,
                             java.util.Set<InjectionPoint> nominators)

inject

public final void inject(Target target,
                         java.util.List<InjectionNodes.InjectionNode> nodes)

Performs the injection on the specified target

Parameters:

target - target to inject into

nodes - selected nodes

findTargetNodes

protected boolean findTargetNodes(org.spongepowered.asm.lib.tree.MethodNode into,
                                  InjectionPoint injectionPoint,
                                  org.spongepowered.asm.lib.tree.InsnList insns,
                                  java.util.Collection<org.spongepowered.asm.lib.tree.AbstractInsnNode> nodes)

sanityCheck

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

inject

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

postInject

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

invokeHandler

protected org.spongepowered.asm.lib.tree.AbstractInsnNode invokeHandler(org.spongepowered.asm.lib.tree.InsnList insns)

Invoke the handler method

Parameters:

insns - Instruction list to inject into

Returns:

injected insn node

invokeHandler

protected org.spongepowered.asm.lib.tree.AbstractInsnNode invokeHandler(org.spongepowered.asm.lib.tree.InsnList insns,
                                                                        org.spongepowered.asm.lib.tree.MethodNode handler)

Invoke a handler method

Parameters:

insns - Instruction list to inject into

handler - Actual method to invoke (may be different if using a surrogate)

Returns:

injected insn node

throwException

protected void throwException(org.spongepowered.asm.lib.tree.InsnList insns,
                              java.lang.String exceptionType,
                              java.lang.String message)

Throw an exception. The exception class must have a string which takes a string argument

Parameters:

insns - Insn list to inject into

exceptionType - Type of exception to throw (binary name)

message - Message to pass to the exception constructor

canCoerce

public static boolean canCoerce(org.spongepowered.asm.lib.Type from,
                                org.spongepowered.asm.lib.Type to)

Returns whether the from type can be coerced to the to type.

Parameters:

from - type to coerce from

to - type to coerce to

Returns:

true if from can be coerced to to

canCoerce

public static boolean canCoerce(java.lang.String from,
                                java.lang.String to)

Returns whether the from type can be coerced to the to type.

Parameters:

from - type to coerce from

to - type to coerce to

Returns:

true if from can be coerced to to

canCoerce

public static boolean canCoerce(char from,
                                char to)

Returns whether the from type can be coerced to the to type.

Parameters:

from - type to coerce from

to - type to coerce to

Returns:

true if from can be coerced to to