java.lang
클래스 ThreadGroup

java.lang.Object 
  java.lang.ThreadGroup

모든 구현된 인터페이스:

Thread.UncaughtExceptionHandler

public class ThreadGroup
extends Object 
implements Thread.UncaughtExceptionHandler 

thread 그룹은 thread의 집합을 나타냅니다. 게다가 thread 그룹에는 다른 thread 그룹이 포함되는 일도 있습니다. thread 그룹은 트리를 형성해, 최초의 thread 그룹을 제외해 그 중에 부모를 가집니다.

thread는 그 자체의 thread 그룹에 대한 정보에 액세스 하는 것을 허가되고 있습니다만, 그 thread 그룹의 친thread 그룹 또는 그 다른 thread 그룹에 대한 정보에 액세스 할 수 없습니다.

도입된 버전 :

JDK1. 0

생성자 개요

ThreadGroup (String name)
새로운 thread 그룹을 구축합니다.

ThreadGroup (ThreadGroup parent, String name)
새로운 thread 그룹을 작성합니다.

메서드 개요

int	activeCount () thread 그룹내의 액티브 thread의 대략의 수를 리턴합니다.
int	activeGroupCount () 이 thread 그룹내의 액티브 그룹의 대략의 수를 리턴합니다.
boolean	allowThreadSuspension (boolean b) 추천하지 않습니다. 이 호출의 정의는 추천되어 있지 않은 suspend() 에 의존합니다. 또, 이 호출의 동작은 지정되지 않습니다.
void	checkAccess () 현재 실행중의 thread가 이 thread 그룹을 변경하는 접근 권한을 가지고 있을지 어떨지를 판정합니다.
void	destroy () 이 thread 그룹과 그 소그룹의 모든 것을 파기합니다.
int	enumerate (Thread [] list) 이 thread 그룹과 그 소그룹내의 각 액티브 thread를, 지정된 배열에 카피합니다.
int	enumerate (Thread [] list, boolean recurse) 이 thread 그룹내의 각 액티브 thread를, 지정된 배열에 카피합니다.
int	enumerate (ThreadGroup [] list) 이 thread 그룹내의 각 액티브 소그룹에의 참조를, 지정된 배열에 카피합니다.
int	enumerate (ThreadGroup [] list, boolean recurse) 이 thread 그룹내의 각 액티브 소그룹에의 참조를, 지정된 배열에 카피합니다.
int	getMaxPriority () 이 thread 그룹의 최고 우선 순위를 리턴합니다.
String	getName () 이 thread 그룹의 이름을 리턴합니다.
ThreadGroup	getParent () 이 thread 그룹의 부모를 리턴합니다.
void	interrupt () 이 thread 그룹내의 모든 thread에 끼어듭니다.
boolean	isDaemon () 이 thread 그룹이 demon thread 그룹일지 어떨지를 판정합니다.
boolean	isDestroyed () 이 thread 그룹이 파기되었는지 어떠했는지를 판정합니다.
void	list () 이 thread 그룹에 대한 정보를 표준 출력에 출력합니다.
boolean	parentOf (ThreadGroup g) 이 thread 그룹이 thread 그룹 인수이든가 혹은 게다가 위thread 그룹 중의 1개 일지 어떨지를 판정합니다.
void	resume () 추천하지 않습니다. 이 메서드는 단지 Thread.suspend 및 ThreadGroup.suspend와 조합해 사용됩니다. 모두 데드 록을 발생시키기 쉽기 때문에 추천 되지 않습니다. 자세한 것은 Thread.suspend()를 참조하십시오.
void	setDaemon (boolean daemon) 이 thread 그룹의 demon 상태를 변경합니다.
void	setMaxPriority (int pri) 그룹의 최고 우선 순위를 설정합니다.
void	stop () 추천하지 않습니다. 이 메서드는 본질적으로 안전하지는 않습니다. 자세한 것은 Thread.stop()를 참조하십시오.
void	suspend () 추천하지 않습니다. 이 메서드는 본질적으로 데드 록을 발생시키기 쉬워지고 있습니다. 자세한 것은 Thread.suspend()를 참조하십시오.
String	toString () 이 ThreadGroup 캐릭터 라인 표현을 리턴합니다.
void	uncaughtException (Thread t, Throwable e) 이 thread 그룹내의 thread가 캐치되어 있지 않은 예외를 위해서 정지해, thread에 고유 Thread.UncaughtExceptionHandler 가 갖춰져 있지 않을 때에 Java 가상 머신에 의해 호출합니다.

