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()仍然在后续调用不变。

进口java.util.concurrent.atomic.atomicinteger；公共课就{包含要分配的下一个线程的原子数私有静态最终AtomicInteger nextId =新的AtomicInteger（0）；包含每个线程的标识的线程局部变量私有静态ThreadLocal 
 
        
 
        
 
        
 
        

 
        
        
        
      
        
      <整数>
       
         
       
         
         
         
  
 
         
  
         
  
         
  
         
  就=新的ThreadLocal 
  
         
  
         
  
         
  
         
 
  
         
         
         
       
         
       <整数>
         （）{@Override保护整initialvalue() {nextid getandincrement()返回；}}；返回当前线程唯一的标识号，如果需要的话，指定它public static int get() {就get()返回；}} 
       
 
        
 
        
 
        
 
        

 
        
        
        
      
        
      

每一个线程拥有它的线程局部变量拷贝暗示只要线是活着的ThreadLocal实例访问；螺纹消失后，所有的线程本地实例副本受垃圾收集（除非其他引用这些副本存在）。

从以下版本开始：

一点二

构造方法摘要

构造方法

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

Constructor Detail

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)

创建一个线程局部变量。变量的初始值是通过调用在 Supplier的 get法测定。

参数类型

S -线程本地的值的类型

参数

supplier -供应商来确定初始值

结果

一个新的线程局部变量

异常

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

从以下版本开始：

一点八

get

public T get()

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

结果

这个线程本地的当前线程的值

set

public void set(T value)

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

参数

value -被存储在该线程本地当前线程的值复制。

remove

public void remove()

移除此线程局部变量的当前线程的值。如果线程局部变量随后被 read由当前线程，它的价值将被重新初始化，通过调用其 initialValue()方法，除非它的价值 set在中期当前线程。这可能会导致当前线程的 initialValue方法的多个调用。

从以下版本开始：

一点五