java.lang
클래스 Thread

java.lang.Object 
  java.lang.Thread

모든 구현된 인터페이스:

Runnable

public class Thread
extends Object 
implements Runnable 

「thread」란 프로그램내에서의 실행 thread입니다. Java 가상 머신에서는 어플리케이션은 병렬에 실행되는 복수의 thread를 사용할 수 있습니다 .

각 thread에는 우선 순위를 붙일 수 있고 있습니다. 우선 순위의 높은 thread는 우선 순위의 낮은 thread보다 우선해 실행됩니다. 게다가 각 thread가 demon로서 마크 되고 있는 경우도 있으면, 되어 있지 않은 경우도 있습니다. 어느 thread로 실행중의 코드가 새로운 Thread 객체를 작성하면, 이 새로운 thread에는 그 시점에서는 작성측의 thread의 우선 순위에 동일한 우선 순위가 설정되어 작성측 thread가 demon인 경우에만, demon thread.

보통, Java 가상 머신이 시작하는 (일반적으로는 있는 지정된 클래스의 main 라는 이름이 붙일 수 있었던 메서드를 호출한다)와 demon thread가 아닌 thread가 1개 존재합니다. Java 가상 머신은 아래의 어떤 것인가의 조건이 발생할 때까지 thread를 계속 실행합니다.

• Runtime 클래스의 exit 메서드가 불려가 시큐러티 매니저가 exit 동작을 허가했다
• run 메서드의 호출로부터 복귀하는 것에의해 또는 run 메서드 이외로부터 보내지는 예외를 Throw 하는 것에의해 demon thread는 아닌 모든 thread가 종료했다

