Class TypeQualifierDataflowAnalysis

java.lang.Object

edu.umd.cs.findbugs.ba.BasicAbstractDataflowAnalysis<TypeQualifierValueSet>

edu.umd.cs.findbugs.ba.AbstractDataflowAnalysis<TypeQualifierValueSet>

edu.umd.cs.findbugs.ba.jsr305.TypeQualifierDataflowAnalysis

All Implemented Interfaces:

DataflowAnalysis<TypeQualifierValueSet>

Direct Known Subclasses:

BackwardTypeQualifierDataflowAnalysis, ForwardTypeQualifierDataflowAnalysis

public abstract class TypeQualifierDataflowAnalysis
extends AbstractDataflowAnalysis<TypeQualifierValueSet>

Abstract base class for type qualifier dataflow analyses.

Field Summary

Fields

Modifier and Type	Field	Description
protected final CFG	cfg
protected final org.apache.bcel.generic.ConstantPoolGen	cpg
(package private) static final boolean	DEBUG_VERBOSE
private final Map<Location, Set<SourceSinkInfo>>	sourceSinkMap
protected final TypeQualifierValue<?>	typeQualifierValue
protected final ValueNumberDataflow	vnaDataflow
protected final XMethod	xmethod

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	TypeQualifierDataflowAnalysis(XMethod xmethod, CFG cfg, ValueNumberDataflow vnaDataflow, org.apache.bcel.generic.ConstantPoolGen cpg, TypeQualifierValue<?> typeQualifierValue)	Constructor.

Method Summary

Modifier and Type	Method	Description
void	copy(TypeQualifierValueSet source, TypeQualifierValueSet dest)	Copy dataflow facts.
TypeQualifierValueSet	createFact()	Create empty (uninitialized) dataflow facts for one program point.
void	edgeTransfer(Edge edge, TypeQualifierValueSet fact)	Edge transfer function.
Set<SourceSinkInfo>	getSourceSinkInfoSet(Location location)	Get the set of SourceSinkInfo objects representing sources/sinks at a given Location.
void	initEntryFact(TypeQualifierValueSet result)	Initialize the "entry" fact for the graph.
boolean	isFactValid(TypeQualifierValueSet fact)	Determine whether the given fact is valid (neither top nor bottom).
(package private) static boolean	isIdentifyFunctionForTypeQualifiers(XMethod m)
boolean	isTop(TypeQualifierValueSet fact)	Is the given fact the top value.
void	makeFactTop(TypeQualifierValueSet fact)	Make given fact the top value.
void	meetInto(TypeQualifierValueSet fact, Edge edge, TypeQualifierValueSet result)	Meet a dataflow fact associated with an incoming edge into another fact.
(package private) static String	primitiveType(String simpleClass)
protected abstract void	propagateAcrossPhiNode(TypeQualifierValueSet fact, ValueNumber sourceVN, ValueNumber targetVN)
protected void	registerSourceSink(SourceSinkInfo sourceSinkInfo)
abstract void	registerSourceSinkLocations()	This method must be called before the dataflow analysis is executed.
boolean	same(TypeQualifierValueSet fact1, TypeQualifierValueSet fact2)	Are given dataflow facts the same?
void	transferInstruction(org.apache.bcel.generic.InstructionHandle handle, BasicBlock basicBlock, TypeQualifierValueSet fact)	Transfer function for a single instruction.

Methods inherited from class AbstractDataflowAnalysis

getFactAfterLocation, getFactAtLocation, transfer

Methods inherited from class BasicAbstractDataflowAnalysis

factToString, finishIteration, getFactOnEdge, getLastUpdateTimestamp, getResultFact, getStartFact, resultFactIterator, setLastUpdateTimestamp, startIteration

Methods inherited from class Object

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

Methods inherited from interface DataflowAnalysis

getBlockOrder, isForwards

Field Details

DEBUG_VERBOSE

static final boolean DEBUG_VERBOSE

xmethod

protected final XMethod xmethod

cfg

protected final CFG cfg

vnaDataflow

protected final ValueNumberDataflow vnaDataflow

typeQualifierValue

protected final TypeQualifierValue<?> typeQualifierValue

cpg

protected final org.apache.bcel.generic.ConstantPoolGen cpg

sourceSinkMap

private final Map<Location, Set<SourceSinkInfo>> sourceSinkMap

Constructor Details

TypeQualifierDataflowAnalysis

protected TypeQualifierDataflowAnalysis(XMethod xmethod,
 CFG cfg,
 ValueNumberDataflow vnaDataflow,
 org.apache.bcel.generic.ConstantPoolGen cpg,
 TypeQualifierValue<?> typeQualifierValue)

