Package org.robolectric.internal.bytecode

Class ClassInstrumentor

java.lang.Object

org.robolectric.internal.bytecode.ClassInstrumentor

Direct Known Subclasses:

InvokeDynamicClassInstrumentor, OldClassInstrumentor

public abstract class ClassInstrumentor
extends java.lang.Object

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	ClassInstrumentor.Decorator

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	ClassInstrumentor(ClassInstrumentor.Decorator decorator)

Method Summary

Modifier and Type	Method	Description
protected abstract void	addDirectCallConstructor(MutableClass mutableClass)
MutableClass	analyzeClass(byte[] origClassBytes, InstrumentationConfiguration config, ClassNodeProvider classNodeProvider)
protected java.lang.String[]	exceptionArray(org.objectweb.asm.tree.MethodNode method)
protected abstract void	generateClassHandlerCall(MutableClass mutableClass, org.objectweb.asm.tree.MethodNode originalMethod, java.lang.String originalMethodName, RobolectricGeneratorAdapter generator)
byte[]	instrument(byte[] origBytes, InstrumentationConfiguration config, ClassNodeProvider classNodeProvider)
void	instrument(MutableClass mutableClass)
protected void	instrumentNativeMethod(MutableClass mutableClass, org.objectweb.asm.tree.MethodNode method)	Creates native stub which returns the default return value.
protected void	instrumentNormalMethod(MutableClass mutableClass, org.objectweb.asm.tree.MethodNode method)	Instruments a normal method Rename the method from methodName to $$robo$$methodName.
protected abstract void	interceptInvokeVirtualMethod(MutableClass mutableClass, java.util.ListIterator<org.objectweb.asm.tree.AbstractInsnNode> instructions, org.objectweb.asm.tree.MethodInsnNode targetMethod)	Decides to call through the appropriate method to intercept the method with an INVOKEVIRTUAL Opcode, depending if the invokedynamic bytecode instruction is available (Java 7+).
protected void	makeMethodPrivate(org.objectweb.asm.tree.MethodNode method)	Replaces protected and public class modifiers with private.
protected void	makeMethodPublic(org.objectweb.asm.tree.MethodNode method)	Replaces protected and private method modifiers with public.
protected abstract void	writeCallToInitializing(MutableClass mutableClass, RobolectricGeneratorAdapter generator)

Methods inherited from class java.lang.Object

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

Constructor Detail

ClassInstrumentor

protected ClassInstrumentor(ClassInstrumentor.Decorator decorator)

Method Detail

analyzeClass

public MutableClass analyzeClass(byte[] origClassBytes,
                                 InstrumentationConfiguration config,
                                 ClassNodeProvider classNodeProvider)

instrument

public byte[] instrument(byte[] origBytes,
                         InstrumentationConfiguration config,
                         ClassNodeProvider classNodeProvider)

instrument

public void instrument(MutableClass mutableClass)

addDirectCallConstructor

protected abstract void addDirectCallConstructor(MutableClass mutableClass)

writeCallToInitializing

protected abstract void writeCallToInitializing(MutableClass mutableClass,
                                                RobolectricGeneratorAdapter generator)

instrumentNormalMethod

protected void instrumentNormalMethod(MutableClass mutableClass,
                                      org.objectweb.asm.tree.MethodNode method)

Instruments a normal method

• Rename the method from methodName to $$robo$$methodName.
• Make it private so we can invoke it directly without subclass overrides taking precedence.
• Remove final modifiers, if present.
• Create a delegator method named methodName which delegates to the ClassHandler.

instrumentNativeMethod

protected void instrumentNativeMethod(MutableClass mutableClass,
                                      org.objectweb.asm.tree.MethodNode method)

Creates native stub which returns the default return value.

Parameters:

mutableClass - Class to be instrumented

method - Method to be instrumented, must be native

exceptionArray

protected java.lang.String[] exceptionArray(org.objectweb.asm.tree.MethodNode method)

interceptInvokeVirtualMethod

protected abstract void interceptInvokeVirtualMethod(MutableClass mutableClass,
                                                     java.util.ListIterator<org.objectweb.asm.tree.AbstractInsnNode> instructions,
                                                     org.objectweb.asm.tree.MethodInsnNode targetMethod)

Decides to call through the appropriate method to intercept the method with an INVOKEVIRTUAL Opcode, depending if the invokedynamic bytecode instruction is available (Java 7+).

makeMethodPublic

protected void makeMethodPublic(org.objectweb.asm.tree.MethodNode method)

Replaces protected and private method modifiers with public.

makeMethodPrivate

protected void makeMethodPrivate(org.objectweb.asm.tree.MethodNode method)

Replaces protected and public class modifiers with private.

generateClassHandlerCall

protected abstract void generateClassHandlerCall(MutableClass mutableClass,
                                                 org.objectweb.asm.tree.MethodNode originalMethod,
                                                 java.lang.String originalMethodName,
                                                 RobolectricGeneratorAdapter generator)