클래스 java.lang. Object 로부터 상속된 메서드

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

생성자 상세

ThreadGroup

public ThreadGroup(String  name)

새로운 thread 그룹을 구축합니다. 이 새로운 그룹의 부모가 현재 실행중의 thread의 thread 그룹입니다.

친thread 그룹의 checkAccess 메서드는 인수없이 호출합니다. 이 결과, 시큐러티 예외가 발생하는 일이 있습니다.

파라미터:

name - 새로운 thread 그룹의 이름

예외:

SecurityException - 현재의 thread가 지정된 thread 그룹내의 thread를 작성할 수 없는 경우

도입된 버전 :

JDK1. 0

관련 항목:

checkAccess()

ThreadGroup

public ThreadGroup(ThreadGroup  parent,
                   String  name)

새로운 thread 그룹을 작성합니다. 이 새로운 그룹의 부모가 지정된 thread 그룹입니다.

친thread 그룹의 checkAccess 메서드는 인수없이 호출합니다. 이 결과, 시큐러티 예외가 발생하는 일이 있습니다.

파라미터:

parent - 부모의 thread 그룹

name - 새로운 thread 그룹의 이름

예외:

NullPointerException - thread 그룹의 인수가 null인 경우

SecurityException - 현재의 thread가 지정된 thread 그룹내의 thread를 작성할 수 없는 경우

도입된 버전 :

JDK1. 0

관련 항목:

SecurityException, checkAccess()

메서드의 상세

getName

public final String  getName()

이 thread 그룹의 이름을 리턴합니다.

반환값:

이 thread 그룹의 이름

도입된 버전 :

JDK1. 0

getParent

public final ThreadGroup  getParent()

이 thread 그룹의 부모를 리턴합니다.

부모가 null이 아닌 경우, 최초로 친thread 그룹의 checkAccess 메서드가 인수없이 호출합니다. 이 결과, 시큐러티 예외가 발생되는 일이 있습니다.

반환값:

이 thread 그룹의 부모. 부모가 null인 thread 그룹은 톱 레벨의 thread 그룹만

예외:

SecurityException - 현재의 thread가 이 thread 그룹을 변경할 수 없는 경우

도입된 버전 :

JDK1. 0

관련 항목:

checkAccess(), SecurityException, RuntimePermission

getMaxPriority

public final int getMaxPriority()

이 thread 그룹의 최고 우선 순위를 리턴합니다. 이 그룹의 일부인 thread에 최고 우선 순위보다 높은 우선 순위를 지정할 수 없습니다.

반환값:

이 thread 그룹내의 thread로 지정할 수 있는 최고 우선 순위

도입된 버전 :

JDK1. 0

관련 항목:

setMaxPriority(int)

isDaemon

public final boolean isDaemon()

이 thread 그룹이 demon thread 그룹일지 어떨지를 판정합니다. demon thread 그룹은 그 마지막 thread가 정지하는 경우, 또는 마지막 thread 그룹이 파기되는 경우에는 자동적으로 파기됩니다.

반환값:

이 thread 그룹이 demon thread 그룹인 경우는 true, 그렇지 않은 경우는 false

도입된 버전 :

JDK1. 0

isDestroyed

public boolean isDestroyed()

이 thread 그룹이 파기되었는지 어떠했는지를 판정합니다.

반환값:

이 객체가 파기되고 있는 경우는 true

도입된 버전 :

JDK1. 1

setDaemon

public final void setDaemon(boolean daemon)

이 thread 그룹의 demon 상태를 변경합니다.

우선, 이 thread 그룹의 checkAccess 메서드가 인수없이 호출합니다. 이 결과, 시큐러티 예외가 발생되는 일이 있습니다.

demon thread 그룹은 그 마지막 thread가 정지하는 경우, 또는 그 마지막 thread 그룹이 파기되는 경우에 자동적으로 파기됩니다.

파라미터:

