モジュール java.management

パッケージ java.lang.management

クラスThreadInfo

java.lang.Object

java.lang.management.ThreadInfo

public class ThreadInfo extends Object

スレッド情報です。 ThreadInfoには、次のようなスレッドに関する情報が含まれます:

一般的なスレッド情報

• スレッドID
• スレッドの名前
• スレッドがデーモン・スレッドかどうか

実行情報

• スレッドの状態。
• 次の理由でスレッドがブロックされたオブジェクト。
  • 同期ブロックまたはメソッドに入るために待機していた、または
  • 通知を受けるためにObject.waitメソッドで待機していた、または
  • LockSupport.park呼出しにより、parkが行われた。
• スレッドがブロックされているオブジェクトを所有しているスレッドのID
• スレッドのスタック・トレース
• スレッドによってロックされたオブジェクト・モニターのリスト。
• スレッドによってロックされた所有可能なシンクロナイザのリスト。
• スレッドの優先順位

同期の統計情報

• スレッドが同期をブロックした、または通知を待機した回数
• スレッド・コンテンション監視が有効になってから、スレッドが同期をブロックした、または通知を待機した累積経過時間。 一部のJava仮想マシンの実装は、この機能をサポートしていない可能性がある。 ThreadMXBean.isThreadContentionMonitoringSupported()メソッドを使って、Java仮想マシンがこれをサポートしているかどうかを判定できます。

このスレッド情報クラスは、同期制御用ではなく、システムの監視に使用されるよう設計されています。

MXBeanのマッピング

ThreadInfoは、fromメソッドで指定された属性を持つCompositeDataにマップされます。

導入されたバージョン:

1.5

関連項目:

• ThreadMXBean.getThreadInfo(long)
• ThreadMXBean.dumpAllThreads(boolean, boolean)

メソッドのサマリー

修飾子と型	メソッド	説明
static ThreadInfo	from(CompositeData cd)	指定されたCompositeDataで表されるThreadInfoオブジェクトを返します。
long	getBlockedCount()	このThreadInfoに関連付けられたスレッドがモニターへの入力または再入力をブロックした合計回数を返します。
long	getBlockedTime()	スレッド競合モニタリングが有効になっているため、このThreadInfoに関連付けられたスレッドがモニターの入力または再入力をブロックした、累積経過時間の概算(ミリ秒)を返します。
MonitorInfo[]	getLockedMonitors()	MonitorInfoオブジェクトの配列を返します。各オブジェクトは、このThreadInfoに関連付けられたスレッドによって現在ロックされているオブジェクト・モニターを表します。
LockInfo[]	getLockedSynchronizers()	LockInfoオブジェクトの配列を返します。各オブジェクトは、このThreadInfoに関連付けられたスレッドによって現在ロックされている「所有可能なシンクロナイザ」を表します。
LockInfo	getLockInfo()	このThreadInfoに関連付けられたスレッドが待機中にブロックされているオブジェクトのLockInfoを返します。
String	getLockName()	このThreadInfoに関連付けられたスレッドが待機中にブロックされているオブジェクトのstring representationを返します。
long	getLockOwnerId()	このThreadInfoに関連付けられたスレッドが待機中にブロックされるオブジェクトを所有するスレッドのIDを返します。
String	getLockOwnerName()	このThreadInfoに関連付けられたスレッドが待機中にブロックされるオブジェクトを所有するスレッドの名前を返します。
int	getPriority()	このThreadInfoに関連付けられたスレッドの「スレッドの優先順位」を返します。
StackTraceElement[]	getStackTrace()	このThreadInfoに関連付けられたスレッドのスタック・トレースを返します。
long	getThreadId()	このThreadInfoに関連付けられたスレッドのIDを返します。
String	getThreadName()	このThreadInfoに関連付けられたスレッドの名前を返します。
Thread.State	getThreadState()	このThreadInfoに関連付けられたスレッドの状態を返します。
long	getWaitedCount()	このThreadInfoに関連付けられたスレッドが通知を待機した合計回数を返します。
long	getWaitedTime()	スレッド競合モニタリングが有効になっているため、このThreadInfoに関連付けられたスレッドが通知を待機したおよその累積経過時間(ミリ秒)を返します。
boolean	isDaemon()	このThreadInfoに関連付けられたスレッドが「デーモン・スレッド」かどうかをテストします。
boolean	isInNative()	このThreadInfoに関連付けられたスレッドがネイティブ・コードを実行しているかどうかをテストします。
boolean	isSuspended()	このThreadInfoに関連付けられたスレッドが一時停止されているかどうかをテストします。
String	toString()	このスレッド情報の文字列表現を返します。

クラスjava.lang.Objectで宣言されたメソッド

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

