com.ibm.dtfj.java
Interface JavaLocation
- public interface JavaLocation
Method Summary
Modifier and Type | Method and Description |
---|---|
|
equals(java.lang.Object obj)
|
getAddress()
Fetches the absolute address of the code which this location represents.
|
|
|
getCompilationLevel()
Get the compilation level for this location.
|
|
getFilename()
Get the source file name.
|
|
getLineNumber()
Get the line number.
|
getMethod()
Get the method which contains the point of execution.
|
|
|
hashCode()
|
|
toString()
|
Method Detail
getAddress
- ImagePointer getAddress()
- throws CorruptDataException
getLineNumber
- int getLineNumber()
- throws DataUnavailable
- CorruptDataException
Get the line number.
Returns:
the line number, if available, or throws DataUnavailable if it is not available
Line numbers are counted from 1
Throws:
DataUnavailable
- if the line number data is not available for this location getFilename
- java.lang.String getFilename()
- throws DataUnavailable
- CorruptDataException
Get the source file name.
Returns:
the name of the source file, if available, or throws DataUnavailable if it is
not available
Throws:
DataUnavailable
- if the source file name is unavailable in the core getCompilationLevel
- int getCompilationLevel()
- throws CorruptDataException
Get the compilation level for this location. This is an implementation
defined number indicating the level at which the current location was
compiled. 0 indicates interpreted. Any positive number indicates some
level of JIT compilation. Typically, higher numbers indicate more
aggressive compilation strategies
For native methods, a non-zero compilation level indicates that some level of JIT compilation has been applied to the native call (e.g. a custom native call stub). To determine if the method is native, use getMethod().getModifiers().
getMethod
- JavaMethod getMethod()
- throws CorruptDataException
Get the method which contains the point of execution.
toString
- java.lang.String toString()
Overrides:
toString
in class java.lang.Object
Returns:
A string representing the location as it would be seen in a Java stack trace
equals
- boolean equals(java.lang.Object obj)
Overrides:
equals
in class java.lang.Object
Parameters:
obj
- Returns:
True if the given object refers to the same Java Location in the image
hashCode
- int hashCode()
Overrides:
hashCode
in class java.lang.Object
null may be returned, particularly for methods with no bytecode or compiled sections (e.g. some native methods)
Although an offset into the method may be calculated using this pointer, caution should be exercised in attempting to map this offset to an offset within the original class file. Various transformations may have been applied to the bytecodes by the VM or other agents which may make the offset difficult to interpret.
For native methods, the address may be meaningless.