com.ibm.wala.ipa.callgraph

Interface ClassTargetSelector

All Known Implementing Classes:

BypassClassTargetSelector, ClassHierarchyClassTargetSelector

public interface ClassTargetSelector

This interface represents policies for selecting a class to allocate at a given new site. The most obvious such policy would be to look at the relevant class hierarchy and lookup the appropriate class based on the type reference at the new site. However, other policies are possible for purposes such as providing an abstraction of unanalyzed libraries or specialized J2EE functionality.

Such policies are consulted by the different analysis mechanisms, both the flow-based and non-flow algorithms. The current mechanism is that the policy object are registered with the AnalysisOptions object, and all analyses that need to analyze allocations ask that object for the class selector to use.

In general, for specialized selectors, it is good practice to build selectors that handle the special case of interest, and otherwise delegate to a child selector. When registering with the AnalysisOptions object, make the child selector be whatever the options object had before.

Method Summary

Modifier and Type	Method and Description
IClass	getAllocatedTarget(CGNode caller, NewSiteReference site) Given a calling node and a new site, return the type to be allocated.

Method Detail

getAllocatedTarget

IClass getAllocatedTarget(CGNode caller,
                          NewSiteReference site)

Given a calling node and a new site, return the type to be allocated.

Parameters:

caller - the GCNode in the call graph containing the new site.

site - the new site reference of the new site.

Returns:

the class to be allocated.