ReferenceTracingInvocationUnit ([net.sf.proguard] proguard-base 6.1.0 API)

java.lang.Object
- proguard.classfile.util.SimplifiedVisitor
- - proguard.evaluation.SimplifiedInvocationUnit
  - - proguard.optimize.evaluation.ReferenceTracingInvocationUnit

All Implemented Interfaces:

ConstantVisitor, ParameterVisitor, InvocationUnit

Direct Known Subclasses:

ParameterTracingInvocationUnit
```
public class ReferenceTracingInvocationUnit
extends SimplifiedInvocationUnit
```
This InvocationUnit tags reference values of retrieved fields, passed method parameters, method return values, and caught exceptions, so they can be traced throughout the execution of a method. The tags are instruction offsets or parameter indices (not parameter offsets).

Author:

Eric Lafortune

See Also:

TracedReferenceValue, InstructionOffsetValue

Field Summary
- Fields inherited from class proguard.evaluation.SimplifiedInvocationUnit
  isLoad, isStatic, stack

Constructor Summary

Constructors
Constructor and Description

ReferenceTracingInvocationUnit(SimplifiedInvocationUnit invocationUnit)
Creates a new ReferenceTracingInvocationUnit.

Constructors
Constructor and Description
`ReferenceTracingInvocationUnit(SimplifiedInvocationUnit invocationUnit)` Creates a new ReferenceTracingInvocationUnit.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`enterExceptionHandler(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, int catchType, Stack stack)` Sets up the given stack for entering the given exception handler.
`Value`	`getExceptionValue(Clazz clazz, ClassConstant catchClassConstant)` Returns the value of the specified exception.
`Value`	`getFieldClassValue(Clazz clazz, RefConstant refConstant, String type)` Returns the class though which the specified field is accessed.
`Value`	`getFieldValue(Clazz clazz, RefConstant refConstant, String type)` Returns the value of the specified field.
`Value`	`getMethodParameterValue(Clazz clazz, Method method, int parameterIndex, String type, Clazz referencedClass)` Returns the value of the specified method parameter.
`Value`	`getMethodReturnValue(Clazz clazz, InvokeDynamicConstant invokeDynamicConstant, String type)` Returns the return value of the specified method.
`Value`	`getMethodReturnValue(Clazz clazz, RefConstant refConstant, String type)` Returns the return value of the specified method.
`void`	`invokeMember(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ConstantInstruction constantInstruction, Stack stack)` Updates the given stack corresponding to the execution of the given field or method reference instruction.
`void`	`setFieldClassValue(Clazz clazz, RefConstant refConstant, ReferenceValue value)` Sets the class through which the specified field is accessed.
`void`	`setFieldValue(Clazz clazz, RefConstant refConstant, Value value)` Sets the value of the specified field.
`void`	`setMethodParameterValue(Clazz clazz, RefConstant refConstant, int parameterIndex, Value value)` Sets the value of the specified method parameter.
`void`	`setMethodReturnValue(Clazz clazz, Method method, Value value)` Sets the return value of the specified method.
`protected Value`	`trace(Value value, InstructionOffsetValue traceValue)` Sets or replaces the trace value on a given value, returning the result.
`protected Value`	`trace(Value value, int trace)` Sets or replaces the trace value on a given value, if it's a reference value, returning the result.

Methods inherited from class proguard.evaluation.SimplifiedInvocationUnit
enterMethod, exitMethod, visitAnyMethodrefConstant, visitFieldrefConstant, visitInvokeDynamicConstant, visitParameter

