com.sun.jdi
インタフェース ThreadReference

すべてのスーパーインタフェース:

Mirror, ObjectReference, Value

public interface ThreadReference

extends ObjectReference

ターゲット VM のスレッドオブジェクトです。ThreadReference は、ターゲット VM のスレッド固有の情報に追加アクセスできる ObjectReference です。

導入されたバージョン:

1.3

フィールドの概要

static int	THREAD_STATUS_MONITOR スレッドは Java モニターを待機中です。
static int	THREAD_STATUS_NOT_STARTED スレッドは開始されていません。
static int	THREAD_STATUS_RUNNING スレッドは実行可能です。
static int	THREAD_STATUS_SLEEPING スレッドはスリープ中です。
static int	THREAD_STATUS_UNKNOWN スレッドの状態が不明です。
static int	THREAD_STATUS_WAIT スレッドは待機中です。
static int	THREAD_STATUS_ZOMBIE スレッドは実行を完了しました。

インタフェース com.sun.jdi.ObjectReference から継承したフィールド

INVOKE_NONVIRTUAL, INVOKE_SINGLE_THREADED

メソッドの概要

ObjectReference	currentContendedMonitor() このスレッドが現在モニターを待機している場合は、そのモニターへの ObjectReference を返します。
StackFrame	frame(int index) スレッドの現在の呼び出しスタック内の指定されたインデックスで StackFrame を返します。
int	frameCount() スレッドの現在の呼び出しスタック内のスタックフレーム数を返します。
java.util.List	frames() スレッドの現在の呼び出しスタック内にあるすべての StackFrame の List を返します。
java.util.List	frames(int start, int length) スレッドの現在の呼び出しスタックにある StackFrame ミラーの範囲の List を返します。
void	interrupt() このスレッドに割り込みます。
boolean	isAtBreakpoint() スレッドがブレークポイントで中断しているかどうかを判定します。
boolean	isSuspended() デバッガによってスレッドが中断されているかどうかを判定します。
java.lang.String	name() このスレッドの名前を返します。
java.util.List	ownedMonitors() スレッドが所有する各モニターへの ObjectReference の List を返します。
void	resume() このスレッドを再開します。
int	status() スレッドの状態を返します。
void	stop(ObjectReference throwable) 非同期の例外を使用してこのスレッドを停止します。
void	suspend() このスレッドを中断します。
int	suspendCount() このスレッドの保留状態の中断回数を返します。
ThreadGroupReference	threadGroup() このスレッドのスレッドグループを返します。

インタフェース com.sun.jdi.ObjectReference から継承したメソッド

disableCollection, enableCollection, entryCount, equals, getValue, getValues, hashCode, invokeMethod, isCollected, owningThread, referenceType, setValue, uniqueID, waitingThreads

インタフェース com.sun.jdi.Value から継承したメソッド

type

インタフェース com.sun.jdi.Mirror から継承したメソッド

toString, virtualMachine

フィールドの詳細

THREAD_STATUS_UNKNOWN

public static final int THREAD_STATUS_UNKNOWN

スレッドの状態が不明です。

THREAD_STATUS_ZOMBIE

public static final int THREAD_STATUS_ZOMBIE

スレッドは実行を完了しました。

THREAD_STATUS_RUNNING

public static final int THREAD_STATUS_RUNNING

スレッドは実行可能です。

THREAD_STATUS_SLEEPING

public static final int THREAD_STATUS_SLEEPING

スレッドはスリープ中です。Thread.sleep() または JVM_Sleep() が呼び出されました。

THREAD_STATUS_MONITOR

public static final int THREAD_STATUS_MONITOR

スレッドは Java モニターを待機中です。

THREAD_STATUS_WAIT

public static final int THREAD_STATUS_WAIT

スレッドは待機中です。Thread.wait() または JVM_MonitorWait() が呼び出されました。

THREAD_STATUS_NOT_STARTED

public static final int THREAD_STATUS_NOT_STARTED

スレッドは開始されていません。

メソッドの詳細

name

public java.lang.String name()

このスレッドの名前を返します。

戻り値:

スレッド名を含む文字列

例外:

ObjectCollectedException - このオブジェクトがガベージコレクトされている場合

suspend

public void suspend()

このスレッドを中断します。スレッドは resume() を使用して再開するか、VirtualMachine.resume() を使用してほかのスレッドから再開できます。