daemon - true인 경우는 이 thread 그룹을 demon thread 그룹으로서 마크 해, 그렇지 않은 경우는 이 thread 그룹을 일반의 것으로의해 마크 한다

예외:

SecurityException - 현재의 thread가 이 thread 그룹을 변경할 수 없는 경우

도입된 버전 :

JDK1. 0

관련 항목:

SecurityException, checkAccess()

setMaxPriority

public final void setMaxPriority(int pri)

그룹의 최고 우선 순위를 설정합니다. 이미 또한 높은 우선 순위가 가리키는 thread 그룹내의 thread는 영향을 받지 않습니다.

우선, 이 thread 그룹의 checkAccess 메서드가 인수없이 호출합니다. 이 결과, 시큐러티 예외가 발생되는 일이 있습니다.

pri인수의 값이 Thread.MIN_PRIORITY 보다 작은지, Thread.MAX_PRIORITY 보다 큰 경우, 그룹의 최고 우선 순위는 변경되지 않습니다.

그 외의 경우, 이 ThreadGroup 객체의 우선 순위는 지정된 pri 및 이 thread 그룹의 부모에게 허가되는 최고 우선 순위보다 낮게 설정됩니다 (이 thread 그룹이, 부모를 가지지 않는 시스템 thread 그룹의 경우, 그 최고 우선 순위는 pri인 만큼 설정된다). 그 후, 이 thread 그룹에 속하는 thread 그룹 마다, 이 메서드가 pri를 인수로서 재귀적으로 호출합니다.

파라미터:

pri - thread 그룹의 새로운 우선 순위

예외:

SecurityException - 현재의 thread가 이 thread 그룹을 변경할 수 없는 경우

도입된 버전 :

JDK1. 0

관련 항목:

getMaxPriority(), SecurityException, checkAccess()

parentOf

public final boolean parentOf(ThreadGroup  g)

이 thread 그룹이 thread 그룹 인수이든가 혹은 게다가 위thread 그룹 중의 1개 일지 어떨지를 판정합니다.

파라미터:

g - thread 그룹

반환값:

이 thread 그룹이 thread 그룹 인수인지, 또는 게다가 위thread 그룹 중의 1개 인 경우는 true, 그렇지 않은 경우는 false

도입된 버전 :

JDK1. 0

checkAccess

public final void checkAccess()

현재 실행중의 thread가 이 thread 그룹을 변경하는 접근 권한을 가지고 있을지 어떨지를 판정합니다.

시큐러티 매니저가 존재하는 경우, 이 그룹이 그 인수로서 지정되어 그 checkAccess 메서드가 호출됩니다. 그 결과, SecurityException가 발생되는 일이 있습니다.

예외:

SecurityException - 현재의 thread가 이 thread 그룹에의 액세스가 용서되지 않은 경우

도입된 버전 :

JDK1. 0

관련 항목:

SecurityManager.checkAccess(java.lang.ThreadGroup)

activeCount

public int activeCount()

thread 그룹내의 액티브 thread의 대략의 수를 리턴합니다. 결과에는 동시의 액티버티가 반영되지 않을 가능성이 있어, 특정의 시스템 thread의 존재에 의해 영향을 받을 가능성이 있습니다.

결과는 본질적으로 부정확한 성질을 가지기 때문에 이 메서드는 정보 목적인 만큼 사용하는 것을 추천합니다.

반환값:

이 thread 그룹내, 또는 이 thread 그룹을 상위에 가지는 그 외의 thread 그룹 중의 액티브 thread의 대략의 수

도입된 버전 :

JDK1. 0

enumerate

public int enumerate(Thread [] list)

이 thread 그룹과 그 소그룹내의 각 액티브 thread를, 지정된 배열에 카피합니다.

우선, 이 thread 그룹의 checkAccess 메서드가 인수없이 호출합니다. 이 결과, 시큐러티 예외가 발생되는 일이 있습니다.

어플리케이션에서는 배열이 어느 정도의 크기가 될까에 임해서 대략의 수를 얻는인 경우 activeCount 메서드를 사용하는 경우가 있습니다. 다만, 배열이 너무 작아 모든 thread를 보관 유지할 수 없는 경우, 여분의 thread는 통지없이 무시됩니다. 이 thread 그룹과 그 소그룹에 있는 모든 액티브 thread를 얻는 것이 중요한 경우, 호출측은 리턴된 정수값이 엄밀하게 list 길이 미만인 것을 확인할 필요가 있습니다.