새로운 실행의 thread를 작성하려면 2 방법의 방법이 있습니다. 1개의 방법은 클래스를 Thread 서브 클래스이다고 선언하는 것입니다. 이 서브 클래스는 클래스 Thread run 메서드를 오버라이드(override) 하지 않으면 안됩니다. 그러면 서브 클래스의 인스턴스는 할당할 수 있어 시작될 수가 있습니다. 예를 들어 초기값 보다 큰 소수를 계산하는 thread는 다음에 나타내도록 의해 작성할 수 있습니다.

 class PrimeThread extends Thread { long minPrime; PrimeThread(long minPrime) { this.minPrime = minPrime; }  public void run() { // compute primes larger than minPrime  .  .  .  } } 

다음에 이하에 나타내는 코드로 thread를 작성해, thread의 실행을 개시합니다.

 PrimeThread p = new PrimeThread(143); p.start(); 

thread를 작성하는 이제(이미 ) 1개의 방법은, Runnable인터페이스를 구현하는 클래스를 선언하는 것입니다. 그렇다면, 그 클래스는 run 메서드를 구현합니다. 클래스의 인스턴스를 할당할 수 있어Thread 작성시에 인수로서 건네받아 개시됩니다. 이 방법에서의 같은 예는 이하에 나타내게 됩니다.

 class PrimeRun implements Runnable { long minPrime; PrimeRun(long minPrime) { this.minPrime = minPrime; }  public void run() { // compute primes larger than minPrime  .  .  .  } } 

다음에 이하에 나타내는 코드로 thread를 작성해, thread의 실행을 개시합니다.

 PrimeRun p = new PrimeRun(143); new Thread(p). start(); 

각 thread는 식별을 위한 이름을 가집니다. 복수의 thread가 같은 이름을 가지는 일이 있습니다. thread의 작성시에 이름이 지정되지 않으면 thread에는 새로운 이름이 생성됩니다.

도입된 버전 :

JDK1. 0

관련 항목:

Runnable, Runtime.exit(int), run(), stop()

중첩(Nested) 클래스 개요

static class	Thread.State thread 상태입니다.
static interface	Thread.UncaughtExceptionHandler 캐치 되지 않는 예외에의해 Thread가 갑자기 종료했을 때에 호출되는 것 핸들러의 인터페이스입니다.

필드 개요

static int	MAX_PRIORITY thread로 설정할 수 있는 최고 우선 순위입니다.
static int	MIN_PRIORITY thread로 설정할 수 있는 최저 우선 순위입니다.
static int	NORM_PRIORITY thread에 할당할 수 있는 디폴트의 우선 순위입니다.

생성자 개요

Thread ()
새로운 Thread 객체를 할당합니다.

Thread (Runnable target)
새로운 Thread 객체를 할당합니다.

Thread (Runnable target, String name)
새로운 Thread 객체를 할당합니다.

Thread (String name)
새로운 Thread 객체를 할당합니다.

Thread (ThreadGroup group, Runnable target)
새로운 Thread 객체를 할당합니다.

Thread (ThreadGroup group, Runnable target, String name)
그 실행 객체로서 target, 이름으로서 지정된 name를 가지는 group에 의해 참조되는 thread 그룹에 속하는 것 같은 새로운 Thread 객체를 할당합니다.

Thread (ThreadGroup group, Runnable target, String name, long stackSize)
새로운 Thread 객체를 할당해 실행 객체로서 target을 보관 유지해, 지정된 name를 이름으로서 보관 유지하도록 합니다.

Thread (ThreadGroup group, String name)
새로운 Thread 객체를 할당합니다.

메서드 개요

static int	activeCount () 현행 thread의 thread 그룹내의 활성화된 thread수를 리턴합니다.
void	checkAccess () 현재 실행중의 thread가 이 thread를 변경하기 위한 접근 권한을 가지고 있을지 어떨지를 판정합니다.
int	countStackFrames () 추천하지 않습니다. 이 호출의 정의는 추천 되지 않는 suspend() 에 의존합니다. 또, 이 호출의 결과는 보증되지 않습니다.
static Thread	currentThread () 현재 실행중의 thread 객체의 참조를 리턴합니다.
void	destroy () 추천하지 않습니다. 이 메서드는 원래 클린 업없이 파기되도록 설계되고 있었습니다. 보관 유지되는 모니터는 락 된 상태를 유지합니다. 다만, 이 메서드는 구현되지 않았습니다. 구현되고 있으면, suspend() 와 거의 똑같이 데드 록이 발생합니다. 타겟 thread가 중요한 system resource를 보호하는 락을 보관 유지한 상태로 파기되었을 경우, 어느 thread도 다시 이 자원에 액세스 할 수 없습니다. 다른 thread가 이 자원을 잠그려고 하면, 데드 록이 발생합니다. 보통, 그러한 데드 록은 자신을 「다운 당했다」프로세스로서 표명합니다. 자세한 내용은 「Thread.stop, Thread.suspend 및 Thread.resume가 추천 되지 않는 이유」를 참조하십시오.
static void	dumpStack () 현재의 thread의 스택 트레이스를 출력합니다.
static int	enumerate (Thread [] tarray) 현행 thread의 thread 그룹 및 그 하위 그룹내의 모든 활성화된 thread를, 지정된 배열에 카피합니다.
static Map <Thread, StackTraceElement []>	getAllStackTraces () 모든 라이브 thread의 스택 트레이스 맵을 리턴합니다.
ClassLoader	getContextClassLoader () 이 Thread 컨텍스트 ClassLoader를 리턴합니다.
static Thread.UncaughtExceptionHandler	getDefaultUncaughtExceptionHandler () 캐치 되지 않는 예외에 의해 thread가 갑자기 종료했을 때에 호출되는 디폴트의 핸들러를 리턴합니다.
long	getId () 이 thread의 식별자를 리턴합니다.
String	getName () 이 thread의 이름을 리턴합니다.
int	getPriority () 이 thread의 우선 순위를 리턴합니다.
StackTraceElement []	getStackTrace () 이 thread의 스택 덤프를 나타내는 스택 트레이스 요소의 배열을 리턴합니다.
Thread.State	getState () 이 thread 상태를 리턴합니다.
ThreadGroup	getThreadGroup () 이 thread가 소속하는 thread 그룹을 리턴합니다.
Thread.UncaughtExceptionHandler	getUncaughtExceptionHandler () 캐치 되지 않는 예외에 의해 thread가 갑자기 종료했을 때에 호출되는 핸들러를 리턴합니다.
static boolean	holdsLock (Object obj) 현행 thread가 지정된 객체에 대한 모니터 락을 보관 유지하는 경우에게만, true를 리턴합니다.
void	interrupt () 이 thread에 끼어듭니다.
static boolean	interrupted () 현재의 thread가 끼어들어지고 있는지를 조사합니다.
boolean	isAlive () 이 thread가 생존하고 있을지 어떨지를 판정합니다.
boolean	isDaemon () 이 thread가 demon thread일지 어떨지를 판정합니다.
boolean	isInterrupted () 이 thread가 끼어들어지고 있는 제발을 조사합니다.
void	join () 이 thread가 종료하는 것을 대기합니다.
void	join (long millis) 이 thread가 종료하는 것을 최고로 millis 밀리 세컨드 대기합니다.
void	join (long millis, int nanos) 최고로 millis 밀리 세컨드에 nanos 나노초를 가산한 사이, 이 thread가 종료하는 것을 대기합니다.
void	resume () 추천하지 않습니다. 이 메서드는 데드 록을 발생하기 쉽기 때문에 추천 되지 않습니다. suspend() 와 함께 사용하기 위해인 만큼 제공되고 있습니다. 자세한 내용은 「Thread.stop, Thread.suspend 및 Thread.resume가 추천 되지 않는 이유」를 참조하십시오.
void	run () 이 thread가 별개의 Runnable 실행 객체를 사용해 작성되었을 경우, 그 Runnable 객체의 run 메서드가 호출됩니다.
void	setContextClassLoader (ClassLoader cl) 이 Thread 컨텍스트 ClassLoader를 설정합니다.
void	setDaemon (boolean on) 이 thread를, demon thread 또는 사용자 thread로서 마크 합니다.
static void	setDefaultUncaughtExceptionHandler (Thread.UncaughtExceptionHandler eh) 캐치 되지 않는 예외에의해 thread가 갑자기 종료했을 때나, 이 thread에 대해서 그 밖에 핸들러가 정의되어 있지 않을 때에 호출되는 디폴트의 핸들러를 설정합니다.
void	setName (String name) 이 thread의 이름을 인수 name에 동일해지도록 변경합니다.
void	setPriority (int newPriority) 이 thread의 우선 순위를 변경합니다.
void	setUncaughtExceptionHandler (Thread.UncaughtExceptionHandler eh) 캐치 되지 않는 예외에의해 갑자기 thread가 종료했을 때에 사용되는 핸들러를 설정합니다.
static void	sleep (long millis) 현재 실행중의 thread를, 지정된 밀리 세컨드수의 사이, sleeve (일시적으로 실행을 정지) 시킵니다.
static void	sleep (long millis, int nanos) 현재 실행중의 thread를, 지정된 밀리 세컨드수로 지정된 나노초수를 가산한 사이, sleeve (실행 정지) 시킵니다.
void	start () 이 thread의 실행을 개시합니다.
void	stop () 추천하지 않습니다. 이 메서드는 본질적으로 안전하지는 않습니다. Thread.stop를 사용해 thread를 정지하면, 체크되어 있지 않은 ThreadDeath 예외가 스택아래에서 위에게 전할 수 있었던 결과, 그 thread에 의해 락 되고 있던 모니터의 락이 모두 해제됩니다. 이러한 모니터에 의해 직전까지 보호되고 있던 객체가 정합성의 없는 상태에 있었을 경우, 망가진 객체는 다른 thread에 대해서 가시가 되어, 동작이 보증되지 않는 것이 있습니다. 많은 경우, 타겟 thread의 실행 정지를 지시하려면, stop는 아니고, 단지 일부의 변수를 변경하는 코드를 사용할 필요가 있습니다. 타겟 thread는 이 변수를 정기적으로 체크해, 변수가 실행 정지를 지시하고 있는 경우는 run 메서드로부터 적절히 복귀합니다. 조건 변수등으로 타겟 thread가 오랫동안 대기하고 있는 경우, 대기를 중단시키려면, interrupt 메서드를 사용합니다. 자세한 내용은 「Thread.stop, Thread.suspend 및 Thread.resume가 추천 되지 않는 이유」를 참조하십시오.
void	stop (Throwable obj) 추천하지 않습니다. 이 메서드는 본질적으로 안전하지는 않습니다. stop()를 참조하십시오. 게다가 이 메서드는 타겟 thread로 처리의 준비가 되어 있지 않은 예외의 생성에 사용되는 일이 있는 점에서도 위험합니다 (이 메서드가 없으면 thread에 의해 Throw 될리가 없는 체크된 예외 등). 자세한 내용은 「Thread.stop, Thread.suspend 및 Thread.resume가 추천 되지 않는 이유」를 참조하십시오.
void	suspend () 추천하지 않습니다. 이 메서드는 데드 록을 발생하기 쉽기 때문에 추천 되지 않습니다. 타겟 thread가 중요한 system resource를 보호하고 있는 모니터의 락을 보관 유지하고 있는 상태로 중단되었을 경우, 타겟 thread가 재개될 때까지, 어느 thread도 이 자원에 액세스 할 수 없습니다. 타겟 thread를 재개하려고 하는 thread가resume를 호출하기 전에 이 모니터를 잠그려고 하면, 데드 록이 발생합니다. 보통, 그러한 데드 록은 자신을 「다운 당했다」프로세스로서 표명합니다. 자세한 내용은 「Thread.stop, Thread.suspend 및 Thread.resume가 추천 되지 않는 이유」를 참조하십시오.
String	toString () thread의 이름, 우선 순위, thread 그룹을 포함한 이 thread의 캐릭터 라인 표현을 리턴합니다.
static void	yield () 현재 실행중의 thread 객체를 일시적으로 휴지시켜, 다른 thread를 실행할 수 있도록 합니다.

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

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

필드의 상세

MIN_PRIORITY

public static final int MIN_PRIORITY

thread로 설정할 수 있는 최저 우선 순위입니다.

관련 항목:

정수 필드값

NORM_PRIORITY

public static final int NORM_PRIORITY

thread에 할당할 수 있는 디폴트의 우선 순위입니다.

관련 항목:

정수 필드값

MAX_PRIORITY

public static final int MAX_PRIORITY

thread로 설정할 수 있는 최고 우선 순위입니다.

관련 항목:

정수 필드값

생성자 상세

Thread

public Thread()

새로운 Thread 객체를 할당합니다. 이 생성자는 Thread(null, null, gname)와 같은 효과를 가집니다. 이 경우 gname는 새롭게 작성되는 이름입니다. 자동적으로 작성되는 이름은, n를 정수로 하면 "Thread-"+n 형식을 취합니다.

관련 항목:

Thread(java.lang.ThreadGroup, java.lang.Runnable, java.lang.String)

Thread

public Thread(Runnable  target)

새로운 Thread 객체를 할당합니다. 이 생성자는 Thread(null, target, gname)와 같은 효과를 가집니다. 이 경우 gname는 새롭게 작성되는 이름입니다. 자동적으로 작성되는 이름은, n를 정수로 하면 "Thread-"+n 형식을 취합니다.

파라미터:

target - 그 run 메서드가 호출되는 객체

관련 항목:

Thread(java.lang.ThreadGroup, java.lang.Runnable, java.lang.String)

Thread

public Thread(ThreadGroup  group,
              Runnable  target)

새로운 Thread 객체를 할당합니다. 이 생성자는 Thread(group, target, gname)와 같은 효과를 가집니다. 이 경우 gname는 새롭게 작성되는 이름입니다. 자동적으로 작성되는 이름은, n를 정수로 하면 "Thread-"+n 형식을 취합니다.

파라미터:

group - thread 그룹

target - 그 run 메서드가 호출되는 객체

예외:

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

관련 항목:

Thread(java.lang.ThreadGroup, java.lang.Runnable, java.lang.String)

Thread

public Thread(String  name)

새로운 Thread 객체를 할당합니다. 이 생성자는 Thread(null, null, name)와 같은 효과를 가집니다.

파라미터:

name - 새로운 thread의 이름

관련 항목:

Thread(java.lang.ThreadGroup, java.lang.Runnable, java.lang.String)

Thread

public Thread(ThreadGroup  group,
              String  name)

새로운 Thread 객체를 할당합니다. 이 생성자는 Thread(group, null, name)와 같은 효과를 가집니다.

파라미터:

group - thread 그룹

name - 새로운 thread의 이름

예외:

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

관련 항목:

Thread(java.lang.ThreadGroup, java.lang.Runnable, java.lang.String)

Thread

public Thread(Runnable  target,
              String  name)

새로운 Thread 객체를 할당합니다. 이 생성자는 Thread(null, target, name)와 같은 효과를 가집니다.

파라미터:

target - 그 run 메서드가 호출되는 객체

name - 새로운 thread의 이름

관련 항목:

Thread(java.lang.ThreadGroup, java.lang.Runnable, java.lang.String)

Thread

public Thread(ThreadGroup  group,
              Runnable  target,
              String  name)

그 실행 객체로서 target, 이름으로서 지정된 name를 가지는 group에 의해 참조되는 thread 그룹에 속하는 것 같은 새로운 Thread 객체를 할당합니다.

group가 null로 시큐러티 매니저가 존재하는 경우, 그룹은 시큐러티 매니저의 getThreadGroup 메서드에 의해 정해집니다. group가 null로 시큐러티 매니저가 존재하지 않는 경우, 또는 시큐러티 매니저의 getThreadGroup 메서드가 null을 돌려주는 경우, 그룹은 새로운 thread를 작성중의 thread와 같은 ThreadGroup 로 설정됩니다.

시큐러티 매니저가 존재하는 경우는 ThreadGroup를 인수로서 건네주어 checkAccess 메서드를 호출합니다.

또, getContextClassLoader 메서드 또는 setContextClassLoader 메서드를 오버라이드(override) 하는 서브 클래스의 생성자에 의해 직접적 또는 간접적으로 불려 갔을 때, RuntimePermission("enableContextClassLoaderOverride") 접근 권한을 사용해 checkPermission 메서드를 호출합니다. 그 결과, SecurityException가 발생하는 일이 있습니다.

target인수가 null이 아닌 경우, 이 thread가 시작되면 target run 메서드가 호출됩니다. target 인수가 null인 경우는 이 thread가 시작될 때 이 thread의 run 메서드가 호출됩니다.

새롭게 작성된 thread의 우선 순위는 그 thread를 작성한 thread, 즉 현재 실행중의 thread의 우선 순위와 같게 설정됩니다. 이 우선 순위를 새로운 값으로 변경하는 경우는 메서드 setPriority를 사용할 수 있습니다.

새롭게 작성된 thread는 그것을 작성하는 thread가 demon thread와 마크 되고 있는 경우에만, demon thread와 마크 됩니다. thread가 demon일지 어떨지를 변경하는 경우는 메서드 setDaemon을 사용할 수 있습니다.

파라미터:

group - thread 그룹

target - 그 run 메서드가 호출되는 객체

name - 새로운 thread의 이름

예외:

SecurityException - 현재의 thread가 지정된 thread 그룹내에 thread를 작성할 수 없는 또는 컨텍스트 클래스 로더의 메서드를 오버라이드(override) 할 수 없는 경우

관련 항목:

Runnable.run(), run(), setDaemon(boolean), setPriority(int), ThreadGroup.checkAccess(), SecurityManager.checkAccess(java.lang.Thread)

Thread

public Thread(ThreadGroup  group,
              Runnable  target,
              String  name,
              long stackSize)

새로운 Thread 객체를 할당해 실행 객체로서 target을 보관 유지해, 지정된 name를 이름으로서 보관 유지하도록 합니다. 또, group에 의해 참조되는 thread 그룹에 소속해, 지정된 「스택 사이즈」를 보관 유지합니다.

이 생성자는 thread의 스택 사이즈 지정이 가능한 점을 제외해, Thread(ThreadGroup, Runnable, String) 와 같습니다. 스택 사이즈는 가상 머신을 이 thread의 스택에 할당하는 address 공간의 대략의 바이트수가 됩니다. stackSize 파라미터가 존재하는 경우, 그 효과는 플랫폼에 의해 크게 다릅니다.

몇개의 플랫폼에서는 stackSize 파라미터에 의해 큰 값을 지정하는 것으로 thread가 StackOverflowError를 Throw 하기 전에 의해 큰 회귀 심도를 달성하는 것이 가능하게 됩니다. 같이보다 작은 값을 지정하는 것으로 보다 많은 thread가 OutOfMemoryError (또는 다른 내부 에러)를 Throw 하지 않고, 동시에 존재하는 것이 가능하게 됩니다. stackSize 파라미터의 값과 최대 회귀 심도나 병행 레벨과의 관계는 플랫폼에 따라서 다릅니다. 플랫폼에 따라서는 stackSize 파라미터의 값이 어떤 영향을 주지 않는 경우가 있습니다.

가상 머신은, stackSize 파라미터를 자유롭게 취급해, 지시할 수 있습니다 . 플랫폼에서는 지정된 값이 너무 작은 경우, 가상 머신은 대신에 플랫폼 고유의 최소값을 사용할 수 있습니다. 지정된 값이 너무 큰 경우에는 가상 머신은 대신에 플랫폼 고유의 최대값을 사용할 수 있습니다. 같이 가상 머신은 적절한 경우에는 지정된 값의 절상해 또는 인하를 자유롭게 실행 (또는 완전하게 무시)할 수 있습니다.

stackSize 파라미터에 값제로를 지정하면, 이 생성자는 Thread(ThreadGroup, Runnable, String) 생성자과 정확하게 같은 동작을 실행합니다.

이 생성자 동작은 플랫폼에 따라서 다르기 위해서 신중하게 사용할 필요가 있습니다. 지정된 계산의 실행에 필요한 thread 스택 사이즈는 JRE 구현에 따라서 다를 가능성이 있습니다. 이 때문에 스택 사이즈 파라미터를 주의 깊게 튜닝 하거나 어플리케이션을 실행하는 JRE 구현 마다 튜닝을 반복하거나 하는 것이 필요한 경우가 있습니다.

구현상의 주의점: Java 플랫폼 구현자는 stackSize parameter를 기준으로의해 구현의 동작을 문서화해 두는 것을 추천합니다.

파라미터:

group - thread 그룹

target - 그 run 메서드가 호출되는 객체

name - 새로운 thread의 이름

stackSize - 새로운 thread의 스택 사이즈 또는 제로 (이 파라미터를 무시하는 것을 나타낸다)

예외:

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

메서드의 상세

currentThread

public static Thread  currentThread()

현재 실행중의 thread 객체의 참조를 리턴합니다.

반환값:

현재 실행중의 thread

yield

public static void yield()

현재 실행중의 thread 객체를 일시적으로 휴지시켜, 다른 thread를 실행할 수 있도록 합니다.

sleep

public static void sleep(long millis)
                  throws InterruptedException 

현재 실행중의 thread를, 지정된 밀리 세컨드수의 사이, sleeve (일시적으로 실행을 정지) 시킵니다. thread는 모니터의 소유권을 잃지 않습니다.

파라미터:

millis - 밀리 세컨드 단위의 sleeve 시간의 길이

예외:

InterruptedException - 별의 thread가 현재의 thread에 끼어들었을 경우. 이 예외가 Throw 되면, 현재의 thread의 인터럽트 스테이터스는 클리어 되는

관련 항목:

Object.notify()

sleep

public static void sleep(long millis,
                         int nanos)
                  throws InterruptedException 

현재 실행중의 thread를, 지정된 밀리 세컨드수로 지정된 나노초수를 가산한 사이, sleeve (실행 정지) 시킵니다. thread는 모니터의 소유권을 잃지 않습니다.

파라미터:

millis - 밀리 세컨드 단위의 sleeve 시간의 길이

nanos - sleeve하기 위한 0 ~ 999999 추가 나노초

예외:

IllegalArgumentException - millis 값이 음수의 경우, 또는 nanos 값이 0 ~ 999999 범위외의 경우

InterruptedException - 별의 thread가 현재의 thread에 끼어들었을 경우. 이 예외가 Throw 되면, 현재의 thread의 「인터럽트 스테이터스」는 클리어 되는

관련 항목:

Object.notify()

start

public void start()

이 thread의 실행을 개시합니다. Java 가상 머신은 이 thread의 run 메서드를 호출합니다.

그 결과, (start 메서드에의 호출로부터 복귀한다) 현재의 thread와 (그 run 메서드를 실행한다) 다른 thread라고 하는 2개의 thread가 병렬에 실행됩니다.

thread를 여러 차례 시작하는 것은 결코 올바르다고는 말할 수 없습니다. 특히, thread는 실행을 끝내고 나서 재시작할 수 없습니다.

예외:

IllegalThreadStateException - thread가 이미 시작하고 있었을 경우

관련 항목:

run(), stop()

run

public void run()

이 thread가 별개의 Runnable 실행 객체를 사용해 작성되었을 경우, 그 Runnable 객체의 run 메서드가 호출됩니다. 그렇지 않은 경우, 이 메서드는 아무것도 실시하지 않고 복귀합니다.

Thread 서브 클래스는 이 메서드를 오버라이드(override) 하지 않으면 안됩니다.

정의:

인터페이스 Runnable 내의 run

관련 항목:

start(), stop(), Thread(java.lang.ThreadGroup, java.lang.Runnable, java.lang.String), Runnable.run()

stop

@Deprecated 
public final void stop()

추천하지 않습니다. 이 메서드는 본질적으로 안전하지는 않습니다. Thread.stop를 사용해 thread를 정지하면, 체크되어 있지 않은 ThreadDeath 예외가 스택아래에서 위에게 전할 수 있었던 결과, 그 thread에 의해 락 되고 있던 모니터의 락이 모두 해제됩니다. 이러한 모니터에 의해 직전까지 보호되고 있던 객체가 정합성의 없는 상태에 있었을 경우, 망가진 객체는 다른 thread에 대해서 가시가 되어, 동작이 보증되지 않는 것이 있습니다. 많은 경우, 타겟 thread의 실행 정지를 지시하려면, stop는 아니고, 단지 일부의 변수를 변경하는 코드를 사용할 필요가 있습니다. 타겟 thread는 이 변수를 정기적으로 체크해, 변수가 실행 정지를 지시하고 있는 경우는 run 메서드로부터 적절히 복귀합니다. 조건 변수등으로 타겟 thread가 오랫동안 대기하고 있는 경우, 대기를 중단시키려면, interrupt 메서드를 사용합니다. 자세한 내용은 「Thread.stop, Thread.suspend 및 Thread.resume가 추천 되지 않는 이유」를 참조하십시오.

thread에 강제적으로 실행을 정지시킵니다.

시큐러티 매니저가 인스톨 되고 있는 경우, this를 인수로서 시큐러티 매니저의 checkAccess 메서드가 호출됩니다. 이 결과, 현재의 thread로 SecurityException가 발생되는 일이 있습니다.

또, 이 thread가 현재의 thread와 다른 경우, 즉, 현재의 thread가 자신 이외의 thread를 정지하려고 하고 있는 경우는 RuntimePermission("stopThread")를 인수로서 시큐러티 매니저의 checkPermission 메서드도 호출합니다. 이 경우에도, 현재의 thread로 SecurityException가 발생되는 일이 있습니다.

이 thread에 의해 나타내지는 thread는 그것이 실행하고 있던 동작에 관계없이 강제적으로 이상 정지 당해 새롭게 생성한 ThreadDeath 객체를 예외로서 Throw 합니다.

아직 시작되어 있지 않은 thread를 정지할 수 있습니다 . thread가 최종적으로 시작되자, 곧바로 종료합니다.

어플리케이션은 보통과는 다른 클린 업 동작을 실행해야 하는 경우를 제외해, ThreadDeath를 캐치 해야 하지는 않습니다. 다만, ThreadDeath를 Throw 하면, thread가 정식으로 종료하기 전에 try 문의 finally 절이 실행되는 것에 주의해 주세요. catch 절이 ThreadDeath 객체를 캐치 하는 경우는 thread가 실제로 종료하도록 객체를 Throw 다시 하는 것이 중요합니다.

그렇지 않은 경우, 캐치되어 있지 않은 예외를 취급하는 최고 레벨의 에러 핸들러는 캐치되어 있지 않은 예외가 ThreadDeath 인스턴스이면, 메세지를 출력하거나 어플리케이션에 통지하거나 하는 것은 하지 않습니다.

예외:

SecurityException - 현재의 thread가 이 thread를 변경할 수 없는 경우

관련 항목:

interrupt(), checkAccess(), run(), start(), ThreadDeath, java.lang.Throwable)(java.lang.Thread, , SecurityManager.checkAccess(Thread), SecurityManager.checkPermission(java.security.Permission)

stop

@Deprecated 
public final void stop(Throwable  obj)

추천하지 않습니다. 이 메서드는 본질적으로 안전하지는 않습니다. stop()를 참조하십시오. 게다가 이 메서드는 타겟 thread로 처리의 준비가 되어 있지 않은 예외의 생성에 사용되는 일이 있는 점에서도 위험합니다 (이 메서드가 없으면 thread에 의해 Throw 될리가 없는 체크된 예외 등). 자세한 내용은 「Thread.stop, Thread.suspend 및 Thread.resume가 추천 되지 않는 이유」를 참조하십시오.

thread에 강제적으로 실행을 정지시킵니다.

시큐러티 매니저가 인스톨 되고 있는 경우, 시큐러티 매니저의 checkAccess 메서드가 호출됩니다. 이 결과, 현재의 thread로 SecurityException가 발생되는 일이 있습니다.

또, 이 thread가 현재의 thread와 다른 경우, 즉, 현재의 thread가 자신 이외의 thread를 정지하려고 하고 있는 경우, 또는 obj가 ThreadDeath 인스턴스가 아닌 경우는 RuntimePermission("stopThread")를 인수로서 시큐러티 매니저의 checkPermission 메서드가 호출됩니다. 이 경우에도, 현재의 thread로 SecurityException가 발생되는 일이 있습니다.

인수 obj가 null인 경우, 현재의 thread로 NullPointerException가 발생 됩니다.

이 thread에 의해 나타내지는 thread는 그것이 실행하는 동작에는 관계없이 강제적으로 종료되어 예외로서 Throwable 객체 obj가 발생 됩니다. 이것은 보통에 서는 행해지지 않는 동작이기 때문에 일반적으로 인수를 설정하지 않는 stop 메서드를 사용해 주세요.

아직 시작되어 있지 않은 thread를 정지할 수 있습니다 . thread가 최종적으로 시작되자, 곧바로 종료합니다.

파라미터:

obj - Throw 대상의 Throwable 객체

예외:

SecurityException - 현재의 thread가 이 thread를 변경할 수 없는 경우

관련 항목:

interrupt(), checkAccess(), run(), start(), stop(), SecurityManager.checkAccess(Thread), SecurityManager.checkPermission(java.security.Permission)

interrupt

public void interrupt()

이 thread에 끼어듭니다.

현재의 thread가 자신에게 끼어들지 않은 한 (이 인터럽트는 허가된다), 이 thread의 checkAccess 메서드가 호출됩니다. 이 메서드에의해 SecurityException이 발생되는 경우가 있습니다.

Object 클래스의 wait(), wait(long), 또는 wait(long, int) 메서드의 호출해, 또는 이 클래스의 join(), join(long), join(long, int), sleep(long), 또는 sleep(long, int) 메서드의 호출로 이 thread가 블록 되는 경우, 인터럽트 스테이터스는 클리어 되어InterruptedException를 받습니다.

interruptible channel에 대한 I/O 조작으로 이 thread가 블록 되는 경우, 채널은 닫혀져 thread의 인터럽트 스테이터스가 설정됩니다. 또, thread는 ClosedByInterruptException를 받습니다.

Selector 로 이 thread가 블록 되는 경우, thread의 인터럽트 스테이터스가 설정되어, 선택 조작으로부터 즉석에서 리턴됩니다 . 보통, 리턴된 값은 셀렉터의 wakeup 메서드가 불려 갔을 경우와 같이, 제로 이외의 값이 됩니다.

전술의 조건의 어느 것에도 들어맞지 않는 경우, 이 thread의 인터럽트 스테이터스가 설정됩니다.

예외:

SecurityException - 현재의 thread가 이 thread를 변경할 수 없는 경우

interrupted

public static boolean interrupted()

현재의 thread가 끼어들어지고 있는지를 조사합니다. 이 메서드에 의해 thread의 「인터럽트 스테이터스」가 클리어 됩니다. 즉, 이 메서드가 계속해 2회 불려 갔을 경우, 2번째의 호출은 false를 리턴합니다 (최초의 호출이 끼어들어 스테이터스를 클리어 한 후에 2번째의 호출이 그것을 확인하기 전에 현재의 thread가 한번 더 끼어들어졌을 경우를 제외하다).

반환값:

현재의 thread가 끼어들어지고 있는 경우는 true, 그렇지 않은 경우는 false

관련 항목:

isInterrupted()

isInterrupted

public boolean isInterrupted()

이 thread가 끼어들어지고 있는 제발을 조사합니다. 이 메서드에 의해 thread의 「인터럽트 스테이터스」가 영향을 받을 것은 없습니다.

반환값:

이 thread가 끼어들어지고 있는 경우는 true, 그렇지 않은 경우는 false

관련 항목:

interrupted()

destroy

@Deprecated 
public void destroy()

추천하지 않습니다. 이 메서드는 원래 클린 업없이 파기되도록 설계되고 있었습니다. 보관 유지되는 모니터는 락 된 상태를 유지합니다. 다만, 이 메서드는 구현되지 않았습니다. 구현되고 있으면, suspend() 와 거의 똑같이 데드 록이 발생합니다. 타겟 thread가 중요한 system resource를 보호하는 락을 보관 유지한 상태로 파기되었을 경우, 어느 thread도 다시 이 자원에 액세스 할 수 없습니다. 다른 thread가 이 자원을 잠그려고 하면, 데드 록이 발생합니다. 보통, 그러한 데드 록은 자신을 「다운 당했다」프로세스로서 표명합니다. 자세한 내용은 「Thread.stop, Thread.suspend 및 Thread.resume가 추천 되지 않는 이유」를 참조하십시오.

NoSuchMethodError를 Throw 합니다.

예외:

NoSuchMethodError - 상시

isAlive

public final boolean isAlive()

이 thread가 생존하고 있을지 어떨지를 판정합니다. thread가 시작되고 있어, 아직 종료되어 있지 않은 경우, thread는 생존하고 있습니다.

반환값:

이 thread가 생존하고 있는 경우는 true, 그렇지 않은 경우는 false

suspend

@Deprecated 
public final void suspend()

추천하지 않습니다. 이 메서드는 데드 록을 발생하기 쉽기 때문에 추천 되지 않습니다. 타겟 thread가 중요한 system resource를 보호하고 있는 모니터의 락을 보관 유지하고 있는 상태로 중단되었을 경우, 타겟 thread가 재개될 때까지, 어느 thread도 이 자원에 액세스 할 수 없습니다. 타겟 thread를 재개하려고 하는 thread가resume를 호출하기 전에 이 모니터를 잠그려고 하면, 데드 록이 발생합니다. 보통, 그러한 데드 록은 자신을 「다운 당했다」프로세스로서 표명합니다. 자세한 내용은 「Thread.stop, Thread.suspend 및 Thread.resume가 추천 되지 않는 이유」를 참조하십시오.

이 thread를 중단합니다.

우선, 이 thread의 checkAccess 메서드가 인수없이 호출합니다. 이 결과, 현재의 thread내에서 SecurityException가 발생되는 일이 있습니다.

thread는 생존하고 있는 경우에 중단되어 재개되지 않는 처리를 먼저 진행할 수 없습니다.

예외:

SecurityException - 현재의 thread가 이 thread를 변경할 수 없는 경우

관련 항목:

checkAccess()

resume

@Deprecated 
public final void resume()

추천하지 않습니다. 이 메서드는 데드 록을 발생하기 쉽기 때문에 추천 되지 않습니다. suspend() 와 함께 사용하기 위해인 만큼 제공되고 있습니다. 자세한 내용은 「Thread.stop, Thread.suspend 및 Thread.resume가 추천 되지 않는 이유」를 참조하십시오.

중단된 thread를 재개합니다.

우선, 이 thread의 checkAccess 메서드가 인수없이 호출합니다. 이 결과, 현재의 thread내에서 SecurityException가 발생되는 일이 있습니다.

thread는 생존하고 있지만 중단되고 있는 경우, 실행이 재개되어 처리를 먼저 진행하는 것이 허가됩니다.

예외:

SecurityException - 현재의 thread가 이 thread를 변경할 수 없는 경우

관련 항목:

checkAccess(), suspend()

setPriority

public final void setPriority(int newPriority)

이 thread의 우선 순위를 변경합니다.

우선, 이 thread의 checkAccess 메서드가 인수없이 호출합니다. 이 결과, SecurityException가 발생되는 일이 있습니다.

그렇지 않은 경우, 이 thread의 우선 순위는 지정된 newPriority와 thread의 thread 그룹의 최고 허용 우선 순위 중의 어느 쪽인지 작은 편으로 설정됩니다.

파라미터:

newPriority - 이 thread를 설정하는 우선 순위

예외:

IllegalArgumentException - 우선 순위가 MIN_PRIORITY ~ MAX_PRIORITY 범위외인 경우

SecurityException - 현재의 thread가 이 thread를 변경할 수 없는 경우

관련 항목:

getPriority(), checkAccess(), getPriority(), getThreadGroup(), MAX_PRIORITY, MIN_PRIORITY, ThreadGroup.getMaxPriority()

getPriority

public final int getPriority()

이 thread의 우선 순위를 리턴합니다.

반환값:

이 thread의 우선 순위

관련 항목:

setPriority(int), setPriority(int)

setName

public final void setName(String  name)

이 thread의 이름을 인수 name에 동일해지도록 변경합니다.

우선, 이 thread의 checkAccess 메서드가 인수없이 호출합니다. 이 결과, SecurityException가 발생되는 일이 있습니다.

파라미터:

name - 이 thread의 새로운 이름

예외:

SecurityException - 현재의 thread가 이 thread를 변경할 수 없는 경우

관련 항목:

getName(), checkAccess(), getName()

getName

public final String  getName()

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

반환값:

이 thread의 이름

관련 항목:

setName(java.lang.String), setName(java.lang.String)

getThreadGroup

public final ThreadGroup  getThreadGroup()

이 thread가 소속하는 thread 그룹을 리턴합니다. 이 thread가 종료되고 있는 (정지되고 있다) 경우, 이 메서드는 null을 리턴합니다.

반환값:

이 thread의 thread 그룹

activeCount

public static int activeCount()

현행 thread의 thread 그룹내의 활성화된 thread수를 리턴합니다.

반환값:

현행 thread의 thread 그룹내의 활성화된 thread수

enumerate

public static int enumerate(Thread [] tarray)

현행 thread의 thread 그룹 및 그 하위 그룹내의 모든 활성화된 thread를, 지정된 배열에 카피합니다. 이 메서드는 현행 thread의 thread 그룹의 enumerate 메서드를, 배열 인수를 지정해 호출할 뿐입니다.

시큐러티 매니저가 존재하는 경우, enumerate 메서드는 thread 그룹을 인수로서 시큐러티 매니저의 checkAccess 메서드를 호출합니다. 이 결과, SecurityException가 발생되는 일이 있습니다.

파라미터:

tarray - Thread 객체의 카피처 배열

반환값:

배열에 포함되는 thread수

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkAccess 메서드가 이 조작을 허가하지 않는 경우

관련 항목:

ThreadGroup.enumerate(java.lang.Thread[]), SecurityManager.checkAccess(java.lang.ThreadGroup)

countStackFrames

@Deprecated 
public int countStackFrames()

추천하지 않습니다. 이 호출의 정의는 추천 되지 않는 suspend() 에 의존합니다. 또, 이 호출의 결과는 보증되지 않습니다.

이 thread내의 스택 프레임수를 카운트 합니다. thread는 중단될 필요가 있습니다.

반환값:

이 thread내의 스택 프레임의 수

예외:

IllegalThreadStateException - 이 thread가 중단되지 않는 경우

join

public final void join(long millis)
                throws InterruptedException 

이 thread가 종료하는 것을 최고로 millis 밀리 세컨드 대기합니다. 0 타임 아웃은 영원히 대기하는 것을의미합니다.

파라미터:

millis - 밀리 세컨드 단위의 대기 시간

예외:

InterruptedException - 별의 thread가 현재의 thread에 끼어들었을 경우. 이 예외가 Throw 되면, 현재의 thread의 「인터럽트 스테이터스」는 클리어 된다

join

public final void join(long millis,
                       int nanos)
                throws InterruptedException 

최고로 millis 밀리 세컨드에 nanos 나노초를 가산한 사이, 이 thread가 종료하는 것을 대기합니다.

파라미터:

millis - 밀리 세컨드 단위의 대기 시간

nanos - 대기하기 위한 0 ~ 999999 추가 나노초

예외:

IllegalArgumentException - millis 값이 음수의 경우, 또는 nanos 값이 0 ~ 999999 범위외의 경우

InterruptedException - 별의 thread가 현재의 thread에 끼어들었을 경우. 이 예외가 Throw 되면, 현재의 thread의 「인터럽트 스테이터스」는 클리어 된다

join

public final void join()
                throws InterruptedException 

이 thread가 종료하는 것을 대기합니다.

예외:

InterruptedException - 별의 thread가 현재의 thread에 끼어들었을 경우. 이 예외가 Throw 되면, 현재의 thread의 「인터럽트 스테이터스」는 클리어 된다

dumpStack

public static void dumpStack()

현재의 thread의 스택 트레이스를 출력합니다. 이 메서드는 디버그의 경우에만 사용합니다.

관련 항목:

Throwable.printStackTrace()

setDaemon

public final void setDaemon(boolean on)

이 thread를, demon thread 또는 사용자 thread로서 마크 합니다. Java 가상 머신은 실행중의 thread가 demon thread만으로 되면 종료합니다.

이 메서드는 thread 시작전에 호출할 필요가 있습니다.

이 메서드는 인수없이 이 thread의 checkAccess 메서드를 호출합니다. 이 결과, 현재의 thread로 SecurityException 가 발생되는 일이 있습니다.

파라미터:

on - true인 경우, 이 thread를 demon thread로서 마크 한다

예외:

IllegalThreadStateException - 이 thread가 활성화된 경우

SecurityException - 현재의 thread가 이 thread를 변경할 수 없는 경우

관련 항목:

isDaemon(), checkAccess()

isDaemon

public final boolean isDaemon()

이 thread가 demon thread일지 어떨지를 판정합니다.

반환값:

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

관련 항목:

setDaemon(boolean)

checkAccess

public final void checkAccess()

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

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

주: 이 메서드가 JDK 1.1 에서는 final가 아니었던 것은 잘못입니다. Java 2 플랫폼에서는 final가 되어 있습니다.

예외:

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

관련 항목:

SecurityManager.checkAccess(java.lang.Thread)

toString

public String  toString()

thread의 이름, 우선 순위, thread 그룹을 포함한 이 thread의 캐릭터 라인 표현을 리턴합니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 thread의 캐릭터 라인 표현

getContextClassLoader

public ClassLoader  getContextClassLoader()

이 Thread 컨텍스트 ClassLoader를 리턴합니다. 컨텍스트 ClassLoader는 클래스 및 자원을 로드할 때, 이 thread로 실행중의 코드가 사용하기 위해서 thread의 작성 측에야는 제공됩니다. 컨텍스트 ClassLoader가 설정되어 있지 않은 경우, 디폴트에서는 친 Thread ClassLoader 컨텍스트이 됩니다. 보통, 친thread의 컨텍스트 ClassLoader는 어플리케이션의 로드에 사용되는 클래스 로더로 설정됩니다.

시큐러티 매니저가 존재하는 경우, 호출측의 클래스 로더가 null은 아니고, 컨텍스트 클래스 로더가 요구되고 있는 thread의 컨텍스트 클래스 로더와 같지 않고, 그 컨텍스트 클래스 로더의 상위 객체도 아닐 때는 컨텍스트 ClassLoader를 취득해도 괜찮은지 어떤지를 확인하기 위해서 RuntimePermission("getClassLoader") 접근 권한을 사용해, 시큐러티 매니저의 checkPermission 메서드가 호출됩니다.

반환값:

이 Thread 컨텍스트 ClassLoader

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkPermission 메서드가 컨텍스트 ClassLoader 취득을 허가하지 않는 경우

도입된 버전 :

1.2

관련 항목:

setContextClassLoader(java.lang.ClassLoader), SecurityManager.checkPermission(java.security.Permission), RuntimePermission

setContextClassLoader

public void setContextClassLoader(ClassLoader  cl)

이 Thread 컨텍스트 ClassLoader를 설정합니다. 컨텍스트 ClassLoader는 thread의 작성시로 설정되어 이것에 의해 thread의 작성측은 클래스 및 자원의 로드시에 thread로 실행중의 코드에 적절한 클래스 로더를 제공할 수 있게 됩니다.

시큐러티 매니저가 존재하는 경우, 최초로 컨텍스트 ClassLoader를 설정해도 좋은지 어떤지를 조사하기 위해서 RuntimePermission("setContextClassLoader") 접근 권한을 사용해 checkPermission 메서드가 호출됩니다.

파라미터:

cl - 이 Thread 컨텍스트 ClassLoader

예외:

SecurityException - 현재의 thread가 컨텍스트 ClassLoader를 설정할 수 없는 경우

도입된 버전 :

1.2

관련 항목:

getContextClassLoader(), SecurityManager.checkPermission(java.security.Permission), RuntimePermission

holdsLock

public static boolean holdsLock(Object  obj)

현행 thread가 지정된 객체에 대한 모니터 락을 보관 유지하는 경우에게만, true를 리턴합니다.

이 메서드는 아래와 같이, 프로그램이, 현행 thread가 지정된 락을 이미 보관 유지하고 있는 것을 나타낼 때에 사용됩니다.

     assert Thread.holdsLock(obj);
 

파라미터:

obj - 소유권의 락을 테스트하는 객체

반환값:

현행 thread가 지정된 객체에 대한 모니터 락을 보관 유지하는 경우, true가 리턴된다

예외:

NullPointerException - obj가 null인 경우

도입된 버전 :

1.4

getStackTrace

public StackTraceElement [] getStackTrace()

이 thread의 스택 덤프를 나타내는 스택 트레이스 요소의 배열을 리턴합니다. 이 thread가 시작하고 있지 않았던 경우나 종료하고 있었을 경우, 이 메서드는 제로의 길이의 배열을 리턴합니다. 리턴된 배열이 제로 이외의 길이의 배열인 경우, 배열의 최초의 요소는 스택의 최상부를 나타냅니다. 이것은 순서로 불려 간 최근의 메서드입니다. 배열의 마지막 요소는 스택의 저부를 나타냅니다. 이것은 순서로 불려 간 가장 낡은 메서드입니다.

시큐러티 매니저가 존재해, 이 thread가 현재의 thread가 아닌 경우, 스택 트레이스를 취득해도 좋은지 어떤지를 조사하기 위해서 RuntimePermission("getStackTrace") 접근 권한을 사용해 시큐러티 매니저의 checkPermission 메서드가 호출됩니다.

가상 머신안에는 특정의 상황하로 스택 트레이스로부터 1개 이상의 스택 프레임을 생략 하는 것이 있습니다. 극단적인 경우, 이 thread에 관한 스택 트레이스 정보를 가지지 않는 가상 머신이, 이 메서드로부터 길이 제로의 배열을 돌려주는 것이 허가됩니다.

반환값:

1개의 스택 프레임을 나타내는 StackTraceElement 배열

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkPermission 메서드가 thread의 스택 트레이스의 취득을 허가하지 않는 경우

도입된 버전 :

1.5

관련 항목:

SecurityManager.checkPermission(java.security.Permission), RuntimePermission, Throwable.getStackTrace()

getAllStackTraces

public static Map <Thread,
StackTraceElement []> getAllStackTraces()

모든 라이브 thread의 스택 트레이스 맵을 리턴합니다. 맵 키는 thread입니다. 또, 각 맵의 값은 대응하는 Thread 스택 덤프를 나타내는 StackTraceElement 배열입니다. 리턴된 스택 트레이스는 getStackTrace 메서드에 대해서 지정된 포맷입니다.

이 메서드가 불려가 고 있는 동안에 thread가 실행되고 있을 가능성이 있습니다. 각 thread의 스택 트레이스는 snapshot를 나타낼 뿐입니다. 각 스택 트레이스는 다른 시기에 취득할 수 있습니다. 가상 머신이 thread에 관한 스택 트레이스 정보를 가지지 않는 경우, 맵치에 길이 제로의 배열이 리턴됩니다 .

시큐러티 매니저가 존재해, 이 thread가 현재의 thread가 아닌 경우, 모든 thread의 스택 트레이스를 취득해도 좋은지 어떤지를 조사하기 위해서 RuntimePermission("getStackTrace") 접근 권한과 RuntimePermission("modifyThreadGroup") 접근 권한을 사용해 시큐러티 매니저의 checkPermission 메서드가 호출됩니다.

반환값:

Thread로 부터, 대응하는 thread의 스택 트레이스를 나타내는 StackTraceElement 배열까지의 Map

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkPermission 메서드가 thread의 스택 트레이스의 취득을 허가하지 않는 경우

도입된 버전 :

1.5

관련 항목:

getStackTrace(), SecurityManager.checkPermission(java.security.Permission), RuntimePermission, Throwable.getStackTrace()

getId

public long getId()

이 thread의 식별자를 리턴합니다. thread ID는 thread가 작성되었을 때에 생성된 정의 long 형의 숫자입니다. thread ID는 일의이며, 그 수명을 통해서 변경될 것은 없습니다. thread가 종료하면, thread ID는 재이용 가능합니다.

반환값:

이 thread의 ID

도입된 버전 :

1.5

getState

public Thread.State  getState()

이 thread 상태를 리턴합니다. 이 메서드는 동기 제어용은 아니고, 시스템 상태의 감시에 사용되도록 설계되고 있습니다.

반환값:

이 thread 상태

도입된 버전 :

1.5

setDefaultUncaughtExceptionHandler

public static void setDefaultUncaughtExceptionHandler(Thread.UncaughtExceptionHandler  eh)

캐치 되지 않는 예외에의해 thread가 갑자기 종료했을 때나, 이 thread에 대해서 그 밖에 핸들러가 정의되어 있지 않을 때에 호출되는 디폴트의 핸들러를 설정합니다.

캐치 되지 않는 예외의 취급은 thread에 의해 우선 제어되어 다음에 thread ThreadGroup 객체에의해 최종적으로는 디폴트의 캐치 되지 않는 예외 핸들러에 의해 제어됩니다. thread가 명시적인 캐치 되지 않는 예외 핸들러 세트를 가지지 않는 경우, thread의 thread 그룹 (친thread 그룹을 포함한다)은, uncaughtException 메서드를 특수화 하지 않습니다. 다음에 디폴트 핸들러의 uncaughtException 메서드가 호출됩니다.

디폴트의 캐치 되지 않는 예외 핸들러를 설정하는 것으로 어플리케이션에서는 시스템으로 제공된 「디폴트」의 동작을 이미 받아들이고 있는 thread의 캐치 되지 않는 예외를 취급하는 방법 (특정의 디바이스나 파일에의 로그인등)을 변경할 수 있습니다.　

보통, 디폴트의 캐치 되지 않는 예외 핸들러는 thread의 ThreadGroup 객체와 달라서는 안됩니다. 이것은 무한의 재귀를 부를 가능성이 있기 때문입니다.

파라미터:

eh - 디폴트의 캐치 되지 않는 예외 핸들러로서 사용하는 객체. null인 경우, 디폴트의 핸들러는 없다

예외:

SecurityException - 시큐러티 매니저가 존재해, RuntimePermission ("setDefaultUncaughtExceptionHandler")를 거부했을 경우

도입된 버전 :

1.5

관련 항목:

setUncaughtExceptionHandler(java.lang.Thread.UncaughtExceptionHandler), getUncaughtExceptionHandler(), ThreadGroup.uncaughtException(java.lang.Thread, java.lang.Throwable)

getDefaultUncaughtExceptionHandler

public static Thread.UncaughtExceptionHandler  getDefaultUncaughtExceptionHandler()

캐치 되지 않는 예외에 의해 thread가 갑자기 종료했을 때에 호출되는 디폴트의 핸들러를 리턴합니다. 반환값이 null인 경우, 디폴트의 핸들러는 없습니다.

도입된 버전 :

1.5

관련 항목:

setDefaultUncaughtExceptionHandler(java.lang.Thread.UncaughtExceptionHandler)

getUncaughtExceptionHandler

public Thread.UncaughtExceptionHandler  getUncaughtExceptionHandler()

캐치 되지 않는 예외에 의해 thread가 갑자기 종료했을 때에 호출되는 핸들러를 리턴합니다. 이 thread가 명시적으로 설정된 캐치 되지 않는 예외 핸들러를 가지지 않는 경우, thread가 종료하지 않는 한, thread의 ThreadGroup 객체가 리턴됩니다 . 이 경우 null가 리턴됩니다 .

도입된 버전 :

1.5

setUncaughtExceptionHandler

public void setUncaughtExceptionHandler(Thread.UncaughtExceptionHandler  eh)

캐치 되지 않는 예외에의해 갑자기 thread가 종료했을 때에 사용되는 핸들러를 설정합니다.

캐치 되지 않는 예외 핸들러를 명시적으로 설정하는 것으로 thread는 캐치 되지 않는 예외를 완전하게 제어할 수 있습니다. 이러한 핸들러가 설정되어 있지 않은 경우는 thread의 ThreadGroup 객체가 핸들러로서 기능합니다.

파라미터:

eh - thread의 캐치 되지 않는 예외 핸들러로서 사용되는 객체. null인 경우, thread는 명시적인 핸들러를 가지지 않는다

예외:

SecurityException - 현재의 thread가 이 thread의 변경이 용서되지 않은 경우

도입된 버전 :

1.5

관련 항목:

setDefaultUncaughtExceptionHandler(java.lang.Thread.UncaughtExceptionHandler), ThreadGroup.uncaughtException(java.lang.Thread, java.lang.Throwable)