java.lang
클래스 ThreadLocal

java.lang.Object 
  |
  +--java.lang.ThreadLocal

직계의 기존의 서브 클래스:

InheritableThreadLocal

public class ThreadLocal

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 ()

메소드의 개요

Object	get () 이 thread 로컬 변수의 현행 thread의 카피내의 값을 돌려줍니다.
protected Object	initialValue () 이 thread 로컬인 변수에 대한 현행 thread의 초기치를 돌려줍니다.
void	set (Object value) 이 thread 로컬 변수의 현행 thread의 카피를, 지정된 값으로 설정합니다.

클래스 java.lang. Object 에서 상속받은 메소드

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

생성자의 상세

ThreadLocal

public ThreadLocal()

메소드의 상세

initialValue

protected Object  initialValue()

이 thread 로컬인 변수에 대한 현행 thread의 초기치를 돌려줍니다. 이 메소드는 각 thread 로컬의 thread에 액세스 할 때에 한 번, 각 thread가 get() 또는 set(Object) 메소드를 사용해 최초로 변수에 액세스 할 때에 불려 갑니다. 프로그래머가 thread 로컬 변수를 null 이외의 값으로 초기화하는 경우,ThreadLocal 를 서브 클래스화해, 이 메소드를 오버라이드(override) 할 필요가 있습니다. 통상, 익명의 내부 클래스가 사용됩니다. initialValue 의 전형적인 구현은 적절한 constructor를 호출해, 새롭게 구축된 오브젝트를 돌려줍니다.

반환값:

이 thread 로컬의 초기치

get

public Object  get()

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

반환값:

이 thread 로컬의 현행 thread의 값

set

public void set(Object  value)

이 thread 로컬 변수의 현행 thread의 카피를, 지정된 값으로 설정합니다. 이것은 initialValue 메소드에 의해 대입된 값을 변경하는 경우에만 사용됩니다. 많은 어플리케이션에서는 이 기능은 필요 없습니다.

파라미터:

value - 이 thread 로컬의 현행 thread의 카피에 저장되는 값