이 메서드의 본질적인 경합 조건이기 때문에 이 메서드는 정보 목적인 만큼 사용하는 것을 추천합니다.

파라미터:

list - thread의 리스트의 포함처인 배열

반환값:

배열에 포함되는 thread수

예외:

SecurityException - 현재의 thread에 이 thread 그룹을 열거하기 위한 접근 권한이 없는 경우

도입된 버전 :

JDK1. 0

관련 항목:

activeCount(), checkAccess()

enumerate

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

이 thread 그룹내의 각 액티브 thread를, 지정된 배열에 카피합니다. recurse 플래그가 true인 경우, 이 thread의 소그룹내의 각 액티브 thread에의 참조도 포함됩니다. 배열이 너무 작아 모든 thread를 보관 유지할 수 없는 경우, 여분의 thread는 통지없이 무시됩니다.

우선, 이 thread 그룹의 checkAccess 메서드가 인수없이 호출합니다. 이 결과, 시큐러티 예외가 발생되는 일이 있습니다.

어플리케이션에서는 배열이 어느 정도의 크기가 될까에 임해서 대략의 수를 얻는인 경우 activeCount 메서드를 사용하는 경우가 있습니다. 다만, 배열이 너무 작아 모든 thread를 보관 유지할 수 없는 경우, 여분의 thread는 통지없이 무시됩니다. 이 thread 그룹에 있는 모든 액티브 thread를 얻는 것이 중요한 경우, 호출측은 리턴된 정수값이 엄밀하게 list 길이 미만인 것을 확인할 필요가 있습니다.

이 메서드의 본질적인 경합 조건이기 때문에 이 메서드는 정보 목적인 만큼 사용하는 것을 추천합니다.

파라미터:

list - thread의 리스트의 포함처인 배열

recurse - 이 thread 그룹의 소그룹인 thread 그룹내의 thread도 포함할지 어떨지를 나타내는 플래그

반환값:

배열에 포함되는 thread수

예외:

SecurityException - 현재의 thread에 이 thread 그룹을 열거하기 위한 접근 권한이 없는 경우

도입된 버전 :

JDK1. 0

관련 항목:

activeCount(), checkAccess()

activeGroupCount

public int activeGroupCount()

이 thread 그룹내의 액티브 그룹의 대략의 수를 리턴합니다. 결과에는 동시의 액티버티가 반영되지 않을 가능성이 있습니다.

결과는 본질적으로 부정확한 성질을 가지기 때문에 이 메서드는 정보 목적인 만큼 사용하는 것을 추천합니다.

반환값:

이 thread 그룹을 상위에 가지는 액티브 thread 그룹의 수

도입된 버전 :

JDK1. 0

enumerate

public int enumerate(ThreadGroup [] list)

이 thread 그룹내의 각 액티브 소그룹에의 참조를, 지정된 배열에 카피합니다.

우선, 이 thread 그룹의 checkAccess 메서드가 인수없이 호출합니다. 이 결과, 시큐러티 예외가 발생되는 일이 있습니다.

어플리케이션에서는 배열이 어느 정도의 크기가 될까에 임해서 대략의 수를 얻는인 경우 activeGroupCount 메서드를 사용하는 경우가 있습니다. 다만, 배열이 너무 작아 모든 thread 그룹을 보관 유지할 수 없는 경우, 여분의 thread는 통지없이 무시됩니다. 이 thread 그룹에 있는 모든 액티브 소그룹을 얻는 것이 중요한 경우, 호출측은 리턴된 정수값이 엄밀하게 list 길이 미만인 것을 확인할 필요가 있습니다.

이 메서드의 본질적인 경합 조건이기 때문에 이 메서드는 정보 목적인 만큼 사용하는 것을 추천합니다.

파라미터:

list - thread 그룹의 리스트의 포함처의 배열

반환값:

배열에 포함되는 thread 그룹수

예외:

SecurityException - 현재의 thread에 이 thread 그룹을 열거하기 위한 접근 권한이 없는 경우

도입된 버전 :

JDK1. 0

관련 항목:

activeGroupCount(), checkAccess()

