java.lang.Object | |
↳ | java.lang.management.ThreadInfo |
Thread information. ThreadInfo contains the information about a thread including:
Object.wait
method,
orLockSupport.park
call.thread contention monitoring
was enabled. Some Java virtual machine implementation
may not support this. The
isThreadContentionMonitoringSupported()
method can be used to determine if a Java virtual machine
supports this.This thread information class is designed for use in monitoring of the system, not for synchronization control.
CompositeData
with attributes as specified in
the from
method.
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Returns a ThreadInfo object represented by the
given CompositeData.
| |||||||||||
Returns the total number of times that
the thread associated with this ThreadInfo
blocked to enter or reenter a monitor.
| |||||||||||
Returns the approximate accumulated elapsed time (in milliseconds)
that the thread associated with this ThreadInfo
has blocked to enter or reenter a monitor
since thread contention monitoring is enabled.
| |||||||||||
Returns the LockInfo of an object for which
the thread associated with this ThreadInfo
is blocked waiting.
| |||||||||||
Returns the
string representation
of an object for which the thread associated with this
ThreadInfo is blocked waiting. | |||||||||||
Returns the ID of the thread which owns the object
for which the thread associated with this ThreadInfo
is blocked waiting.
| |||||||||||
Returns the name of the thread which owns the object
for which the thread associated with this ThreadInfo
is blocked waiting.
| |||||||||||
Returns an array of
MonitorInfo objects, each of which
represents an object monitor currently locked by the thread
associated with this ThreadInfo. | |||||||||||
Returns an array of
LockInfo objects, each of which
represents an ownable
synchronizer currently locked by the thread associated with
this ThreadInfo. | |||||||||||
Returns the stack trace of the thread
associated with this ThreadInfo.
| |||||||||||
Returns the ID of the thread associated with this ThreadInfo.
| |||||||||||
Returns the name of the thread associated with this ThreadInfo.
| |||||||||||
Returns the state of the thread associated with this ThreadInfo.
| |||||||||||
Returns the total number of times that
the thread associated with this ThreadInfo
waited for notification.
| |||||||||||
Returns the approximate accumulated elapsed time (in milliseconds)
that the thread associated with this ThreadInfo
has waited for notification
since thread contention monitoring is enabled.
| |||||||||||
Tests if the thread associated with this ThreadInfo
is executing native code via the Java Native Interface (JNI).
| |||||||||||
Tests if the thread associated with this ThreadInfo
is suspended.
| |||||||||||
Returns a string representation of this thread info.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
|
Returns a ThreadInfo object represented by the given CompositeData. The given CompositeData must contain the following attributes unless otherwise specified below:
Attribute Name Type threadId java.lang.Long threadName java.lang.String threadState java.lang.String suspended java.lang.Boolean inNative java.lang.Boolean blockedCount java.lang.Long blockedTime java.lang.Long waitedCount java.lang.Long waitedTime java.lang.Long lockInfo javax.management.openmbean.CompositeData - the mapped type for LockInfo
as specified in the type mapping rules ofMXBeans
.If cd does not contain this attribute, the LockInfo object will be constructed from the value of the lockName attribute.
lockName java.lang.String lockOwnerId java.lang.Long lockOwnerName java.lang.String stackTrace javax.management.openmbean.CompositeData[] Each element is a CompositeData representing StackTraceElement containing the following attributes:
Attribute Name Type className java.lang.String methodName java.lang.String fileName java.lang.String lineNumber java.lang.Integer nativeMethod java.lang.Boolean lockedMonitors javax.management.openmbean.CompositeData[] whose element type is the mapped type for MonitorInfo
as specified in theMonitor.from
method.If cd does not contain this attribute, this attribute will be set to an empty array.
lockedSynchronizers javax.management.openmbean.CompositeData[] whose element type is the mapped type for LockInfo
as specified in the type mapping rules ofMXBeans
.If cd does not contain this attribute, this attribute will be set to an empty array.
cd | CompositeData representing a ThreadInfo |
---|
IllegalArgumentException | if cd does not represent a ThreadInfo with the attributes described above. |
---|
Returns the total number of times that
the thread associated with this ThreadInfo
blocked to enter or reenter a monitor.
I.e. the number of times a thread has been in the
BLOCKED
state.
Returns the approximate accumulated elapsed time (in milliseconds)
that the thread associated with this ThreadInfo
has blocked to enter or reenter a monitor
since thread contention monitoring is enabled.
I.e. the total accumulated time the thread has been in the
BLOCKED
state since thread
contention monitoring was last enabled.
This method returns -1 if thread contention monitoring
is disabled.
The Java virtual machine may measure the time with a high resolution timer. This statistic is reset when the thread contention monitoring is reenabled.
UnsupportedOperationException | if the Java virtual machine does not support this operation. |
---|
Returns the LockInfo of an object for which the thread associated with this ThreadInfo is blocked waiting. A thread can be blocked waiting for one of the following:
BLOCKED
state waiting to enter the synchronized statement
or method.
WAITING
or TIMED_WAITING
state
due to a call to the Object.wait
method.
WAITING
or TIMED_WAITING
state
due to a call to the
LockSupport.park
method. The synchronization object
is the object returned from
LockSupport.getBlocker
method. Typically it is an
ownable synchronizer
or a Condition
.This method returns null if the thread is not in any of the above conditions.
Returns the string representation
of an object for which the thread associated with this
ThreadInfo is blocked waiting.
This method is equivalent to calling:
getLockInfo().toString()
This method will return null if this thread is not blocked waiting for any object or if the object is not owned by any thread.
Returns the ID of the thread which owns the object for which the thread associated with this ThreadInfo is blocked waiting. This method will return -1 if this thread is not blocked waiting for any object or if the object is not owned by any thread.
Returns the name of the thread which owns the object for which the thread associated with this ThreadInfo is blocked waiting. This method will return null if this thread is not blocked waiting for any object or if the object is not owned by any thread.
Returns an array of MonitorInfo
objects, each of which
represents an object monitor currently locked by the thread
associated with this ThreadInfo.
If no locked monitor was requested for this thread info or
no monitor is locked by the thread, this method
will return a zero-length array.
Returns an array of LockInfo
objects, each of which
represents an ownable
synchronizer currently locked by the thread associated with
this ThreadInfo. If no locked synchronizer was
requested for this thread info or no synchronizer is locked by
the thread, this method will return a zero-length array.
Returns the stack trace of the thread associated with this ThreadInfo. If no stack trace was requested for this thread info, this method will return a zero-length array. If the returned array is of non-zero length then the first element of the array represents the top of the stack, which is the most recent method invocation in the sequence. The last element of the array represents the bottom of the stack, which is the least recent method invocation in the sequence.
Some Java virtual machines may, under some circumstances, omit one or more stack frames from the stack trace. In the extreme case, a virtual machine that has no stack trace information concerning the thread associated with this ThreadInfo is permitted to return a zero-length array from this method.
Returns the ID of the thread associated with this ThreadInfo.
Returns the name of the thread associated with this ThreadInfo.
Returns the state of the thread associated with this ThreadInfo.
Returns the total number of times that
the thread associated with this ThreadInfo
waited for notification.
I.e. the number of times that a thread has been
in the WAITING
or TIMED_WAITING
state.
Returns the approximate accumulated elapsed time (in milliseconds)
that the thread associated with this ThreadInfo
has waited for notification
since thread contention monitoring is enabled.
I.e. the total accumulated time the thread has been in the
WAITING
or TIMED_WAITING
state
since thread contention monitoring is enabled.
This method returns -1 if thread contention monitoring
is disabled.
The Java virtual machine may measure the time with a high resolution timer. This statistic is reset when the thread contention monitoring is reenabled.
UnsupportedOperationException | if the Java virtual machine does not support this operation. |
---|
Tests if the thread associated with this ThreadInfo is executing native code via the Java Native Interface (JNI). The JNI native code does not include the virtual machine support code or the compiled native code generated by the virtual machine.
Tests if the thread associated with this ThreadInfo
is suspended. This method returns true if
suspend()
has been called.
Returns a string representation of this thread info.
The format of this string depends on the implementation.
The returned string will typically include
the thread name
,
the thread ID
,
its state
,
and a stack trace
if any.