メソッドの詳細

getThreadId

public long getThreadId()

このThreadInfoに関連付けられたスレッドのIDを返します。

戻り値:

関連するスレッドのID

getThreadName

public String getThreadName()

このThreadInfoに関連付けられたスレッドの名前を返します。

戻り値:

関連するスレッドの名前

getThreadState

public Thread.State getThreadState()

このThreadInfoに関連付けられたスレッドの状態を返します。

戻り値:

関連付けられたスレッドのThread.State。

getBlockedTime

public long getBlockedTime()

スレッド競合モニタリングが有効になっているため、このThreadInfoに関連付けられたスレッドがモニターの入力または再入力をブロックした、累積経過時間の概算(ミリ秒)を返します。 つまり、この時間は、スレッド・コンテンション監視が最後に有効になってからスレッドがBLOCKED状態になっていた合計の累積時間です。 このメソッドは、スレッド競合のモニタリングが無効になっている場合は-1を返します。

Java仮想マシンは高精度タイマーを使って計測できます。 この統計は、スレッド競合モニタリングが再度有効にされたときにリセットされます。

戻り値:

スレッドがBLOCKED状態に入ったおよその累積経過時間(ミリ秒)。スレッド競合のモニタリングが無効な場合は-1。

例外:

UnsupportedOperationException - Java仮想マシンがこの操作をサポートしていない場合。

関連項目:

• ThreadMXBean.isThreadContentionMonitoringSupported()
• ThreadMXBean.setThreadContentionMonitoringEnabled(boolean)

getBlockedCount

public long getBlockedCount()

このThreadInfoに関連付けられたスレッドがモニターへの入力または再入力をブロックした合計回数を返します。 つまり、スレッドがBLOCKED状態であった合計回数です。

戻り値:

スレッドがBLOCKED状態に入った合計回数。

getWaitedTime

public long getWaitedTime()

スレッド競合モニタリングが有効になっているため、このThreadInfoに関連付けられたスレッドが通知を待機したおよその累積経過時間(ミリ秒)を返します。 つまり、この時間は、スレッド・コンテンション監視が有効になってから、スレッドがWAITINGまたはTIMED_WAITING状態であった合計の累積時間です。 このメソッドは、スレッド競合のモニタリングが無効になっている場合は-1を返します。

Java仮想マシンは高精度タイマーを使って計測できます。 この統計は、スレッド競合モニタリングが再度有効にされたときにリセットされます。

戻り値:

スレッドがWAITINGまたはTIMED_WAITING状態であったおよその累積経過時間(ミリ秒)。スレッド競合のモニタリングが無効な場合は-1。

例外:

UnsupportedOperationException - Java仮想マシンがこの操作をサポートしていない場合。

関連項目:

• ThreadMXBean.isThreadContentionMonitoringSupported()
• ThreadMXBean.setThreadContentionMonitoringEnabled(boolean)

getWaitedCount

public long getWaitedCount()

このThreadInfoに関連付けられたスレッドが通知を待機した合計回数を返します。 つまり、スレッドがWAITINGまたはTIMED_WAITING状態にあった合計回数です。

戻り値:

スレッドがWAITINGまたはTIMED_WAITING状態であった合計回数。

getLockInfo

public LockInfo getLockInfo()

このThreadInfoに関連付けられたスレッドが待機中にブロックされているオブジェクトのLockInfoを返します。 スレッドは次のいずれかの待機がブロックされることがあります。

• 同期ブロックまたはメソッドに入るまたは再入するために取得されるオブジェクト・モニター。
  スレッドは、synchronized文またはメソッドの入力を待機しているBLOCKED状態です。
• 別のスレッドによって通知を受けるオブジェクト・モニター。
  Object.waitメソッドが呼び出されたため、スレッドはWAITINGまたはTIMED_WAITINGの状態になっています。
• スレッドのparkを行う同期オブジェクト。
  LockSupport.parkメソッドが呼び出されたため、スレッドはWAITINGまたはTIMED_WAITINGの状態になっています。 同期オブジェクトとは、LockSupport.getBlockerメソッドで返されるオブジェクトである。 通常は、所有可能なシンクロナイザまたはConditionである。

このメソッドは、スレッドが上記のいずれの条件にもない場合にnullを返します。

戻り値:

スレッドがブロックされている待機中のオブジェクトのLockInfo。それ以外の場合はnull。

導入されたバージョン:

1.6

getLockName

public String getLockName()

このThreadInfoに関連付けられたスレッドが待機中にブロックされているオブジェクトのstring representationを返します。 このメソッドは、次を呼び出すのと同等です。

 getLockInfo().toString()
 

