ThreadInfo (Java Platform SE 7)

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 - MXBean の型マッピングルールで指定された、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[]。この型は MXBean の型マッピングルールで指定されます。
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

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

クラス ThreadInfo

一般的なスレッド情報

実行情報

同期の統計情報

MXBean のマッピング

メソッドのサマリー

クラス java.lang.Object から継承されたメソッド

メソッドの詳細

getThreadId

getThreadName

getThreadState

getBlockedTime

getBlockedCount

getWaitedTime

getWaitedCount

getLockInfo

getLockName

getLockOwnerId

getLockOwnerName

getStackTrace

isSuspended

isInNative

toString

from

getLockedMonitors

getLockedSynchronizers