soot.jimple.toolkits.annotation.purity

Class PurityIntraproceduralAnalysis

java.lang.Object

soot.toolkits.scalar.AbstractFlowAnalysis<N,A>

soot.toolkits.scalar.FlowAnalysis<N,A>

soot.toolkits.scalar.ForwardFlowAnalysis<Unit,PurityGraphBox>

soot.jimple.toolkits.annotation.purity.PurityIntraproceduralAnalysis

public class PurityIntraproceduralAnalysis
extends ForwardFlowAnalysis<Unit,PurityGraphBox>

Intra-procedural purity-graph analysis. You must pass an AbstractInterproceduralAnalysis object so that the intraprocedural part can resolve the effect of method calls.

Nested Class Summary

Nested classes/interfaces inherited from class soot.toolkits.scalar.FlowAnalysis

FlowAnalysis.Flow

Field Summary

Fields inherited from class soot.toolkits.scalar.FlowAnalysis

filterUnitToAfterFlow, unitToAfterFlow

Fields inherited from class soot.toolkits.scalar.AbstractFlowAnalysis

filterUnitToBeforeFlow, graph, unitToBeforeFlow

Method Summary

Modifier and Type	Method and Description
protected void	copy(PurityGraphBox source, PurityGraphBox dest) Creates a copy of the source flow object in dest.
void	copyResult(PurityGraphBox dst) Put into dst the purity graph obtained by merging all purity graphs at the method return.
void	drawAsOneDot(String prefix, String name) Draw the result of the intra-procedural analysis as one big dot file, named className.methodName.dot, containing one purity graph for each statement in the method.
protected PurityGraphBox	entryInitialFlow() Returns the initial flow value for entry/exit graph nodes.
protected void	flowThrough(PurityGraphBox inValue, Unit unit, PurityGraphBox outValue) Given the merge of the out sets, compute the in set for s (or in to out, depending on direction).
protected void	merge(PurityGraphBox in1, PurityGraphBox in2, PurityGraphBox out) Compute the merge of the in1 and in2 sets, putting the result into out.
protected PurityGraphBox	newInitialFlow() Returns the flow object corresponding to the initial values for each graph node.

Methods inherited from class soot.toolkits.scalar.ForwardFlowAnalysis

doAnalysis, isForward

Methods inherited from class soot.toolkits.scalar.FlowAnalysis

copyFreshToExisting, getFlow, getFlowAfter, getFlowBefore, omissible

Methods inherited from class soot.toolkits.scalar.AbstractFlowAnalysis

merge, mergeInto, treatTrapHandlersAsEntries

Methods inherited from class java.lang.Object

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

Method Detail

newInitialFlow

protected PurityGraphBox newInitialFlow()

Description copied from class: AbstractFlowAnalysis

Returns the flow object corresponding to the initial values for each graph node.

Specified by:

newInitialFlow in class AbstractFlowAnalysis<Unit,PurityGraphBox>

entryInitialFlow

protected PurityGraphBox entryInitialFlow()

Description copied from class: AbstractFlowAnalysis

Returns the initial flow value for entry/exit graph nodes. This is equal to AbstractFlowAnalysis.newInitialFlow()

Overrides:

entryInitialFlow in class AbstractFlowAnalysis<Unit,PurityGraphBox>

merge

protected void merge(PurityGraphBox in1,
                     PurityGraphBox in2,
                     PurityGraphBox out)

Description copied from class: AbstractFlowAnalysis

Compute the merge of the in1 and in2 sets, putting the result into out. The behavior of this function depends on the implementation ( it may be necessary to check whether in1 and in2 are equal or aliased ). Used by the doAnalysis method.

Specified by:

merge in class AbstractFlowAnalysis<Unit,PurityGraphBox>

copy

protected void copy(PurityGraphBox source,
                    PurityGraphBox dest)

Description copied from class: AbstractFlowAnalysis

Creates a copy of the source flow object in dest.

Specified by:

copy in class AbstractFlowAnalysis<Unit,PurityGraphBox>

flowThrough

protected void flowThrough(PurityGraphBox inValue,
                           Unit unit,
                           PurityGraphBox outValue)

Description copied from class: FlowAnalysis

Given the merge of the out sets, compute the in set for s (or in to out, depending on direction). This function often causes confusion, because the same interface is used for both forward and backward flow analyses. The first parameter is always the argument to the flow function (i.e. it is the "in" set in a forward analysis and the "out" set in a backward analysis), and the third parameter is always the result of the flow function (i.e. it is the "out" set in a forward analysis and the "in" set in a backward analysis).

Specified by:

flowThrough in class FlowAnalysis<Unit,PurityGraphBox>

Parameters:

inValue - the input flow

unit - the current node

outValue - the returned flow

drawAsOneDot

public void drawAsOneDot(String prefix,
                         String name)

Draw the result of the intra-procedural analysis as one big dot file, named className.methodName.dot, containing one purity graph for each statement in the method.

Parameters:

prefix -

name -

copyResult

public void copyResult(PurityGraphBox dst)

Put into dst the purity graph obtained by merging all purity graphs at the method return. It is a valid summary that can be used in methodCall if you do interprocedural analysis.

Parameters:

dst -