enumerate

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

이 thread 그룹내의 각 액티브 소그룹에의 참조를, 지정된 배열에 카피합니다. recurse 플래그가 true인 경우, 소그룹등의 모든 액티브 소그룹에의 참조도 포함됩니다.

우선, 이 thread 그룹의 checkAccess 메서드가 인수없이 호출합니다. 이 결과, 시큐러티 예외가 발생되는 일이 있습니다.

어플리케이션에서는 배열이 어느 정도의 크기가 될까에 임해서 대략의 수를 얻는인 경우 activeGroupCount 메서드를 사용하는 경우가 있습니다. 다만, 배열이 너무 작아 모든 thread 그룹을 보관 유지할 수 없는 경우, 여분의 thread는 통지없이 무시됩니다. 이 thread 그룹에 있는 모든 액티브 소그룹을 얻는 것이 중요한 경우, 호출측은 리턴된 정수값이 엄밀하게 list 길이 미만인 것을 확인할 필요가 있습니다.

이 메서드의 본질적인 경합 조건이기 때문에 이 메서드는 정보 목적인 만큼 사용하는 것을 추천합니다.

파라미터:

list - thread의 리스트의 포함처인 배열

recurse - 포함되는 모든 thread 그룹을 재귀적으로 열거할지 어떨지를 나타내는 플래그

반환값:

배열에 포함되는 thread 그룹수

예외:

SecurityException - 현재의 thread에 이 thread 그룹을 열거하기 위한 접근 권한이 없는 경우

도입된 버전 :

JDK1. 0

관련 항목:

activeGroupCount(), checkAccess()

stop

@Deprecated 
public final void stop()

추천하지 않습니다. 이 메서드는 본질적으로 안전하지는 않습니다. 자세한 것은 Thread.stop()를 참조하십시오.

이 thread 그룹내의 모든 thread를 정지합니다.

우선, 이 thread 그룹의 checkAccess 메서드가 인수없이 호출합니다. 이 결과, 시큐러티 예외가 발생되는 일이 있습니다.

다음에 이 메서드는 이 thread 그룹과 그 모든 소그룹내의 모든 thread에 대해 stop 메서드를 호출합니다.

예외:

SecurityException - 현재의 thread가 이 thread 그룹 또는 thread 그룹내의 thread에의 액세스가 허가되지 않는 경우

도입된 버전 :

JDK1. 0

관련 항목:

SecurityException, Thread.stop(), checkAccess()

interrupt

public final void interrupt()

이 thread 그룹내의 모든 thread에 끼어듭니다.

우선, 이 thread 그룹의 checkAccess 메서드가 인수없이 호출합니다. 이 결과, 시큐러티 예외가 발생되는 일이 있습니다.

다음에 이 메서드는 이 thread 그룹과 그 모든 소그룹내의 모든 thread에 대해 interrupt 메서드를 호출합니다.

예외:

SecurityException - 현재의 thread가 이 thread 그룹 또는 thread 그룹내의 thread에의 액세스가 허가되지 않는 경우

도입된 버전 :

1.2

관련 항목:

Thread.interrupt(), SecurityException, checkAccess()

suspend

@Deprecated 
public final void suspend()

추천하지 않습니다. 이 메서드는 본질적으로 데드 록을 발생시키기 쉬워지고 있습니다. 자세한 것은 Thread.suspend()를 참조하십시오.

이 thread 그룹내의 모든 thread를 정지합니다.

우선, 이 thread 그룹의 checkAccess 메서드가 인수없이 호출합니다. 이 결과, 시큐러티 예외가 발생되는 일이 있습니다.

다음에 이 메서드는 이 thread 그룹과 그 모든 소그룹내의 모든 thread에 대해 suspend 메서드를 호출합니다.

예외:

SecurityException - 현재의 thread가 이 thread 그룹 또는 thread 그룹내의 thread에의 액세스가 허가되지 않는 경우

도입된 버전 :

JDK1. 0

관련 항목:

Thread.suspend(), SecurityException, checkAccess()

resume

@Deprecated 
public final void resume()

추천하지 않습니다. 이 메서드는 단지 Thread.suspend 및 ThreadGroup.suspend와 조합해 사용됩니다. 모두 데드 록을 발생시키기 쉽기 때문에 추천 되지 않습니다. 자세한 것은 Thread.suspend()를 참조하십시오.

