Class JCJavaLocation

java.lang.Object
com.ibm.dtfj.java.javacore.JCJavaLocation
All Implemented Interfaces:
JavaLocation

public class JCJavaLocation extends Object implements JavaLocation
  • Constructor Details

  • Method Details

    • getAddress

      public ImagePointer getAddress() throws CorruptDataException
      Description copied from interface: JavaLocation
      Fetches the absolute address of the code which this location represents. This pointer will be contained within one of the segments returned by getBytecodeSections() or getCompiledSections() of the method returned by getMethod().

      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.

      Specified by:
      getAddress in interface JavaLocation
      Returns:
      the address in memory of the managed code
      Throws:
      CorruptDataException
    • setAddress

      public void setAddress(ImagePointer address)
      NON-DTFJ
      Parameters:
      address -
    • getCompilationLevel

      public int getCompilationLevel() throws CorruptDataException
      Description copied from interface: JavaLocation
      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().

      Specified by:
      getCompilationLevel in interface JavaLocation
      Returns:
      the compilation level
      Throws:
      CorruptDataException
    • setCompilation

      public void setCompilation(String compilationLevel)
      NON-DTFJ
      Parameters:
      compilationLevel -
    • getFilename

      public String getFilename() throws DataUnavailable, CorruptDataException
      Description copied from interface: JavaLocation
      Get the source file name.
      Specified by:
      getFilename in interface JavaLocation
      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
      CorruptDataException
    • setFilename

      public void setFilename(String fileName)
      NON-DTFJ
      Parameters:
      fileName -
    • getLineNumber

      public int getLineNumber() throws DataUnavailable, CorruptDataException
      Description copied from interface: JavaLocation
      Get the line number.
      Specified by:
      getLineNumber in interface JavaLocation
      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
      CorruptDataException
    • setLineNumber

      public void setLineNumber(int lineNumber)
      NON-DTFJ
      Parameters:
      lineNumber -
    • getMethod

      public JavaMethod getMethod() throws CorruptDataException
      Description copied from interface: JavaLocation
      Get the method which contains the point of execution.
      Specified by:
      getMethod in interface JavaLocation
      Returns:
      the method which contains the point of execution
      Throws:
      CorruptDataException
    • toString

      public String toString()
      Description copied from class: java.lang.Object
      Answers a string containing a concise, human-readable description of the receiver.
      Specified by:
      toString in interface JavaLocation
      Overrides:
      toString in class Object
      Returns:
      A string representing the location as it would be seen in a Java stack trace