このメソッドは、オブジェクトの待機中にこのスレッドがブロックされていない場合、またはオブジェクトがスレッドによって所有されていない場合、nullを返します。

戻り値:

スレッドがブロックされているオブジェクト(ある場合)の文字列表現。それ以外の場合はnull。

関連項目:

• getLockInfo()

getLockOwnerId

public long getLockOwnerId()

このThreadInfoに関連付けられたスレッドが待機中にブロックされるオブジェクトを所有するスレッドのIDを返します。 このメソッドは、オブジェクトの待機中にこのスレッドがブロックされていない場合、またはオブジェクトがスレッドによって所有されていない場合、-1を返します。

戻り値:

このスレッドがブロックされているオブジェクトの所有者スレッドのスレッドID。このスレッドがブロックされていない場合、またはオブジェクトがスレッドによって所有されていない場合、-1。

関連項目:

• getLockInfo()

getLockOwnerName

public String getLockOwnerName()

このThreadInfoに関連付けられたスレッドが待機中にブロックされるオブジェクトを所有するスレッドの名前を返します。 このメソッドは、オブジェクトの待機中にこのスレッドがブロックされていない場合、またはオブジェクトがスレッドによって所有されていない場合、nullを返します。

戻り値:

このスレッドがブロックされるオブジェクトを所有するスレッドの名前。このスレッドがブロックされていない場合、またはオブジェクトがスレッドによって所有されていない場合、null。

関連項目:

• getLockInfo()

getStackTrace

public StackTraceElement[] getStackTrace()

このThreadInfoに関連付けられたスレッドのスタック・トレースを返します。 このスレッド情報についてスタック・トレースが要求されなかった場合、このメソッドは長さゼロの配列を返します。 返された配列がゼロ以外の長さの配列である場合、配列の最初の要素はスタックの最上部を表します。これはシーケンスで呼び出されたもっとも新しいメソッドです。 配列の最後の要素は、スタックの底部を表します。これはシーケンスで呼び出されたもっとも古いメソッドです。

Java仮想マシンの中には、特定の状況下でスタック・トレースから1つ以上のスタック・フレームを省略するものがあります。 ストリームの場合、このThreadInfoに関連付けられたスレッドに関するスタック・トレース情報がない仮想マシンは、このメソッドから長さゼロの配列を返すことができます。

戻り値:

スレッドのStackTraceElementオブジェクトの配列。

isSuspended

public boolean isSuspended()

このThreadInfoに関連付けられたスレッドが一時停止されているかどうかをテストします。 このメソッドは、Thread.suspend()がコールされた場合にtrueを返します。

戻り値:

スレッドが一時停止されている場合はtrue、それ以外の場合はfalse。

isInNative

public boolean isInNative()

このThreadInfoに関連付けられたスレッドがネイティブ・コードを実行しているかどうかをテストします。

スレッドは、ネイティブ・メソッドを実行しているとき、「ネイティブ・リンカー」から取得した「メソッド・ハンドル」^RESTRICTEDを使用して起動されたネイティブ・コードを実行しているとき、またはスタック上にJavaフレームがないJava Native Interfaceを使用してVMに対して「添付済」を実行しているときに、ネイティブ・コードを実行しているとみなされます。

ネイティブ・コードには、Java仮想マシンのサポート・コード、Java仮想マシンによって生成されたコンパイル済コード、またはJVM TI raw monitorでブロックされたスレッドなどの特殊なケースは含まれません。

戻り値:

スレッドがネイティブ・コードを実行している場合はtrue、それ以外の場合はfalse。

isDaemon

public boolean isDaemon()

このThreadInfoに関連付けられたスレッドが「デーモン・スレッド」かどうかをテストします。

戻り値:

スレッドがデーモン・スレッドの場合はtrue、それ以外の場合はfalse。

導入されたバージョン:

9

関連項目:

• Thread.isDaemon()

getPriority

public int getPriority()

このThreadInfoに関連付けられたスレッドの「スレッドの優先順位」を返します。

戻り値:

このThreadInfoに関連付けられたスレッドの優先順位。

導入されたバージョン:

9

toString

public String toString()

このスレッド情報の文字列表現を返します。 この文字列の形式は実装に依存します。 通常、返される文字列にはスレッド名、スレッドID、その状態、およびスタック・トレース (存在する場合)が含まれます。

オーバーライド:

toString、クラスObject

戻り値:

このスレッド情報の文字列表現

from

public static ThreadInfo from(CompositeData cd)

指定されたCompositeDataで表されるThreadInfoオブジェクトを返します。 バージョンNのCompositeDataを表すCompositeDataは、バージョン≤ Nで定義されるすべての属性を、それ以外で指定しないかぎり、含む必要があります。 同じルールでは、typeまたは「コンポーネント・タイプ」がCompositeTypeである属性に、指定されたCompositeDataのコンポジット・タイプが適用され、そのコンポジット・タイプに一時的に適用されます。

