soot.jimple.toolkits.annotation.nullcheck

Class NullnessAnalysis

java.lang.Object

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

soot.toolkits.scalar.BranchedFlowAnalysis<Unit,A>

soot.toolkits.scalar.ForwardBranchedFlowAnalysis<NullnessAnalysis.AnalysisInfo>

soot.jimple.toolkits.annotation.nullcheck.NullnessAnalysis

public class NullnessAnalysis
extends ForwardBranchedFlowAnalysis<NullnessAnalysis.AnalysisInfo>

An intraprocedural nullness analysis that computes for each location and each value in a method if the value is (before or after that location) definitely null, definitely non-null or neither. This class replaces BranchedRefVarsAnalysis which is known to have bugs.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	NullnessAnalysis.AnalysisInfo The analysis info is a simple mapping of type Value to any of the constants BOTTOM, NON_NULL, NULL or TOP.

Field Summary

Fields

Modifier and Type	Field and Description
protected static int	BOTTOM
protected static int	NON_NULL
protected static int	NULL
protected static int	TOP
protected int	used
protected java.util.HashMap<Value,java.lang.Integer>	valueToIndex

Fields inherited from class soot.toolkits.scalar.BranchedFlowAnalysis

unitToAfterBranchFlow, unitToAfterFallFlow

Fields inherited from class soot.toolkits.scalar.AbstractFlowAnalysis

filterUnitToBeforeFlow, graph, unitToBeforeFlow

Constructor Summary

Constructors

Constructor and Description
NullnessAnalysis(UnitGraph graph) Creates a new analysis for the given graph/

Method Summary

Modifier and Type	Method and Description
protected void	copy(NullnessAnalysis.AnalysisInfo s, NullnessAnalysis.AnalysisInfo d) Creates a copy of the source flow object in dest.
protected void	flowThrough(NullnessAnalysis.AnalysisInfo in, Unit u, java.util.List<NullnessAnalysis.AnalysisInfo> fallOut, java.util.List<NullnessAnalysis.AnalysisInfo> branchOuts) Given the merge of the in sets, compute the fallOut and branchOuts set for s.
protected boolean	isAlwaysNonNull(Value v) This can be overwritten by sublasses to mark a certain value as constantly non-null.
boolean	isAlwaysNonNullBefore(Unit s, Immediate i) Returns true if the analysis could determine that i is always non-null before the statement s.
boolean	isAlwaysNullBefore(Unit s, Immediate i) Returns true if the analysis could determine that i is always null before the statement s.
protected void	merge(NullnessAnalysis.AnalysisInfo in1, NullnessAnalysis.AnalysisInfo in2, NullnessAnalysis.AnalysisInfo out) Compute the merge of the in1 and in2 sets, putting the result into out.
protected NullnessAnalysis.AnalysisInfo	newInitialFlow() Returns the flow object corresponding to the initial values for each graph node.

Methods inherited from class soot.toolkits.scalar.ForwardBranchedFlowAnalysis

doAnalysis, isForward

Methods inherited from class soot.toolkits.scalar.BranchedFlowAnalysis

getBranchFlowAfter, getFallFlowAfter

Methods inherited from class soot.toolkits.scalar.AbstractFlowAnalysis

entryInitialFlow, getFlowBefore, merge, mergeInto, treatTrapHandlersAsEntries

Methods inherited from class java.lang.Object

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

Field Detail

BOTTOM

protected static final int BOTTOM

See Also:

Constant Field Values

NULL

protected static final int NULL

See Also:

Constant Field Values

NON_NULL

protected static final int NON_NULL

See Also:

Constant Field Values

TOP

protected static final int TOP

See Also:

Constant Field Values

valueToIndex

protected final java.util.HashMap<Value,java.lang.Integer> valueToIndex

used

protected int used

Constructor Detail

NullnessAnalysis

public NullnessAnalysis(UnitGraph graph)

Creates a new analysis for the given graph/

Parameters:

graph - any unit graph

Method Detail

flowThrough

protected void flowThrough(NullnessAnalysis.AnalysisInfo in,
                           Unit u,
                           java.util.List<NullnessAnalysis.AnalysisInfo> fallOut,
                           java.util.List<NullnessAnalysis.AnalysisInfo> branchOuts)

Given the merge of the in sets, compute the fallOut and branchOuts set for s.

Specified by:

flowThrough in class BranchedFlowAnalysis<Unit,NullnessAnalysis.AnalysisInfo>

isAlwaysNonNull

protected boolean isAlwaysNonNull(Value v)

This can be overwritten by sublasses to mark a certain value as constantly non-null.

Parameters:

v - any value

Returns:

true if it is known that this value (e.g. a method return value) is never null

copy

protected void copy(NullnessAnalysis.AnalysisInfo s,
                    NullnessAnalysis.AnalysisInfo d)

Creates a copy of the source flow object in dest.

Specified by:

copy in class AbstractFlowAnalysis<Unit,NullnessAnalysis.AnalysisInfo>

merge

protected void merge(NullnessAnalysis.AnalysisInfo in1,
                     NullnessAnalysis.AnalysisInfo in2,
                     NullnessAnalysis.AnalysisInfo out)

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,NullnessAnalysis.AnalysisInfo>

newInitialFlow

protected NullnessAnalysis.AnalysisInfo newInitialFlow()

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

Specified by:

newInitialFlow in class AbstractFlowAnalysis<Unit,NullnessAnalysis.AnalysisInfo>

isAlwaysNullBefore

public boolean isAlwaysNullBefore(Unit s,
                                  Immediate i)

Returns true if the analysis could determine that i is always null before the statement s.

Parameters:

s - a statement of the respective body

i - a local or constant of that body

Returns:

true if i is always null right before this statement

isAlwaysNonNullBefore

public boolean isAlwaysNonNullBefore(Unit s,
                                     Immediate i)

Returns true if the analysis could determine that i is always non-null before the statement s.

Parameters:

s - a statement of the respective body

i - a local of that body

Returns:

true if i is always non-null right before this statement