compact3

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に関連するスレッドが待機するのをブロックされるオブジェクトの文字列表現を返します。
long	getLockOwnerId() このThreadInfoに関連するスレッドが待機するのをブロックされているオブジェクトについて、そのオブジェクトを所有するスレッドのIDを返します。
String	getLockOwnerName() このThreadInfoに関連するスレッドが待機するのをブロックされているオブジェクトについて、そのオブジェクトを所有するスレッドの名前を返します。
StackTraceElement[]	getStackTrace() このThreadInfoに関連するスレッドのスタック・トレースを返します。
long	getThreadId() このThreadInfoに関連するスレッドのIDを返します。
String	getThreadName() このThreadInfoに関連するスレッドの名前を返します。
Thread.State	getThreadState() このThreadInfoに関連するスレッドの状態を返します。
long	getWaitedCount() このThreadInfoに関連するスレッドが通知を待機した合計回数を返します。
long	getWaitedTime() スレッド・コンテンション監視が有効になってから、このThreadInfoに関連するスレッドが通知を待機したおよその累積経過時間(ミリ秒単位)を返します。
boolean	isInNative() このThreadInfoに関連するスレッドが、JNI (Java Native Interface)を使ってネイティブ・コードを実行しているかどうかをテストします。
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に関連するスレッドが待機するのをブロックされるオブジェクトの文字列表現を返します。このメソッドは、次を呼び出すのと同等です。

 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に関連するスレッドが、JNI (Java Native Interface)を使ってネイティブ・コードを実行しているかどうかをテストします。JNIネイティブ・コードは、仮想マシン・サポート・コードや仮想マシンにより生成されたコンパイル済みネイティブ・コードを含みません。

戻り値:

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

toString

public String toString()

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

オーバーライド:

toString、クラス: Object

戻り値:

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

from

public static ThreadInfo from(CompositeData cd)

指定されたCompositeDataによって表されるThreadInfoオブジェクトを返します。特に断りがないかぎり、指定されたCompositeDataは、次の属性を含む必要があります。

属性名	型
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 - LockInfo.from(javax.management.openmbean.CompositeData)メソッドで指定された、LockInfoのマップされた型。 cdにこの属性が含まれない場合、LockInfoオブジェクトはlockName属性の値から構築されます。
lockName	java.lang.String
lockOwnerId	java.lang.Long
lockOwnerName	java.lang.String
stackTrace	javax.management.openmbean.CompositeData[] 各要素は、次の属性を含むStackTraceElementを表すCompositeData 属性名 型 className java.lang.String methodName java.lang.String fileName java.lang.String lineNumber java.lang.Integer nativeMethod java.lang.Boolean
lockedMonitors	要素型がMonitorInfoのマップされた型であるjavax.management.openmbean.CompositeData[]。この型はMonitor.fromメソッドで指定されます。 cdにこの属性が含まれない場合、この属性は空の配列に設定されます。
lockedSynchronizers	要素型がLockInfoのマップされた型であるjavax.management.openmbean.CompositeData[]。この型はLockInfo.from(javax.management.openmbean.CompositeData)メソッドで指定されます。 cdにこの属性が含まれない場合、この属性は空の配列に設定されます。

パラメータ:

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