Class FactoryBypassInterpreter

java.lang.Object

com.ibm.wala.analysis.reflection.AbstractReflectionInterpreter

com.ibm.wala.analysis.reflection.FactoryBypassInterpreter

All Implemented Interfaces:

CHAContextInterpreter, RTAContextInterpreter, SSAContextInterpreter

public class FactoryBypassInterpreter
extends AbstractReflectionInterpreter

Logic to interpret "factory" methods in context.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected class	FactoryBypassInterpreter.SpecializedFactoryMethod

Nested classes/interfaces inherited from class AbstractReflectionInterpreter

AbstractReflectionInterpreter.IgnoreSerializableWarning, AbstractReflectionInterpreter.ManySubtypesWarning, AbstractReflectionInterpreter.NoSubtypesWarning, AbstractReflectionInterpreter.SpecializedMethod

Modifier and Type	Class	Description
protected static class	AbstractReflectionInterpreter.IgnoreSerializableWarning	A warning when we find flow of a factory allocation to a cast to Serializable
protected static class	AbstractReflectionInterpreter.ManySubtypesWarning	A warning when we expect excessive pollution from a factory method
protected static class	AbstractReflectionInterpreter.NoSubtypesWarning	A warning when we fail to find subtypes for a factory method
protected class	AbstractReflectionInterpreter.SpecializedMethod

Field Summary

Fields inherited from class AbstractReflectionInterpreter

cache, CONE_BOUND, DEBUG, indexLocal, options, typeIndexMap

Modifier and Type	Field	Description
protected IAnalysisCacheView	cache	cache of analysis information
protected static final int	CONE_BOUND
protected static final boolean	DEBUG
protected int	indexLocal
protected AnalysisOptions	options	Governing analysis options
protected final Map<TypeReference, Integer>	typeIndexMap

Constructor Summary

Constructors

Constructor	Description
FactoryBypassInterpreter(AnalysisOptions options, IAnalysisCacheView iAnalysisCacheView)

Method Summary

Modifier and Type	Method	Description
Set<TypeReference>	getCaughtExceptions(CGNode node)
ControlFlowGraph<SSAInstruction, ISSABasicBlock>	getCFG(CGNode N)
DefUse	getDU(CGNode node)
Iterator<SSAInstruction>	getInvokeStatements(CGNode node)
IR	getIR(CGNode node)
IRView	getIRView(CGNode node)
int	getNumberOfStatements(CGNode node)
boolean	hasObjectArrayLoad(CGNode node)
boolean	hasObjectArrayStore(CGNode node)
Iterator<CallSiteReference>	iterateCallSites(CGNode node)
Iterator<TypeReference>	iterateCastTypes(CGNode node)
Iterator<FieldReference>	iterateFieldsRead(CGNode node)
Iterator<FieldReference>	iterateFieldsWritten(CGNode node)
Iterator<NewSiteReference>	iterateNewSites(CGNode node)
boolean	recordFactoryType(CGNode node, IClass klass)	record that the "factory" method of a node should be interpreted to allocate a particular class.
boolean	recordType(IClassHierarchy cha, Context context, TypeReference type)
boolean	understands(CGNode node)	Does this object understand the given method? The caller had better check this before inquiring on other properties.

Methods inherited from class AbstractReflectionInterpreter

getCallSiteForType, getExceptionsForType, getLocalForType, getNewSiteForType, typeRef2TypeAbstraction

Modifier and Type	Method	Description
protected int	getCallSiteForType(TypeReference T)
protected int	getExceptionsForType(TypeReference T)
protected int	getLocalForType(TypeReference T)
protected int	getNewSiteForType(TypeReference T)
protected TypeAbstraction	typeRef2TypeAbstraction(IClassHierarchy cha, TypeReference type)

Methods inherited from class Object

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

Constructor Details

FactoryBypassInterpreter

public FactoryBypassInterpreter(AnalysisOptions options,
 IAnalysisCacheView iAnalysisCacheView)

Parameters:

options - governing analysis options

Method Details

getIR

public IR getIR(CGNode node)

Returns:

the IR that models the method context, or null if it's an unmodelled native method

getIRView

public IRView getIRView(CGNode node)

getNumberOfStatements

public int getNumberOfStatements(CGNode node)

Returns:

the number of the statements in the IR, or -1 if it's an unmodelled native method.

See Also:

• SSAContextInterpreter.getNumberOfStatements(com.ibm.wala.ipa.callgraph.CGNode)

understands

public boolean understands(CGNode node)

Description copied from interface: CHAContextInterpreter

Does this object understand the given method? The caller had better check this before inquiring on other properties.

See Also:

• CHAContextInterpreter.understands(CGNode)

iterateNewSites

public Iterator<NewSiteReference> iterateNewSites(CGNode node)

Returns:

an Iterator of the types that may be allocated by a given method in a given context.

getInvokeStatements

public Iterator<SSAInstruction> getInvokeStatements(CGNode node)

iterateCallSites

public Iterator<CallSiteReference> iterateCallSites(CGNode node)

Returns:

an Iterator of the call statements that may execute in a given method for a given context

recordType

public boolean recordType(IClassHierarchy cha,
 Context context,
 TypeReference type)

recordFactoryType

public boolean recordFactoryType(CGNode node,
 IClass klass)

Description copied from interface: RTAContextInterpreter

record that the "factory" method of a node should be interpreted to allocate a particular class.

TODO: this is a little ugly, is there a better place to move this?

Returns:

true iff a NEW type was recorded, false if the type was previously recorded.

See Also:

• RTAContextInterpreter.recordFactoryType(com.ibm.wala.ipa.callgraph.CGNode, com.ibm.wala.classLoader.IClass)

iterateFieldsRead

public Iterator<FieldReference> iterateFieldsRead(CGNode node)

Returns:

iterator of FieldReference

iterateFieldsWritten

public Iterator<FieldReference> iterateFieldsWritten(CGNode node)

Returns:

iterator of FieldReference

getCaughtExceptions

public Set<TypeReference> getCaughtExceptions(CGNode node)

hasObjectArrayLoad

public boolean hasObjectArrayLoad(CGNode node)

hasObjectArrayStore

public boolean hasObjectArrayStore(CGNode node)

iterateCastTypes

public Iterator<TypeReference> iterateCastTypes(CGNode node)

getCFG

public ControlFlowGraph<SSAInstruction, ISSABasicBlock> getCFG(CGNode N)

See Also:

• SSAContextInterpreter.getCFG(com.ibm.wala.ipa.callgraph.CGNode)

getDU

public DefUse getDU(CGNode node)

Returns:

DefUse for the IR that models the method context, or null if it's an unmodelled native method