Methods inherited from class proguard.classfile.util.SimplifiedVisitor
visitAnnotation, visitAnnotation, visitAnnotation, visitAnnotation, visitAnnotation, visitAnnotation, visitAnnotationDefaultAttribute, visitAnnotationElementValue, visitAnyAnnotationsAttribute, visitAnyAttribute, visitAnyClass, visitAnyConstant, visitAnyElementValue, visitAnyInstruction, visitAnyMember, visitAnyParameterAnnotationsAttribute, visitAnyPrimitiveArrayConstant, visitAnyPrimitiveArrayConstantElement, visitAnyRefConstant, visitAnyStackMapFrame, visitAnySwitchInstruction, visitAnyTargetInfo, visitAnyTypeAnnotationsAttribute, visitAnyVerificationType, visitArrayElementValue, visitBooleanArrayConstant, visitBooleanArrayConstantElement, visitBootstrapMethodsAttribute, visitBranchInstruction, visitByteArrayConstant, visitByteArrayConstantElement, visitCatchTargetInfo, visitCharArrayConstant, visitCharArrayConstantElement, visitClassConstant, visitClassElementValue, visitCodeAttribute, visitConstantElementValue, visitConstantInstruction, visitConstantValueAttribute, visitDeprecatedAttribute, visitDeprecatedAttribute, visitDeprecatedAttribute, visitDeprecatedAttribute, visitDoubleArrayConstant, visitDoubleArrayConstantElement, visitDoubleConstant, visitDoubleType, visitDynamicConstant, visitEmptyTargetInfo, visitEmptyTargetInfo, visitEmptyTargetInfo, visitEnclosingMethodAttribute, visitEnumConstantElementValue, visitExceptionsAttribute, visitFloatArrayConstant, visitFloatArrayConstantElement, visitFloatConstant, visitFloatType, visitFormalParameterTargetInfo, visitFullFrame, visitInnerClassesAttribute, visitIntArrayConstant, visitIntArrayConstantElement, visitIntegerConstant, visitIntegerType, visitInterfaceMethodrefConstant, visitLessZeroFrame, visitLibraryClass, visitLibraryField, visitLibraryMember, visitLibraryMethod, visitLineNumberTableAttribute, visitLocalVariableTableAttribute, visitLocalVariableTargetInfo, visitLocalVariableTypeTableAttribute, visitLongArrayConstant, visitLongArrayConstantElement, visitLongConstant, visitLongType, visitLookUpSwitchInstruction, visitMethodHandleConstant, visitMethodParametersAttribute, visitMethodrefConstant, visitMethodTypeConstant, visitModuleAttribute, visitModuleConstant, visitModuleMainClassAttribute, visitModulePackagesAttribute, visitMoreZeroFrame, visitNameAndTypeConstant, visitNestHostAttribute, visitNestMembersAttribute, visitNullType, visitObjectType, visitOffsetTargetInfo, visitPackageConstant, visitPrimitiveArrayConstant, visitProgramClass, visitProgramField, visitProgramMember, visitProgramMethod, visitRuntimeInvisibleAnnotationsAttribute, visitRuntimeInvisibleAnnotationsAttribute, visitRuntimeInvisibleAnnotationsAttribute, visitRuntimeInvisibleAnnotationsAttribute, visitRuntimeInvisibleParameterAnnotationsAttribute, visitRuntimeInvisibleTypeAnnotationsAttribute, visitRuntimeInvisibleTypeAnnotationsAttribute, visitRuntimeInvisibleTypeAnnotationsAttribute, visitRuntimeInvisibleTypeAnnotationsAttribute, visitRuntimeInvisibleTypeAnnotationsAttribute, visitRuntimeVisibleAnnotationsAttribute, visitRuntimeVisibleAnnotationsAttribute, visitRuntimeVisibleAnnotationsAttribute, visitRuntimeVisibleAnnotationsAttribute, visitRuntimeVisibleParameterAnnotationsAttribute, visitRuntimeVisibleTypeAnnotationsAttribute, visitRuntimeVisibleTypeAnnotationsAttribute, visitRuntimeVisibleTypeAnnotationsAttribute, visitRuntimeVisibleTypeAnnotationsAttribute, visitRuntimeVisibleTypeAnnotationsAttribute, visitSameOneFrame, visitSameZeroFrame, visitShortArrayConstant, visitShortArrayConstantElement, visitSignatureAttribute, visitSignatureAttribute, visitSignatureAttribute, visitSignatureAttribute, visitSimpleInstruction, visitSourceDirAttribute, visitSourceFileAttribute, visitStackDoubleType, visitStackFloatType, visitStackIntegerType, visitStackLongType, visitStackMapAttribute, visitStackMapTableAttribute, visitStackNullType, visitStackObjectType, visitStackTopType, visitStackUninitializedThisType, visitStackUninitializedType, visitStringConstant, visitSuperTypeTargetInfo, visitSyntheticAttribute, visitSyntheticAttribute, visitSyntheticAttribute, visitSyntheticAttribute, visitTableSwitchInstruction, visitThrowsTargetInfo, visitTopType, visitTypeAnnotation, visitTypeAnnotation, visitTypeAnnotation, visitTypeAnnotation, visitTypeAnnotation, visitTypeAnnotation, visitTypeArgumentTargetInfo, visitTypeParameterBoundTargetInfo, visitTypeParameterBoundTargetInfo, visitTypeParameterBoundTargetInfo, visitTypeParameterBoundTargetInfo, visitTypeParameterTargetInfo, visitTypeParameterTargetInfo, visitTypePathInfo, visitTypePathInfo, visitTypePathInfo, visitTypePathInfo, visitTypePathInfo, visitUninitializedThisType, visitUninitializedType, visitUnknownAttribute, visitUtf8Constant, visitVariableInstruction, visitVariablesDoubleType, visitVariablesFloatType, visitVariablesIntegerType, visitVariablesLongType, visitVariablesNullType, visitVariablesObjectType, visitVariablesTopType, visitVariablesUninitializedThisType, visitVariablesUninitializedType

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface proguard.classfile.constant.visitor.ConstantVisitor
visitClassConstant, visitDoubleConstant, visitDynamicConstant, visitFloatConstant, visitIntegerConstant, visitInterfaceMethodrefConstant, visitLongConstant, visitMethodHandleConstant, visitMethodrefConstant, visitMethodTypeConstant, visitModuleConstant, visitNameAndTypeConstant, visitPackageConstant, visitPrimitiveArrayConstant, visitStringConstant, visitUtf8Constant

Constructor Detail
- ReferenceTracingInvocationUnit
```
public ReferenceTracingInvocationUnit(SimplifiedInvocationUnit invocationUnit)
```
  Creates a new ReferenceTracingInvocationUnit.
  
  Parameters:
  
  invocationUnit - the invocation unit to which invocations will be delegated.

Method Detail

enterExceptionHandler

public void enterExceptionHandler(Clazz clazz,
                                  Method method,
                                  CodeAttribute codeAttribute,
                                  int offset,
                                  int catchType,
                                  Stack stack)

Description copied from interface: InvocationUnit

Sets up the given stack for entering the given exception handler.

Specified by:: enterExceptionHandler in interface InvocationUnit
Overrides:: enterExceptionHandler in class SimplifiedInvocationUnit

invokeMember

public void invokeMember(Clazz clazz,
                         Method method,
                         CodeAttribute codeAttribute,
                         int offset,
                         ConstantInstruction constantInstruction,
                         Stack stack)

Description copied from interface: InvocationUnit

Updates the given stack corresponding to the execution of the given field or method reference instruction.

Specified by:: invokeMember in interface InvocationUnit
Overrides:: invokeMember in class SimplifiedInvocationUnit

getExceptionValue
```
public Value getExceptionValue(Clazz clazz,
                               ClassConstant catchClassConstant)
```
Description copied from class: SimplifiedInvocationUnit

Returns the value of the specified exception.

Specified by:

getExceptionValue in class SimplifiedInvocationUnit