이 thread 그룹내의 모든 thread를 재개합니다.

우선, 이 thread 그룹의 checkAccess 메서드가 인수없이 호출합니다. 이 결과, 시큐러티 예외가 발생되는 일이 있습니다.

다음에 이 메서드는 이 thread 그룹과 그 모든 소그룹내의 모든 thread에 대해 resume 메서드를 호출합니다.

예외:

SecurityException - 현재의 thread가 이 thread 그룹 또는 thread 그룹내의 thread에의 액세스가 허가되지 않는 경우

도입된 버전 :

JDK1. 0

관련 항목:

SecurityException, Thread.resume(), checkAccess()

destroy

public final void destroy()

이 thread 그룹과 그 소그룹의 모든 것을 파기합니다. 이 thread 그룹내에 있던 모든 thread가 정지되고 있는 것, 즉, 이 thread 그룹이 비어있지 않으면 안됩니다.

우선, 이 thread 그룹의 checkAccess 메서드가 인수없이 호출합니다. 이 결과, 시큐러티 예외가 발생되는 일이 있습니다.

예외:

IllegalThreadStateException - thread 그룹이 비어있지 않은 경우, 또는 thread 그룹이 이미 파기되고 있는 경우

SecurityException - 현재의 thread가 이 thread 그룹을 변경할 수 없는 경우

도입된 버전 :

JDK1. 0

관련 항목:

checkAccess()

list

public void list()

이 thread 그룹에 대한 정보를 표준 출력에 출력합니다. 이 메서드는 디버그의 경우에만 도움이 됩니다.

도입된 버전 :

JDK1. 0

uncaughtException

public void uncaughtException(Thread  t,
                              Throwable  e)

이 thread 그룹내의 thread가 캐치되어 있지 않은 예외를 위해서 정지해, thread에 고유 Thread.UncaughtExceptionHandler 가 갖춰져 있지 않을 때에 Java 가상 머신에 의해 호출합니다.

ThreadGroup uncaughtException 메서드는 이하를 실행합니다.

• 이 thread 그룹에 친thread 그룹이 있는 경우, 그 부모의 uncaughtException 메서드는 같은 2개의 인수가 지정되어 불려 간다
• 그렇지 않은 경우, 이 메서드는디폴트의 캐치 되지 않는 예외 핸들러가 갖춰져 있을지 어떨지를 체크한다. 갖춰져 있는 경우는 같은 2개의 인수를 사용해 uncaughtException 메서드가 불려 간다
• 그렇지 않은 경우, 이 메서드는 Throwable인수가 ThreadDeath 인스턴스일지 어떨지를 판정한다. 이 인스턴스인 경우는 특별한 (일)것은 실행되지 않는다. 이 인스턴스가 아닌 경우, Throwable printStackTrace 메서드를 사용해, thread의 getName 메서드로부터 리턴된 thread명을 포함한 메세지와 스택 백 트레이스가표준 에러 스트림에 출력된다

어플리케이션은, ThreadGroup 서브 클래스에서 이 메서드를 오버라이드(override) 해, 캐치되어 있지 않은 예외를 다른 방법으로 처리할 수 있습니다 .

정의:

인터페이스 Thread.UncaughtExceptionHandler 내의 uncaughtException

파라미터:

t - 종료하려고 하고 있는 thread

e - 캐치되어 있지 않은 예외

도입된 버전 :

JDK1. 0

allowThreadSuspension

@Deprecated 
public boolean allowThreadSuspension(boolean b)

추천하지 않습니다. 이 호출의 정의는 추천되어 있지 않은 suspend() 에 의존합니다. 또, 이 호출의 동작은 지정되지 않습니다.

메모리 부족에 한 암묵의 중단을 제어하기 위해서 VM에 의해 사용됩니다.

파라미터:

b - 중단을 가능 또는 불가로 하는 불리언 값

반환값:

성공했을 경우는 true

도입된 버전 :

JDK1. 1

toString

public String  toString()

이 ThreadGroup 캐릭터 라인 표현을 리턴합니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 thread 그룹의 캐릭터 라인 표현

도입된 버전 :

JDK1. 0