Class JavaMonitor

java.lang.Object

com.ibm.dtfj.java.j9.JavaMonitor

All Implemented Interfaces:

JavaMonitor

public class JavaMonitor
extends Object
implements JavaMonitor

Constructor Summary

Constructors

Constructor	Description
JavaMonitor(JavaRuntime runtime, ImagePointer pointer, String name, ImagePointer encompassingObjectAddress, long owningThread)

Method Summary

Modifier and Type	Method	Description
void	addBlockedThread(JavaThread thread)
void	addWaitingThread(JavaThread thread)
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.

Methods declared in class java.lang.Object

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

Constructor Details

JavaMonitor

public JavaMonitor(JavaRuntime runtime,
 ImagePointer pointer,
 String name,
 ImagePointer encompassingObjectAddress,
 long owningThread)

Method Details

getObject

public JavaObject getObject()

Description copied from interface: JavaMonitor

Get the object associated with this monitor.

Specified by:

getObject in interface JavaMonitor

Returns:

the object associated with this monitor, or null if this is a raw monitor or a valid object could not be retrieved.

getName

public String getName()
               throws CorruptDataException

Description copied from interface: JavaMonitor

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.

Specified by:

getName in interface JavaMonitor

Returns:

the name of the monitor (never null)

Throws:

CorruptDataException

getOwner

public JavaThread getOwner()
                    throws CorruptDataException

Description copied from interface: JavaMonitor

Get the thread which currently owns the monitor

Specified by:

getOwner in interface JavaMonitor

Returns:

the owner of the monitor, or null if the monitor is unowned

Throws:

CorruptDataException

getEnterWaiters

public Iterator getEnterWaiters()

Description copied from interface: JavaMonitor

Get the set of threads waiting to enter the monitor

Specified by:

getEnterWaiters in interface JavaMonitor

Returns:

an iterator over the collection of threads waiting to enter this monitor

See Also:

• JavaThread
• CorruptData

getNotifyWaiters

public Iterator getNotifyWaiters()

Description copied from interface: JavaMonitor

Get the set of threads waiting to be notified on the monitor (in the Object.wait method)

Specified by:

getNotifyWaiters in interface JavaMonitor

Returns:

an iterator over the collection of threads waiting to be notified on this monitor

See Also:

• JavaThread
• CorruptData

equals

public 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 (==).

Specified by:

equals in interface JavaMonitor

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

public 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.

Specified by:

hashCode in interface JavaMonitor

Overrides:

hashCode in class Object

Returns:

the receiver's hash.

See Also:

• Object.equals(java.lang.Object)

getID

public ImagePointer getID()

Description copied from interface: JavaMonitor

Get the identifier for this monitor

Specified by:

getID in interface JavaMonitor

Returns:

The pointer which uniquely identifies this monitor in memory.

addBlockedThread

public void addBlockedThread(JavaThread thread)

addWaitingThread

public void addWaitingThread(JavaThread thread)