程序包 proguard.evaluation.util

类 DebugPrinter

java.lang.Object

proguard.evaluation.util.DebugPrinter

所有已实现的接口:

PartialEvaluatorStateTracker

public class DebugPrinter
extends Object
implements PartialEvaluatorStateTracker

构造器概要

构造器

构造器	说明
DebugPrinter(boolean printDebugInfo, boolean printDebugResults)

方法概要

修饰符和类型	方法	说明
void	afterInstructionEvaluation(Clazz clazz, Method method, int instructionOffset, Instruction instruction, TracedVariables variablesAfter, TracedStack stackAfter, BasicBranchUnit branchUnit, InstructionOffsetValue branchTarget)	The instruction is evaluated and branching information is obtained.
void	definitiveBranch(Clazz clazz, Method method, int instructionOffset, Instruction instruction, TracedVariables variablesAfter, TracedStack stackAfter, InstructionOffsetValue branchTargets)	The instruction causes a definitive branch.
void	endSubroutine(Clazz clazz, Method method, TracedVariables variablesAfter, TracedStack stackAfter, int subroutineStart, int subroutineEnd)	The evaluation and generalization of the subroutine is done, the partial evaluator moves on.
void	evaluationResults(Clazz clazz, Method method, CodeAttribute codeAttribute, PartialEvaluator evaluator)	Partial evaluator is done evaluating the code attribute.
void	generalizeInstructionBlock(Clazz clazz, Method method, int instructionOffset, Instruction instruction, TracedVariables variablesBefore, TracedStack stackBefore, int evaluationCount)	The instruction has been seen a certain number of times and the evaluator deems it time to start generalizing the instruction.
void	generalizeSubroutine(Clazz clazz, Method method, TracedVariables startVariables, TracedStack startStack, int subroutineStart, int subroutineEnd)	The partial evaluator will start generalizing the results of the evaluated subroutine.
void	instructionBlockDone(Clazz clazz, Method method, CodeAttribute codeAttribute, TracedVariables startVariables, TracedStack startStack, int startOffset)	An instruction block has been evaluated.
void	registerAlternativeBranch(Clazz clazz, Method method, int fromInstructionOffset, Instruction fromInstruction, TracedVariables variablesAfter, TracedStack stackAfter, int branchIndex, int branchTargetCount, int offset)	The evaluator detects multiple branches need to be evaluated.
void	registerException(Clazz clazz, Method method, CodeAttribute codeAttribute, PartialEvaluator evaluator, Throwable cause)	An exception has been thrown while evaluating the current code attribute.
void	registerExceptionHandler(Clazz clazz, Method method, int startPC, int endPC, ExceptionInfo info)	Partial evaluator starts evaluating a specific exception handler.
void	registerSubroutineReturn(Clazz clazz, Method method, int returnOffset, TracedVariables returnVariables, TracedStack returnStack)	The current instruction was RET and the partial evaluator pushes the return address to the branch stack of the calling partial evaluator.
void	registerUnusedExceptionHandler(Clazz clazz, Method method, int startPC, int endPC, ExceptionInfo info)	Partial evaluator detects that the evaluation of the exception handler over a certain range is not needed.
void	skipInstructionBlock(Clazz clazz, Method method, int instructionOffset, Instruction instruction, TracedVariables variablesBefore, TracedStack stackBefore, int evaluationCount)	The instruction within this instruction block has been seen with the those variables and this stack, and thus it is not needed to evaluate this block any further.
void	startBranchCodeBlockEvaluation(List<PartialEvaluator.InstructionBlock> branchStack)	Evaluation of the first general block has been done.
void	startCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, Variables parameters)	The partial evaluator starts with the evaluation of a code block.
void	startExceptionHandlingForBlock(Clazz clazz, Method method, int startOffset, int endOffset)	Partial evaluator starts evaluating the exceptions handlers that catch over a certain instruction range.
void	startInstructionBlock(Clazz clazz, Method method, CodeAttribute codeAttribute, TracedVariables startVariables, TracedStack startStack, int startOffset)	Partial evaluator starts evaluating an instruction block, specified by an instruction range within the code attribute and the variables and stack it would start with.
void	startInstructionEvaluation(Clazz clazz, Method method, int instructionOffset, Instruction instruction, TracedVariables variablesBefore, TracedStack stackBefore, int evaluationCount)	The partial evaluator will forward the evaluation of the instruction.
void	startSubroutine(Clazz clazz, Method method, TracedVariables startVariables, TracedStack startStack, int subroutineStart, int subroutineEnd)	The current instruction was JSR or JSR_W and the partial evaluator starts with the evaluation of the subroutine.

