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:

• JavaThread
• CorruptData

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:

• JavaThread
• CorruptData

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:

• Object.hashCode()

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:

• Object.equals(java.lang.Object)