java.lang.Thread#suspend と異なり、Virtual Machine の中断と各スレッドの中断はどちらもカウントされます。スレッドは、再実行される前に、resume() または resume() を使用して、中断された回数と同じ回数だけ再開する必要があります。

このメソッドを使用して単一のスレッドを中断する場合、java.lang.Thread.suspend() を使用する場合と同様の注意が必要です。中断されたスレッドが保持しているモニターが、別の実行中のスレッドから要求された場合、ターゲット VM 内で (少なくとも中断されたスレッドが再開されるまでの間) デッドロックが発生する可能性があります。

中断されたスレッドは、上記の JDI 再開メソッドのいずれかを使用して再開するまで、中断状態が保証されます。ターゲット VM 内のアプリケーションから java.lang.Thread#resume を使用して、中断されたスレッドを再開することはできません。

例外:

ObjectCollectedException - このオブジェクトがガベージコレクトされている場合

resume

public void resume()

このスレッドを再開します。このスレッドが suspend() または VirtualMachine.suspend() によって中断されていない場合は、このメソッドを呼び出しても再開できません。これらのいずれかによって中断されたスレッドの場合は、このスレッドの保留状態の中断カウントが減ります。カウントが 0 になると、スレッドの実行が継続されます。

例外:

ObjectCollectedException - このオブジェクトがガベージコレクトされている場合

suspendCount

public int suspendCount()

このスレッドの保留状態の中断回数を返します。カウントされる中断については、suspend() を参照してください。

戻り値:

保留状態の中断カウントを表す整数

例外:

ObjectCollectedException - このオブジェクトがガベージコレクトされている場合

stop

public void stop(ObjectReference throwable)
          throws InvalidTypeException

非同期の例外を使用してこのスレッドを停止します。ターゲット VM 内のデバッガスレッドは、指定された Throwable オブジェクトを使用してこのスレッドを停止します。

パラメータ:

throwable - スローする非同期の例外

例外:

InvalidTypeException - throwable がターゲット VM 内の java.lang.Throwable のインスタンスでない場合

ObjectCollectedException - このオブジェクトまたは非同期の例外がガベージコレクトされている場合

関連項目:

java.lang.Thread#stop(Throwable)

interrupt

public void interrupt()

このスレッドに割り込みます。

例外:

ObjectCollectedException - このオブジェクトがガベージコレクトされている場合

関連項目:

java.lang.Thread#interrupt()

status

public int status()

スレッドの状態を返します。スレッドが中断していない場合は、スレッドの現在の状態を返します。スレッドが中断している場合は、中断前のスレッドの状態を返します。中断前のスレッドの状態を取得できない場合は、THREAD_STATUS_UNKNOWN を返します。スレッドが中断しているかどうかを判定するには、isSuspended() を使用します。

戻り値:

THREAD_STATUS_UNKNOWN、 THREAD_STATUS_ZOMBIE、 THREAD_STATUS_RUNNING、 THREAD_STATUS_SLEEPING、 THREAD_STATUS_MONITOR、 THREAD_STATUS_WAIT、または THREAD_STATUS_NOT_STARTED のいずれか

例外:

ObjectCollectedException - このオブジェクトがガベージコレクトされている場合

isSuspended

public boolean isSuspended()

デバッガによってスレッドが中断されているかどうかを判定します。

戻り値:

スレッドが現在中断している場合は true、それ以外の場合は false

例外:

ObjectCollectedException - このオブジェクトがガベージコレクトされている場合

isAtBreakpoint

public boolean isAtBreakpoint()

スレッドがブレークポイントで中断しているかどうかを判定します。

戻り値:

スレッドがブレークポイントで現在停止している場合は true、それ以外の場合は false

例外:

ObjectCollectedException - このオブジェクトがガベージコレクトされている場合

threadGroup

public ThreadGroupReference threadGroup()

このスレッドのスレッドグループを返します。

戻り値:

ターゲット VM 内のこのスレッドのスレッドグループをミラー化する ThreadGroupReference

例外:

ObjectCollectedException - このオブジェクトがガベージコレクトされている場合

frameCount

public int frameCount()
               throws IncompatibleThreadStateException

スレッドの現在の呼び出しスタック内のスタックフレーム数を返します。この情報を取得するには、スレッドを中断する必要があります (通常は VM への割り込みによって)。この情報は、スレッドが再開されると無効になります。

戻り値:

フレームのカウントを表す整数

例外:

IncompatibleThreadStateException - ターゲット VM 内でスレッドが中断していない場合

ObjectCollectedException - このオブジェクトがガベージコレクトされている場合

frames

public java.util.List frames()
                      throws IncompatibleThreadStateException

スレッドの現在の呼び出しスタック内にあるすべての StackFrame の List を返します。この情報を取得するには、スレッドを中断する必要があります (通常は VM への割り込みによって)。この情報は、スレッドが再開されると無効になります。

戻り値:

現在のフレームの次に呼び出し側の各フレームが続く StackFrame の List

例外:

IncompatibleThreadStateException - ターゲット VM 内でスレッドが中断されていない場合

ObjectCollectedException - このオブジェクトがガベージコレクトされている場合

frame

public StackFrame frame(int index)
                 throws IncompatibleThreadStateException

スレッドの現在の呼び出しスタック内の指定されたインデックスで StackFrame を返します。インデックス 0 は、現在のフレームです。0 より大きいインデックスの場合は、呼び出し側のフレームを示します。この情報を取得するには、スレッドを中断する必要があります (通常は VM への割り込みによって)。この情報は、スレッドが再開されると無効になります。

パラメータ:

index - 目的のフレーム

戻り値:

要求された StackFrame

例外:

IncompatibleThreadStateException - ターゲット VM 内でスレッドが中断していない場合

java.lang.IndexOutOfBoundsException - インデックスが frameCount() 以上の場合、または負の場合

ObjectCollectedException - このオブジェクトがガベージコレクトされている場合

frames

public java.util.List frames(int start,
                             int length)
                      throws IncompatibleThreadStateException

スレッドの現在の呼び出しスタックにある StackFrame ミラーの範囲の List を返します。この情報を取得するには、スレッドを中断する必要があります (通常は VM への割り込みによって)。この情報は、スレッドが再開されると無効になります。

パラメータ:

start - 最初のフレームのインデックス

length - 取得するフレーム数

戻り値:

現在のフレームの次に呼び出し側の各フレームが続く StackFrame の List

例外:

IncompatibleThreadStateException - ターゲット VM 内でスレッドが中断していない場合

IndexOutOfBoundsException - 指定された範囲が 0 〜 frameCount() - 1 にない場合

ObjectCollectedException - このオブジェクトがガベージコレクトされている場合

ownedMonitors

public java.util.List ownedMonitors()
                             throws IncompatibleThreadStateException

スレッドが所有する各モニターへの ObjectReference の List を返します。synchronized 文または synchronized メソッドのエントリを使用してスレッドがモニターに入ってから、モニターが Object.wait(long) によって破棄されていない場合は、そのモニターはスレッドによって所有されています。

この操作は、ターゲット VM でサポートされていないことがあります。この操作がサポートされているかどうかを確認する方法については、VirtualMachine#canGetOwnedMonitorInfo を参照してください。

戻り値:

ObjectReference オブジェクトの List。このスレッドによってモニターが所有されていない場合は、このリストの長さはゼロになる

例外:

java.lang.UnsupportedOperationException - ターゲット VM がこの操作をサポートしていない場合

IncompatibleThreadStateException - ターゲット VM 内でスレッドが中断していない場合

ObjectCollectedException - このオブジェクトがガベージコレクトされている場合

currentContendedMonitor

public ObjectReference currentContendedMonitor()
                                        throws IncompatibleThreadStateException

このスレッドが現在モニターを待機している場合は、そのモニターへの ObjectReference を返します。スレッドは、synchronized メソッドのエントリ、synchronized 文、または Object.wait(long) を使用して、モニターを待機している可能性があります。最初の 2 つの場合と Object.wait(long) による場合を識別するには、status() メソッドを使用します。

この操作は、ターゲット VM でサポートされていないことがあります。この操作がサポートされているかどうかを確認する方法については、VirtualMachine#canGetCurrentContendedMonitor を参照してください。

戻り値:

競合するモニターに対応する ObjectReference。スレッドがモニターを待機していない場合は null

例外:

java.lang.UnsupportedOperationException - ターゲット VM でこの操作がサポートされていない場合

IncompatibleThreadStateException - ターゲット VM 内でスレッドが中断していない場合

ObjectCollectedException - このオブジェクトがガベージコレクトされている場合