从类继承的方法 java.lang.Object

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

构造器详细资料

DebugPrinter

public DebugPrinter(boolean printDebugInfo,
 boolean printDebugResults)

方法详细资料

startCodeAttribute

public void startCodeAttribute(Clazz clazz,
 Method method,
 CodeAttribute codeAttribute,
 Variables parameters)

从接口复制的说明: PartialEvaluatorStateTracker

The partial evaluator starts with the evaluation of a code block.

指定者:

startCodeAttribute 在接口中 PartialEvaluatorStateTracker

registerException

public void registerException(Clazz clazz,
 Method method,
 CodeAttribute codeAttribute,
 PartialEvaluator evaluator,
 Throwable cause)

从接口复制的说明: PartialEvaluatorStateTracker

An exception has been thrown while evaluating the current code attribute.

指定者:

registerException 在接口中 PartialEvaluatorStateTracker

startExceptionHandlingForBlock

public void startExceptionHandlingForBlock(Clazz clazz,
 Method method,
 int startOffset,
 int endOffset)

从接口复制的说明: PartialEvaluatorStateTracker

Partial evaluator starts evaluating the exceptions handlers that catch over a certain instruction range.

指定者:

startExceptionHandlingForBlock 在接口中 PartialEvaluatorStateTracker

registerExceptionHandler

public void registerExceptionHandler(Clazz clazz,
 Method method,
 int startPC,
 int endPC,
 ExceptionInfo info)

从接口复制的说明: PartialEvaluatorStateTracker

Partial evaluator starts evaluating a specific exception handler.

指定者:

registerExceptionHandler 在接口中 PartialEvaluatorStateTracker

registerUnusedExceptionHandler

public void registerUnusedExceptionHandler(Clazz clazz,
 Method method,
 int startPC,
 int endPC,
 ExceptionInfo info)

从接口复制的说明: PartialEvaluatorStateTracker

Partial evaluator detects that the evaluation of the exception handler over a certain range is not needed. For example when the exceptionType can not be thrown from with the instruction range.

指定者:

registerUnusedExceptionHandler 在接口中 PartialEvaluatorStateTracker

evaluationResults

public void evaluationResults(Clazz clazz,
 Method method,
 CodeAttribute codeAttribute,
 PartialEvaluator evaluator)

从接口复制的说明: PartialEvaluatorStateTracker

Partial evaluator is done evaluating the code attribute. You can extract the results straight from the evaluator.

指定者:

evaluationResults 在接口中 PartialEvaluatorStateTracker

startInstructionBlock

public void startInstructionBlock(Clazz clazz,
 Method method,
 CodeAttribute codeAttribute,
 TracedVariables startVariables,
 TracedStack startStack,
 int startOffset)

从接口复制的说明: PartialEvaluatorStateTracker

Partial evaluator starts evaluating an instruction block, specified by an instruction range within the code attribute and the variables and stack it would start with.

指定者:

startInstructionBlock 在接口中 PartialEvaluatorStateTracker

startBranchCodeBlockEvaluation

public void startBranchCodeBlockEvaluation(List<PartialEvaluator.InstructionBlock> branchStack)

从接口复制的说明: PartialEvaluatorStateTracker

Evaluation of the first general block has been done. The evaluator now starts evaluating the blocks generated by branch instructions and will do this in a stack like behaviour.

指定者:

startBranchCodeBlockEvaluation 在接口中 PartialEvaluatorStateTracker

instructionBlockDone

public void instructionBlockDone(Clazz clazz,
 Method method,
 CodeAttribute codeAttribute,
 TracedVariables startVariables,
 TracedStack startStack,
 int startOffset)

从接口复制的说明: PartialEvaluatorStateTracker

An instruction block has been evaluated.

指定者:

instructionBlockDone 在接口中 PartialEvaluatorStateTracker

skipInstructionBlock

public void skipInstructionBlock(Clazz clazz,
 Method method,
 int instructionOffset,
 Instruction instruction,
 TracedVariables variablesBefore,
 TracedStack stackBefore,
 int evaluationCount)

从接口复制的说明: PartialEvaluatorStateTracker

The instruction within this instruction block has been seen with the those variables and this stack, and thus it is not needed to evaluate this block any further.

指定者:

skipInstructionBlock 在接口中 PartialEvaluatorStateTracker

generalizeInstructionBlock

public void generalizeInstructionBlock(Clazz clazz,
 Method method,
 int instructionOffset,
 Instruction instruction,
 TracedVariables variablesBefore,
 TracedStack stackBefore,
 int evaluationCount)

从接口复制的说明: PartialEvaluatorStateTracker

The instruction has been seen a certain number of times and the evaluator deems it time to start generalizing the instruction.

指定者:

generalizeInstructionBlock 在接口中 PartialEvaluatorStateTracker

startInstructionEvaluation

public void startInstructionEvaluation(Clazz clazz,
 Method method,
 int instructionOffset,
 Instruction instruction,
 TracedVariables variablesBefore,
 TracedStack stackBefore,
 int evaluationCount)

从接口复制的说明: PartialEvaluatorStateTracker

The partial evaluator will forward the evaluation of the instruction. An exception right after this state is likely.

指定者:

startInstructionEvaluation 在接口中 PartialEvaluatorStateTracker

afterInstructionEvaluation

public void afterInstructionEvaluation(Clazz clazz,
 Method method,
 int instructionOffset,
 Instruction instruction,
 TracedVariables variablesAfter,
 TracedStack stackAfter,
 BasicBranchUnit branchUnit,
 InstructionOffsetValue branchTarget)

从接口复制的说明: PartialEvaluatorStateTracker

The instruction is evaluated and branching information is obtained.

指定者:

afterInstructionEvaluation 在接口中 PartialEvaluatorStateTracker

definitiveBranch

public void definitiveBranch(Clazz clazz,
 Method method,
 int instructionOffset,
 Instruction instruction,
 TracedVariables variablesAfter,
 TracedStack stackAfter,
 InstructionOffsetValue branchTargets)

从接口复制的说明: PartialEvaluatorStateTracker

The instruction causes a definitive branch. This means the partial evaluator discovered a jump is used and is sure what the next instruction will be. This next instruction will be evaluated next and within the same instructionBlock evaluation.

指定者:

definitiveBranch 在接口中 PartialEvaluatorStateTracker

registerAlternativeBranch

public void registerAlternativeBranch(Clazz clazz,
 Method method,
 int fromInstructionOffset,
 Instruction fromInstruction,
 TracedVariables variablesAfter,
 TracedStack stackAfter,
 int branchIndex,
 int branchTargetCount,
 int offset)

从接口复制的说明: PartialEvaluatorStateTracker

The evaluator detects multiple branches need to be evaluated. It adds these block evaluations to a stack of blocks that still need to be evaluated. After all branches have been registered, the evaluator exits the evaluation of the current instruction block.

指定者:

registerAlternativeBranch 在接口中 PartialEvaluatorStateTracker

startSubroutine

public void startSubroutine(Clazz clazz,
 Method method,
 TracedVariables startVariables,
 TracedStack startStack,
 int subroutineStart,
 int subroutineEnd)

从接口复制的说明: PartialEvaluatorStateTracker

The current instruction was JSR or JSR_W and the partial evaluator starts with the evaluation of the subroutine.

指定者:

startSubroutine 在接口中 PartialEvaluatorStateTracker

registerSubroutineReturn

public void registerSubroutineReturn(Clazz clazz,
 Method method,
 int returnOffset,
 TracedVariables returnVariables,
 TracedStack returnStack)

从接口复制的说明: PartialEvaluatorStateTracker

The current instruction was RET and the partial evaluator pushes the return address to the branch stack of the calling partial evaluator.

指定者:

registerSubroutineReturn 在接口中 PartialEvaluatorStateTracker

generalizeSubroutine

public void generalizeSubroutine(Clazz clazz,
 Method method,
 TracedVariables startVariables,
 TracedStack startStack,
 int subroutineStart,
 int subroutineEnd)

从接口复制的说明: PartialEvaluatorStateTracker

The partial evaluator will start generalizing the results of the evaluated subroutine.

指定者:

generalizeSubroutine 在接口中 PartialEvaluatorStateTracker

endSubroutine

public void endSubroutine(Clazz clazz,
 Method method,
 TracedVariables variablesAfter,
 TracedStack stackAfter,
 int subroutineStart,
 int subroutineEnd)

从接口复制的说明: PartialEvaluatorStateTracker

The evaluation and generalization of the subroutine is done, the partial evaluator moves on.

指定者:

endSubroutine 在接口中 PartialEvaluatorStateTracker