Constructor.

Parameters:

xmethod - XMethod object containing information about the method being analyzed

cfg - the control-flow graph (CFG) of the method being analyzed

vnaDataflow - ValueNumberDataflow for the method

cpg - the constant pool being built up

typeQualifierValue - the TypeQualifierValue we want the dataflow analysis to check

Method Details

primitiveType

static String primitiveType(String simpleClass)

isIdentifyFunctionForTypeQualifiers

static boolean isIdentifyFunctionForTypeQualifiers(XMethod m)

initEntryFact

public void initEntryFact(TypeQualifierValueSet result)
                   throws DataflowAnalysisException

Description copied from interface: DataflowAnalysis

Initialize the "entry" fact for the graph.

Throws:

DataflowAnalysisException

isFactValid

public boolean isFactValid(TypeQualifierValueSet fact)

Description copied from class: AbstractDataflowAnalysis

Determine whether the given fact is valid (neither top nor bottom).

Specified by:

isFactValid in class AbstractDataflowAnalysis<TypeQualifierValueSet>

copy

public void copy(TypeQualifierValueSet source,
 TypeQualifierValueSet dest)

Description copied from interface: DataflowAnalysis

Copy dataflow facts.

createFact

public TypeQualifierValueSet createFact()

Description copied from interface: DataflowAnalysis

Create empty (uninitialized) dataflow facts for one program point. A valid value will be copied into it before it is used.

isTop

public boolean isTop(TypeQualifierValueSet fact)

Description copied from interface: DataflowAnalysis

Is the given fact the top value.

makeFactTop

public void makeFactTop(TypeQualifierValueSet fact)

Description copied from interface: DataflowAnalysis

Make given fact the top value.

meetInto

public void meetInto(TypeQualifierValueSet fact,
 Edge edge,
 TypeQualifierValueSet result)
              throws DataflowAnalysisException

Description copied from interface: DataflowAnalysis

Meet a dataflow fact associated with an incoming edge into another fact. This is used to determine the start fact for a basic block.

Parameters:

fact - the predecessor fact (incoming edge)

edge - the edge from the predecessor

result - the result fact

Throws:

DataflowAnalysisException

same

public boolean same(TypeQualifierValueSet fact1,
 TypeQualifierValueSet fact2)

Description copied from interface: DataflowAnalysis

Are given dataflow facts the same?

edgeTransfer

public void edgeTransfer(Edge edge,
 TypeQualifierValueSet fact)
                  throws DataflowAnalysisException

Description copied from interface: DataflowAnalysis

Edge transfer function. Modify the given fact that is true on the (logical) edge source to modify it so that it is true at the (logical) edge target.

A do-nothing implementation is legal, and appropriate for analyses where branches are not significant.

Specified by:

edgeTransfer in interface DataflowAnalysis<TypeQualifierValueSet>

Overrides:

edgeTransfer in class BasicAbstractDataflowAnalysis<TypeQualifierValueSet>

Parameters:

edge - the Edge

fact - a dataflow fact

Throws:

DataflowAnalysisException

propagateAcrossPhiNode

protected abstract void propagateAcrossPhiNode(TypeQualifierValueSet fact,
 ValueNumber sourceVN,
 ValueNumber targetVN)

registerSourceSinkLocations

public abstract void registerSourceSinkLocations()
                                          throws DataflowAnalysisException

This method must be called before the dataflow analysis is executed.

Throws:

DataflowAnalysisException

registerSourceSink

protected void registerSourceSink(SourceSinkInfo sourceSinkInfo)

getSourceSinkInfoSet

public Set<SourceSinkInfo> getSourceSinkInfoSet(Location location)

Get the set of SourceSinkInfo objects representing sources/sinks at a given Location.

Parameters:

location - a Location

Returns:

Set of SourceSinkInfo objects representing sources/sinks at the Location

transferInstruction

public void transferInstruction(org.apache.bcel.generic.InstructionHandle handle,
 BasicBlock basicBlock,
 TypeQualifierValueSet fact)
                         throws DataflowAnalysisException

Description copied from class: AbstractDataflowAnalysis

Transfer function for a single instruction.

Specified by:

transferInstruction in class AbstractDataflowAnalysis<TypeQualifierValueSet>

Parameters:

handle - the instruction

basicBlock - the BasicBlock containing the instruction; needed to disambiguate instructions in inlined JSR subroutines

fact - which should be modified based on the instruction

Throws:

DataflowAnalysisException