compact1, compact2, compact3

java.lang

Class ThreadLocal<T>

java.lang.Object

java.lang.ThreadLocal<T>

已知直接子类：

InheritableThreadLocal

public class ThreadLocal<T>
extends Object

这个类提供线程局部变量。 这些变量与其正常的对应方式不同，因为访问一个的每个线程（通过其get或set方法）都有自己独立初始化的变量副本。 ThreadLocal实例通常是希望将状态与线程关联的类中的私有静态字段（例如，用户ID或事务ID）。

例如，下面的类生成每个线程本地的唯一标识符。 线程的ID在第一次调用ThreadId.get()时被分配，并在后续调用中保持不变。

  import java.util.concurrent.atomic.AtomicInteger;

 public class ThreadId {
     // Atomic integer containing the next thread ID to be assigned
     private static final AtomicInteger nextId = new AtomicInteger(0);

     // Thread local variable containing each thread's ID
     private static final ThreadLocal<Integer> threadId =
         new ThreadLocal<Integer>() {
             @Override protected Integer initialValue() {
                 return nextId.getAndIncrement();
         }
     };

     // Returns the current thread's unique ID, assigning it if necessary
     public static int get() {
         return threadId.get();
     }
 } 

只要线程存活并且ThreadLocal实例可以访问，每个线程都保存对其线程局部变量副本的隐式引用; 线程消失后，线程本地实例的所有副本都将被垃圾收集（除非存在对这些副本的其他引用）。

从以下版本开始：

1.2

构造方法摘要

构造方法

Constructor and Description
ThreadLocal() 创建线程局部变量。

方法摘要

Modifier and Type	Method and Description
T	get() 返回当前线程的此线程局部变量的副本中的值。
protected T	initialValue() 返回此线程局部变量的当前线程的“初始值”。
void	remove() 删除此线程局部变量的当前线程的值。
void	set(T value) 将当前线程的此线程局部变量的副本设置为指定的值。
static <S> ThreadLocal<S>	withInitial(Supplier<? extends S> supplier) 创建线程局部变量。

Methods inherited from class java.lang.Object

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

构造方法详细信息

ThreadLocal

public ThreadLocal()

创建线程局部变量。

另请参见：

withInitial(java.util.function.Supplier)

方法详细信息

initialValue

protected T initialValue()

返回此线程局部变量的当前线程的“初始值”。 该方法将在第一次使用get()方法访问变量时被调用，除非线程先前调用了set(T)方法，在这种情况下， initialValue方法将不会被调用。 通常情况下，这种方法最多每个线程调用一次，但它可能会再次在以后的调用的情况下调用remove()其次是get() 。

这个实现简单地返回null ; 如果程序员希望线程局部变量具有除null之外的初始值，则ThreadLocal必须被子类化，并且该方法被覆盖。 通常，将使用匿名内部类。

结果

这个线程本地的初始值

withInitial

public static <S> ThreadLocal<S> withInitial(Supplier<? extends S> supplier)

创建线程局部变量。 变量的初始值是通过调用get方法来Supplier 。

参数类型

S - 线程本地值的类型

参数

supplier - 用于确定初始值的供应商

结果

一个新的线程本地变量

异常

NullPointerException - 如果指定的供应商为空

从以下版本开始：

1.8

get

public T get()

返回当前线程的此线程局部变量的副本中的值。 如果变量没有当前线程的值，则首先将其初始化为调用initialValue()方法返回的值。

结果

当前线程的线程本身的值

set

public void set(T value)

将当前线程的此线程局部变量的副本设置为指定的值。 大多数子类将无需重写此方法，仅依靠initialValue()方法设置线程本地值的值。

参数

value - 要存储在当前线程的该线程本地的副本中的值。

remove

public void remove()

删除此线程局部变量的当前线程的值。 如果此线程本地变量随后是当前线程的read ，则其值将通过调用其initialValue()方法重新初始化 ，除非其当前线程的值为set 。 这可能导致当前线程中的initialValue方法的多次调用。

从以下版本开始：

1.5