Module openj9.dtfj
Package com.ibm.dtfj.java

Interface JavaMonitor

All Known Implementing Classes:
DTFJJavaObjectMonitor, DTFJJavaSystemMonitor, JavaMonitor, JCJavaMonitor, PHDCorruptJavaMonitor, PHDJavaMonitor
public interface JavaMonitor
Represents a Java monitor (either an object monitor or a raw monitor).

  • Method Summary

    Modifier and Type
    Method
    Description
    boolean
    equals(Object obj)
    Compares the argument to the receiver, and answers true if they represent the same object using a class specific comparison.
    Iterator
    getEnterWaiters()
    Get the set of threads waiting to enter the monitor
    ImagePointer
    getID()
    Get the identifier for this monitor
    String
    getName()
    Note that the name of a JavaMonitor is not necessarily meaningful but is provided here as it is usually present in the running VM.
    Iterator
    getNotifyWaiters()
    Get the set of threads waiting to be notified on the monitor (in the Object.wait method)
    JavaObject
    getObject()
    Get the object associated with this monitor.
    JavaThread
    getOwner()
    Get the thread which currently owns the monitor
    int
    hashCode()
    Answers an integer hash code for the receiver.

  • Method Details

    • getObject

      JavaObject getObject()
      Get the object associated with this monitor.
      Returns:
      the object associated with this monitor, or null if this is a raw monitor or a valid object could not be retrieved.

    • getName

      String getName() throws CorruptDataException
      Note that the name of a JavaMonitor is not necessarily meaningful but is provided here as it is usually present in the running VM. If there is no name for the monitor a synthetic name will be created by DTFJ.
      Returns:
      the name of the monitor (never null)
      Throws:
      CorruptDataException

    • getOwner

      JavaThread getOwner() throws CorruptDataException
      Get the thread which currently owns the monitor
      Returns:
      the owner of the monitor, or null if the monitor is unowned
      Throws:
      CorruptDataException

    • getEnterWaiters

      Iterator getEnterWaiters()
      Get the set of threads waiting to enter the monitor
      Returns:
      an iterator over the collection of threads waiting to enter this monitor
      See Also:

    • getNotifyWaiters

      Iterator getNotifyWaiters()
      Get the set of threads waiting to be notified on the monitor (in the Object.wait method)
      Returns:
      an iterator over the collection of threads waiting to be notified on this monitor
      See Also:

    • getID

      ImagePointer getID()
      Get the identifier for this monitor
      Returns:
      The pointer which uniquely identifies this monitor in memory.

    • equals

      boolean equals(Object obj)
      Description copied from class: java.lang.Object
      Compares the argument to the receiver, and answers true if they represent the same object using a class specific comparison. The implementation in Object answers true only if the argument is the exact same object as the receiver (==).
      Overrides:
      equals in class Object
      Parameters:
      obj -
      Returns:
      True if the given object refers to the same Java Monitor in the image
      See Also:

    • hashCode

      int hashCode()
      Description copied from class: java.lang.Object
      Answers an integer hash code for the receiver. Any two objects which answer true when passed to .equals must answer the same value for this method.
      Overrides:
      hashCode in class Object
      Returns:
      the receiver's hash.
      See Also: