全パッケージ  クラス階層  このパッケージ  前項目  次項目  インデックス

クラス java.lang.ThreadGroup

java.lang.Object
   |
   +----java.lang.ThreadGroup

public class ThreadGroup

extends Object

スレッドは、それ自体のスレッドグループについての情報にアクセスすることを許可されていますが、そのスレッドグループの親スレッドグループまたはその他のスレッドグループについての情報にアクセスすることはできません。

ThreadGroup(String)

新規スレッドグループを構築する。

ThreadGroup(ThreadGroup, String)

新規スレッドグループを作成する。

activeCount()

このスレッドグループ内のアクティブスレッドの見積もりを返す。

activeGroupCount()

このスレッドグループ内のアクティブグループの見積もりを返す。

allowThreadSuspension(boolean)

メモリ不足による暗黙の中断を制御する場合に VM によって使用される。

checkAccess()

現在実行中のスレッドがこのスレッドグループを修正する許可を得ているかどうかを確認する。

destroy()

このスレッドグループとそのすべてのサブグループを破棄する。

enumerate(Thread[])

のスレッドグループとそのサブグループ内のあらゆるアクティブスレッドを指定された配列の中にコピーする。

enumerate(Thread[], boolean)

このスレッドグループ内のあらゆるアクティブスレッドを指定された配列の中にコピーする。

enumerate(ThreadGroup[])

このスレッドグループ内のあらゆるアクティブサブグループに対する参照を指定された配列の中にコピーする。

enumerate(ThreadGroup[], boolean)

このスレッドグループ内のあらゆるアクティブサブグループに対する参照を指定された配列の中にコピーする。

getMaxPriority()

このスレッドグループの最高優先順位を返す。

getName()

このスレッドグループの名称を返す。

getParent()

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

isDaemon()

このスレッドグループがデーモンスレッドグループであるかどうかをテストする。

isDestroyed()

このスレッドグループが破棄されているかどうかをテストする。

list()

このスレッドグループについての情報を標準出力に出力する。

parentOf(ThreadGroup)

このスレッドグループがスレッドグループ引数であるのか、またはその先祖スレッドグループの内の 1 つであるのかをテストする。

resume()

このスレッドグループ中のすべてのプロセスを再開する。

setDaemon(boolean)

このスレッドグループのデーモンの状態を変更する。

setMaxPriority(int)

グループの最高優先順位を設定する。

stop()

このスレッドグループ内のすべてのプロセスを停止する。

suspend()

このスレッドグループ内のすべてのプロセスを中断する。

toString()

このスレッドグループの文字列表記を返す。

uncaughtException(Thread, Throwable)

このスレッドグループ内のスレッドが、キャッチされていない例外のために停止すると、Java 仮想マシン によって呼び出される。

  public ThreadGroup(String name)

新規スレッドグループを構築します。この新規グループの親が、現在実行中のスレッドのスレッドグループです。

パラメータ:

name - 新規スレッドグループ名

  public ThreadGroup(ThreadGroup parent,
                     String name)

新規スレッドグループを作成します。この新規グループの親が指定されたスレッドグループです。

親スレッドグループのcheckAccessメソッドは、引数が指定されないで呼び出され、その結果セキュリティ例外が生じることがあります。

パラメータ:

parent - 親スレッドグループ

name - 新規スレッドグループ名

例外: NullPointerException

スレッドグループ引数が null である場合

例外: SecurityException

現在のスレッドが指定されたスレッドグループ内のスレッドを作成できない場合

参照:

SecurityException, checkAccess

  public final String getName()

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

返り値:

このスレッドグループの名前

  public final ThreadGroup getParent()

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

返り値:

このスレッドグループの親。トップレベルスレッドグループは、親が null であるスレッドグループだけです。

  public final int getMaxPriority()

このスレッドグループの最高優先順位を返します。このグループの一部であるスレッドに、最高優先順位より高い優先順位を指定することはできません。

返り値:

このスレッドグループ内のスレッドに指定できる最高優先順位

  public final boolean isDaemon()

このスレッドグループがデーモンスレッドグループであるかどうかを試験します。デーモンスレッドグループは、その最後のスレッドが停止する場合、または最後のスレッドグループが破壊される場合には自動的に破棄されます。

返り値:

このスレッドグループがデーモンスレッドグループである場合には true 、デーモンスレッドグループではない場合には false

  public synchronized boolean isDestroyed()

このスレッドグループが破棄されているかどうかを試験します。

  public final void setDaemon(boolean daemon)

このスレッドグループのデーモンの状態を変更します。

まず、このスレッドグループのcheckAccess メソッドが引数を指定されずに呼び出され、その結果セキュリティ例外が生じることがあります。

デーモンスレッドグループは、その最後のスレッドが停止する場合、またはその最後のスレッドグループが破棄される場合、自動的に破棄されます。

パラメータ:

daemon - true の場合、このスレッドグループをデーモンスレッドグループとしてマークし、true ではない場合は、このスレッドグループを一般のものとしてマークする。

例外: SecurityException

現在のスレッドがこのスレッドを修正できない場合

参照:

SecurityException, checkAccess

  public final void setMaxPriority(int pri)

グループの最高優先順位を設定します。

最初に、このスレッドグループの checkAccess が、引数を指定されないで呼び出され、その結果セキュリティ例外が生じることがあります。

すでにさらに高い優先順位が指定されているスレッドグループ内のスレッドは影響を受けません。

パラメータ:

pri - スレッドグループの新規優先順位

例外: SecurityException

カレントスレッドが、このスレッドグループを修正できない場合

参照::

SecurityException, checkAccess

  public final boolean parentOf(ThreadGroup g)

このスレッドグループがスレッドグループ引数であるのか、それともその先祖スレッドグループの内の 1つであるのかを試験します。

パラメータ:

g - スレッドグループ

返り値:

このスレッドグループがスレッドグループ引数であるか、またはその先祖スレッドグループの内の1つである場合には true 、それ以外の場合には false

  public final void checkAccess()

現在実行中のスレッドがこのスレッドグループを修正する許可を得ているかどうかを判断します。

セキュリティマネージャが存在する場合、このグループがその引数として指定され、その checkAccess メソッドが呼び出されます。その結果、 SecurityException がスローされることもあります。

例外: SecurityException

現在のスレッドがこのスレッドグループにアクセスできない場合

参照:

checkAccess

  public int activeCount()

このスレッドグループ内のアクティブスレッドの見積もりを返します。

返り値:

このスレッドグループまたはこのスレッドグループが先祖として指定されるそれ以外のスレッドグループの内のアクティブスレッドの数

  public int enumerate(Thread list[])

このスレッドグループとそのサブグループ内のあらゆるアクティブスレッドを指定された配列の中にコピーします。

アプリケーションは、配列がどの程度の大きさになるのかについての予想を取得する場合は activeCount メソッドを使用する必要があります。配列が短すぎてすべてのスレッドを保持できない場合、余分なスレッドは無視されます。

パラメータ:

list - スレッドのリストの格納先の配列

返り値:

配列に格納されるスレッド数

参照:

activeCount

  public int enumerate(Thread list[],
                       boolean recurse)

このスレッドグループ内のあらゆるアクティブスレッドを指定された配列の中にコピーします。 recurse フラグが true である場合、このスレッドのサブグループ内のあらゆるアクティブスレッドに対する参照も含まれます。配列が短すぎてすべてのスレッドを保持できない場合は、余分なスレッドが暗黙に無視されます。

アプリケーションは、配列がどの程度の大きさになるのかについての予想を取得する場合はactiveCount メソッドを使用する必要があります。

パラメータ:

list - スレッドのリストの格納先の配列

recurse - このスレッドグループのサブグループであるスレッドグループ内のスレッドも含むかどうかを示すフラグ

返り値:

配列の中に格納されるスレッド数

参照:

activeCount

  public int activeGroupCount()

このスレッドグループ内のアクティブグループの見積もりを返します。

返り値:

このスレッドグループが先祖として指定されるアクティブスレッドグループの数

  public int enumerate(ThreadGroup list[])

このスレッドグループ内のあらゆるアクティブサブグループに対する参照を指定された配列にコピーします。

アプリケーションは、配列がどの程度の大きさになるのかについての予想を取得する場合は、activeGroupCount メソッドを使用する必要があります。配列が短すぎてすべてのスレッドグループを保持できない場合、余分なスレッドグループは無視されます。

パラメータ:

list - スレッドグループのリストの格納先の配列

返り値:

配列に格納されるスレッドグループ数

参照:

activeGroupCount

  public int enumerate(ThreadGroup list[],
                       boolean recurse)

このスレッドグループ内のあらゆるアクティブサブグループに対する参照を指定された配列にコピーします。recurse フラグがtrueである場合、サブループなどのすべてのアクティブサブグループに対する参照も含まれます。

アプリケーションは、配列がどの程度の大きさになるのかについての予想を取得する場合は、 activeGroupCount メソッドを使用する必要があります。

パラメータ:

list - スレッドのリストの格納先である配列

recurse - 含まれるすべてのスレッドグループを再帰的に列挙するかどうかを示すフラグ

返り値:

配列の中に格納されるスレッドグループ数

参照:

activeGroupCount

  public final void stop()

このスレッドグループ内のすべてのプロセスを停止します。

まず、このスレッドグループの checkAccess メソッドが引数を指定されないで呼び出されると、その結果セキュリティ例外が生じることがあります。

すると、このメソッドはこのスレッドグループとそのすべてのサブグループ内のすべてのスレッドに対する 停止 メソッドを呼び出します。

例外: SecurityException

カレントスレッドがこのスレッドグループまたはスレッドグループ内のスレッドのどれかにアクセスを許されない場合

参照:

SecurityException, stop, checkAccess

  public final void suspend()

このスレッドグループ内のすべてのプロセスを中断します。

まず、このスレッドグループの checkAccess メソッドが引数を指定されないで呼び出され、その結果セキュリティ例外が生じることがあります。

すると、このメソッドは、このスレッドグループとそのすべてのサブグループ内のすべてのスレッドに対する suspend メソッドを呼び出します。

例外: SecurityException

カレントスレッドが、このスレッドグループまたはスレッドグループ内のスレッドのどれにもアクセスできない場合

参照:

SecurityException, suspend, checkAccess

  public final void resume()

このスレッドグループ内のすべてのプロセスを再開します。

まず、このスレッドグループの checkAccess メソッドが引数を指定されないで呼び出され、その結果セキュリティ例外が生じることがあります。

すると、このメソッドは、このスレッドグループとそのすべてのサブグループ内のすべてのスレッドに対する resume メソッドを呼び出します。

例外: SecurityException

カレントスレッドがこのスレッドグループまたはスレッドグループ内のスレッドのどれにもアクセスできない場合

参照:

SecurityException, resume, checkAccess

  public final void destroy()

このスレッドグループとそのサブグループのすべてを破棄します。このスレッドグループは空となり、このスレッドグループ内にあったすべてのスレッドがそれ以降停止しているかどうかを示さなければなりません。

例外: IllegalThreadStateException

スレッドグループが空である場合、またはスレッドグループがすでに破棄されている場合

例外: SecurityException

カレントスレッドがこのスレッドグループを修正できない場合

  public void list()

このスレッドグループについての情報を標準出力に出力します。このメソッドはデバッグの場合にだけ有効です。

  public void uncaughtException(Thread t,
                                Throwable e)

このスレッドグループ内のスレッドが、キャッチされていない例外のために停止すると、Java 仮想マシン によって呼び出されます。

ThreadGroup の uncaughtException メソッドは以下を実行します。

• このスレッドグループに親スレッドグループがある場合、その親の uncaughtException メソッドは同じ2つの引数が指定されて呼び出されます。
• このスレッドグループに親スレッドグループがない場合は、このメソッドは、 Throwable 引数がThreadDeath のインスタンスであるかどうかを判断します。インスタンスである場合は、特別なことは実行されません。インスタンスではない場合は、スタックバックトレースを標準エラーストリームに出力するためにThrowable の printStackTrace メソッドが呼び出されます。

アプリケーションは、キャッチされていない例外を別の方法で処理するために、 ThreadGroup のサブクラス内のこのメソッドを無効にできます。

パラメータ:

t - 終了するところであるスレッド

e - キャッチされていない例外

参照:

err, ThreadDeath, printStackTrace

  public boolean allowThreadSuspension(boolean b)

メモリ不足による暗黙の中断を制御するために VM によって使用されます。

  public String toString()

このスレッドグループの文字列表記を返します。

返り値:

このスレッドグループの文字列表記

オーバーライド:

クラス Object の toString

全パッケージ  クラス階層  このパッケージ  前項目  次項目  インデックス