java.lang
클래스 ThreadLocal<T>

java.lang.Object 
  java.lang.ThreadLocal<T>

알려진 직계 서브 클래스:

InheritableThreadLocal

public class ThreadLocal<T>
extends Object 

이 클래스는 thread 로컬 변수를 제공합니다. 이러한 변수는 get 메서드 또는 set 메서드를 사용해 액세스 하는 thread가 각각 독자적으로 변수의 초기화된 복사본을 갖는다고 하는 점으로써, 보통 의 변수와 다릅니다. 보통, ThreadLocal 인스턴스는 상태를 thread에 관련지으려고 하는 클래스에서의 private static 필드입니다 (사용자 ID, 트랜잭션(transaction) ID 등).

예를 들어아래의 클래스에서는 private static ThreadLocal 인스턴스 (serialNum)는 클래스의 static SerialNum.get() 메서드를 호출하는 thread 마다 「시리얼 번호」를 관리합니다. thread의 시리얼 번호는 SerialNum.get() 최초의 호출시에 할당할 수 있어 그 후의 호출로 변경될 것은 없습니다.

 public class SerialNum {
     // The next serial number to be assigned
     private static int nextSerialNum = 0;

     private static ThreadLocal serialNum = new ThreadLocal() {
         protected synchronized Object initialValue() {
             return new Integer(nextSerialNum++);
         }
     };

     public static int get() {
         return ((Integer) (serialNum.get())). intValue();
     }
 }
 

각 thread는 thread가 생존하고 있어 ThreadLocal 인스턴스가 액세스 가능한 사이는 thread 로컬 변수의 카피에의 암묵적인 참조를 보관 유지합니다. thread가 종료하면, thread 로컬 인스턴스의 카피는 모두 가비지 컬렉트됩니다 (이러한 카피에의 참조가 그 밖에 존재하는 경우를 제외하다).

도입된 버전 :

1.2

생성자 개요

ThreadLocal ()
thread 로컬 변수를 작성합니다.

메서드 개요

T	get () 이 thread 로컬 변수의 현행 thread의 카피내의 값을 리턴합니다.
protected T	initialValue () 이 thread 로컬 변수에 대한 현재의 thread의 초기값을 리턴합니다.
void	remove () 이 ThreadLocal 값을 삭제합니다.
void	set (T value) 이 thread 로컬 변수의 현재의 thread의 카피가 지정된 값으로 설정합니다.

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

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

생성자 상세

ThreadLocal

public ThreadLocal()

thread 로컬 변수를 작성합니다.

메서드의 상세

initialValue

protected T  initialValue()

이 thread 로컬 변수에 대한 현재의 thread의 초기값을 리턴합니다. 이 메서드는 thread 로컬 마다 액세스 하고 있는 thread 당 1회 만 호출합니다. 최초, thread는 get() 메서드로 변수에 액세스 합니다. thread가 get 메서드를 호출하기 전에 set(T) 메서드를 호출하는 경우, initialValue 메서드는 thread로 불려가 지 않습니다.

이 구현은 단지 null을 돌려줄 뿐입니다. 프로그래머가 thread 로컬 변수를 null 이외의 값으로 초기화하는 경우, ThreadLocal를 상속해, 이 메서드를 오버라이드(override) 할 필요가 있습니다. 보통, 익명의 내부 클래스가 사용됩니다. initialValue 전형적인 구현은 적절한 생성자를 호출해, 새롭게 구축된 객체를 리턴합니다.

반환값:

이 thread 로컬의 초기값

get

public T  get()

이 thread 로컬 변수의 현행 thread의 카피내의 값을 리턴합니다. thread로 처음으로 이 메서드가 불려 갔을 때는 카피가 작성되어 초기화됩니다.

반환값:

이 thread 로컬의 현행 thread의 값

set

public void set(T  value)

이 thread 로컬 변수의 현재의 thread의 카피가 지정된 값으로 설정합니다. thread 로컬의 값을 설정하는데 initialValue() 메서드에 크게 존하고 있는 많은 어플리케이션에서는 이 기능은 필요 없습니다.

파라미터:

value - 이 thread 로컬의 현행 thread의 카피에 포함되는 값

remove

public void remove()

이 ThreadLocal 값을 삭제합니다. 삭제하면, ThreadLocal 포함 요건이 적게 됩니다. 이 ThreadLocal가 한번 더 액세스 되면, ThreadLocal는 디폴트로 initialValue로 설정됩니다.

도입된 버전 :

1.5