com.oracle.objectfile.debugentry

Class Range

java.lang.Object

com.oracle.objectfile.debugentry.Range

public class Range
extends Object

Details of a specific address range in a compiled method either a primary range identifying a whole compiled method or a sub-range identifying a sub-sequence of the compiled instructions that may derive from top level or inlined code. Each sub-range is linked with its caller, (which may be the primary range) and its callees, forming a call tree. Subranges are either leaf nodes with no children or call nodes which have children.

• A leaf node at the top level (depth 0) records the start and extent of a sequence of compiled code derived from the top level method. The leaf node reports itself as belonging to the top level method.
• A leaf node at depth N records the start and extent of a sequence of compiled code derived from a leaf inlined method at a call depth of N. The leaf node reports itself as belonging to the leaf method.
• A call node at level 0 records the start and extent of a sequence of compiled code that includes all compiled code derived from a top level call that has been inlined. All child nodes of the call node (direct or indirect) should model ranges that lie within the parent range. The call node reports itself as belonging to the top level method and its file and line information identify the location of the call.
• A call node at level N records the start and extent of a sequence of compiled code that includes all compiled code derived from an inline call at depth N. All child nodes of the call node (direct or indirect) should model ranges that lie within the parent range. The call node reports itself as belonging to the caller method at depth N and its file and line information identify the location of the call.
  Ranges also record the location of local and parameter values that are valid for the range's extent. Each value maps to a corresponding parameter or local variable attached to the range's method. So, a leaf or call node at level 0 records local and parameter values for separate sub-extents of the top level method while a leaf or call node at level N+1 records local and parameter values for separate sub-extents of an inline called method whose full extent is represented by the parent call range at level N.

Constructor Summary

Constructors

Constructor and Description
Range(StringTable stringTable, MethodEntry methodEntry, int lo, int hi, int line)
Range(StringTable stringTable, MethodEntry methodEntry, int lo, int hi, int line, Range primary, boolean isTopLevel, Range caller)

Method Summary

Modifier and Type	Method and Description
void	addVarRanges(Range subRange, HashMap<DebugInfoProvider.DebugLocalInfo,List<Range>> varRangeMap)
boolean	contains(Range other)
Range	getCaller()
String	getClassName()
int	getDepth()
FileEntry	getFileEntry()
int	getFileIndex()
String	getFileName()
Range	getFirstCallee()
String	getFullMethodName()
String	getFullMethodNameWithParams()
int	getHi()
int	getLine()
int	getLo()
DebugInfoProvider.DebugLocalInfo	getLocal(int i)
DebugInfoProvider.DebugLocalValueInfo	getLocalValue(int i)
int	getLocalValueCount()
MethodEntry	getMethodEntry()
String	getMethodName()
int	getModifiers()
Range	getPrimary()
Range	getSiblingCallee()
String	getSymbolName()
HashMap<DebugInfoProvider.DebugLocalInfo,List<Range>>	getVarRangeMap()
boolean	includesInlineRanges()
boolean	isDeoptTarget()
boolean	isLeaf()
boolean	isPrimary()
DebugInfoProvider.DebugLocalValueInfo	lookupValue(DebugInfoProvider.DebugLocalInfo local)
void	setLocalValueInfo(DebugInfoProvider.DebugLocalValueInfo[] localValueInfos)
String	toString()
HashMap<DebugInfoProvider.DebugLocalInfo,List<Range>>	updateVarRangeMap(HashMap<DebugInfoProvider.DebugLocalInfo,List<Range>> varRangeMap)

Methods inherited from class java.lang.Object

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

Constructor Detail

Range

public Range(StringTable stringTable,
             MethodEntry methodEntry,
             int lo,
             int hi,
             int line)

Range

public Range(StringTable stringTable,
             MethodEntry methodEntry,
             int lo,
             int hi,
             int line,
             Range primary,
             boolean isTopLevel,
             Range caller)

Method Detail

getLocalValueCount

public int getLocalValueCount()

getLocalValue

public DebugInfoProvider.DebugLocalValueInfo getLocalValue(int i)

getLocal

public DebugInfoProvider.DebugLocalInfo getLocal(int i)

contains

public boolean contains(Range other)

isPrimary

public boolean isPrimary()

getPrimary

public Range getPrimary()

getClassName

public String getClassName()

getMethodName

public String getMethodName()

getSymbolName

public String getSymbolName()

getHi

public int getHi()

getLo

public int getLo()

getLine

public int getLine()

getFullMethodName

public String getFullMethodName()

getFullMethodNameWithParams

public String getFullMethodNameWithParams()

isDeoptTarget

public boolean isDeoptTarget()

getFileEntry

public FileEntry getFileEntry()

getFileIndex

public int getFileIndex()

getModifiers

public int getModifiers()

toString

public String toString()

Overrides:

toString in class Object

getFileName

public String getFileName()

getMethodEntry

public MethodEntry getMethodEntry()

getCaller

public Range getCaller()

getFirstCallee

public Range getFirstCallee()

getSiblingCallee

public Range getSiblingCallee()

isLeaf

public boolean isLeaf()

includesInlineRanges

public boolean includesInlineRanges()

getDepth

public int getDepth()

setLocalValueInfo

public void setLocalValueInfo(DebugInfoProvider.DebugLocalValueInfo[] localValueInfos)

getVarRangeMap

public HashMap<DebugInfoProvider.DebugLocalInfo,List<Range>> getVarRangeMap()

updateVarRangeMap

public HashMap<DebugInfoProvider.DebugLocalInfo,List<Range>> updateVarRangeMap(HashMap<DebugInfoProvider.DebugLocalInfo,List<Range>> varRangeMap)

addVarRanges

public void addVarRanges(Range subRange,
                         HashMap<DebugInfoProvider.DebugLocalInfo,List<Range>> varRangeMap)

lookupValue

public DebugInfoProvider.DebugLocalValueInfo lookupValue(DebugInfoProvider.DebugLocalInfo local)