ThreadInfoを表すThreadInfoでありNには、"stackTrace"属性と"lockedMonitors"の配列を表すStackTraceElementの配列とMonitorInfoの配列をそれぞれ表し、それらの型はNです。 MonitorInfo複合タイプの"lockedStackFrame"属性は、同じバージョンNのStackTraceElementを表している必要があります。 それ以外の場合、このメソッドはIllegalArgumentExceptionをスローします。

ThreadInfoコンポジット・データ用の属性とそのタイプ

属性名	型	導入されたバージョン
threadId	java.lang.Long	5
threadName	java.lang.String	5
threadState	java.lang.String	5
suspended	java.lang.Boolean	5
inNative	java.lang.Boolean	5
blockedCount	java.lang.Long	5
blockedTime	java.lang.Long	5
waitedCount	java.lang.Long	5
waitedTime	java.lang.Long	5
lockName	java.lang.String	5
lockOwnerId	java.lang.Long	5
lockOwnerName	java.lang.String	5
stackTrace	javax.management.openmbean.CompositeData[]が指定されたbelowと同じStackTraceElementを表すCompositeDataです。	5
lockInfo	javax.management.openmbean.CompositeData - LockInfo.from(javax.management.openmbean.CompositeData)メソッドで指定されたLockInfoのマップされたタイプ。 指定されたCompositeDataにこの属性が含まれていない場合は、lockName属性の値からLockInfoオブジェクトが作成されます。	6
lockedMonitors	要素タイプがMonitorInfo.fromメソッドで指定されたMonitorInfoのマップされた型であるjavax.management.openmbean.CompositeData[]。 指定されたCompositeDataにこの属性が含まれていない場合、この属性は空の配列に設定されます。	6
lockedSynchronizers	要素タイプがLockInfo.from(javax.management.openmbean.CompositeData)メソッドで指定されたLockInfoのマップされた型であるjavax.management.openmbean.CompositeData[]。 指定されたCompositeDataにこの属性が含まれていない場合、この属性は空の配列に設定されます。	6
daemon	java.lang.Boolean 指定されたCompositeDataにこの属性が含まれていない場合、この属性はfalseに設定されます。	9
priority	java.lang.Integer 指定されたCompositeDataにこの属性が含まれていない場合、この属性はThread.NORM_PRIORITYに設定されます。	9

バージョンNの「StackTraceElementを表すCompositeData」は、バージョン≤ Nで定義されているすべての属性が含まれている必要があります(特に指定されていない場合)。

StackTraceElementコンポジット・データ用の属性とそのタイプ

属性名	型	導入されたバージョン
classLoaderName	java.lang.String	9
moduleName	java.lang.String	9
moduleVersion	java.lang.String	9
className	java.lang.String	5
methodName	java.lang.String	5
fileName	java.lang.String	5
lineNumber	java.lang.Integer	5
nativeMethod	java.lang.Boolean	5

パラメータ:

cd - ThreadInfoを表すCompositeData

戻り値:

cdがnullでない場合はcdで表されるThreadInfoオブジェクト、それ以外の場合はnull。

例外:

IllegalArgumentException - 指定されたcdが指定されている場合、特定の実行時バージョンのThreadInfoに対して定義された「属性」が含まれていないと、そのコンポジット型には、特定のランタイム・バージョンが含まれます。

getLockedMonitors

public MonitorInfo[] getLockedMonitors()

MonitorInfoオブジェクトの配列を返します。各オブジェクトは、このThreadInfoに関連付けられたスレッドによって現在ロックされているオブジェクト・モニターを表します。 このスレッド情報についてロックされたモニターが要求されなかった場合、またはスレッドによってロックされたモニターがない場合、このメソッドは長さゼロの配列を返します。

戻り値:

スレッドによってロックされたオブジェクト・モニターを表すMonitorInfoオブジェクトの配列。

導入されたバージョン:

1.6

getLockedSynchronizers

public LockInfo[] getLockedSynchronizers()

LockInfoオブジェクトの配列を返します。各オブジェクトは、このThreadInfoに関連付けられたスレッドによって現在ロックされている「所有可能なシンクロナイザ」を表します。 このスレッド情報についてロックされたシンクロナイザが要求されなかった場合、またはスレッドによってロックされたシンクロナイザがない場合、このメソッドは長さゼロの配列を返します。

戻り値:

スレッドによってロックされた、所有可能なシンクロナイザを表すLockInfoオブジェクトの配列。

導入されたバージョン:

1.6