soot.jimple.toolkits.scalar.pre
Class UpSafetyAnalysis

java.lang.Object
  soot.toolkits.scalar.AbstractFlowAnalysis<N,A>
      soot.toolkits.scalar.FlowAnalysis<N,A>
          soot.toolkits.scalar.ForwardFlowAnalysis
              soot.jimple.toolkits.scalar.pre.UpSafetyAnalysis

public class UpSafetyAnalysis
extends ForwardFlowAnalysis

Performs an UpSafe-analysis on the given graph. An expression is upsafe, if the computation already has been performed on every path from START to the given program-point.

Field Summary

Fields inherited from class soot.toolkits.scalar.FlowAnalysis

filterUnitToAfterFlow, unitToAfterFlow

Fields inherited from class soot.toolkits.scalar.AbstractFlowAnalysis

filterUnitToBeforeFlow, graph, unitToBeforeFlow

Constructor Summary

UpSafetyAnalysis(DirectedGraph dg)
this constructor should not be used, and will throw a runtime-exception!

UpSafetyAnalysis(DirectedGraph dg, Map unitToGen, SideEffectTester sideEffect)
this constructor automaticly performs the UpSafety-analysis.
the result of the analysis is as usual in FlowBefore (getFlowBefore()) and FlowAfter (getFlowAfter()).

UpSafetyAnalysis(DirectedGraph dg, Map unitToGen, SideEffectTester sideEffect, BoundedFlowSet set)
this constructor automaticly performs the UpSafety-analysis.
the result of the analysis is as usual in FlowBefore (getFlowBefore()) and FlowAfter (getFlowAfter()).
As usually flowset-operations are more efficient if shared, this allows to share sets over several analyses.

Method Summary

protected void	copy(Object source, Object dest) Creates a copy of the source flow object in dest.
protected Object	entryInitialFlow() Returns the initial flow value for entry/exit graph nodes.
protected void	flowThrough(Object inValue, Object unit, Object outValue) Given the merge of the out sets, compute the in set for s (or in to out, depending on direction).
protected void	merge(Object in1, Object in2, Object out) Compute the merge of the in1 and in2 sets, putting the result into out.
protected Object	newInitialFlow() Returns the flow object corresponding to the initial values for each graph node.

Methods inherited from class soot.toolkits.scalar.ForwardFlowAnalysis

constructWorklist, doAnalysis, isForward

Methods inherited from class soot.toolkits.scalar.FlowAnalysis

constructOrderer, getFlowAfter

Methods inherited from class soot.toolkits.scalar.AbstractFlowAnalysis

getFlowBefore, merge, mergeInto, treatTrapHandlersAsEntries

Methods inherited from class java.lang.Object

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

Constructor Detail

UpSafetyAnalysis

public UpSafetyAnalysis(DirectedGraph dg)

this constructor should not be used, and will throw a runtime-exception!

UpSafetyAnalysis

public UpSafetyAnalysis(DirectedGraph dg,
                        Map unitToGen,
                        SideEffectTester sideEffect)

this constructor automaticly performs the UpSafety-analysis.
the result of the analysis is as usual in FlowBefore (getFlowBefore()) and FlowAfter (getFlowAfter()).

Parameters:

dg - a ExceptionalUnitGraph

unitToGen - the EquivalentValue of each unit.

sideEffect - the SideEffectTester that will be used to perform kills.

UpSafetyAnalysis

public UpSafetyAnalysis(DirectedGraph dg,
                        Map unitToGen,
                        SideEffectTester sideEffect,
                        BoundedFlowSet set)

this constructor automaticly performs the UpSafety-analysis.
the result of the analysis is as usual in FlowBefore (getFlowBefore()) and FlowAfter (getFlowAfter()).
As usually flowset-operations are more efficient if shared, this allows to share sets over several analyses.

Parameters:

dg - a ExceptionalUnitGraph

unitToGen - the EquivalentValue of each unit.

sideEffect - the SideEffectTester that will be used to perform kills.

set - a bounded flow-set.

Method Detail

newInitialFlow

protected Object 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

entryInitialFlow

protected Object entryInitialFlow()

Description copied from class: AbstractFlowAnalysis

Returns the initial flow value for entry/exit graph nodes.

Specified by:

entryInitialFlow in class AbstractFlowAnalysis

flowThrough

protected void flowThrough(Object inValue,
                           Object unit,
                           Object 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

merge

protected void merge(Object in1,
                     Object in2,
                     Object 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

copy

protected void copy(Object source,
                    Object dest)

Description copied from class: AbstractFlowAnalysis

Creates a copy of the source flow object in dest.

Specified by:

copy in class AbstractFlowAnalysis