java.lang.Object java.lang.ThreadLocal<T>
public class ThreadLocal<T>
该类提供了线程局部 (thread-local) 变量。这些变量不同于它们的普通对应物,因为访问某个变量(通过其 get 或 set 方法)的每个线程都有自己的局部变量,它独立于变量的初始化副本。ThreadLocal 实例通常是类中的 private static 字段,它们希望将状态与某一个线程(例如,用户 ID 或事务 ID)相关联。
例如,以下类生成对每个线程唯一的局部标识符。 线程 ID 是在第一次调用 UniqueThreadIdGenerator.getCurrentThreadId() 时分配的,在后续调用中不会更改。
import java.util.concurrent.atomic.AtomicInteger; public class UniqueThreadIdGenerator { private static final AtomicInteger uniqueId = new AtomicInteger(0); private static final ThreadLocal < Integer > uniqueNum = new ThreadLocal < Integer > () { @Override protected Integer initialValue() { return uniqueId.getAndIncrement(); } }; public static int getCurrentThreadId() { return uniqueId.get(); } } // UniqueThreadIdGenerator
每个线程都保持对其线程局部变量副本的隐式引用,只要线程是活动的并且 ThreadLocal 实例是可访问的;在线程消失之后,其线程局部实例的所有副本都会被垃圾回收(除非存在对这些副本的其他引用)。
构造方法摘要 | |
---|---|
ThreadLocal() 创建一个线程本地变量。 |
方法摘要 | |
---|---|
T |
get() 返回此线程局部变量的当前线程副本中的值。 |
protected T |
initialValue() 返回此线程局部变量的当前线程的“初始值”。 |
void |
remove() 移除此线程局部变量当前线程的值。 |
void |
set(T value) 将此线程局部变量的当前线程副本中的值设置为指定值。 |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
构造方法详细信息 |
---|
public ThreadLocal()
方法详细信息 |
---|
protected T initialValue()
get()
方法访问变量时将调用此方法,但如果线程之前调用了
set(T)
方法,则不会对该线程再调用
initialValue 方法。通常,此方法对每个线程最多调用一次,但如果在调用
get()
后又调用了
remove()
,则可能再次调用此方法。
该实现返回 null;如果程序员希望线程局部变量具有 null 以外的值,则必须为 ThreadLocal 创建子类,并重写此方法。通常将使用匿名内部类完成此操作。
public T get()
initialValue()
方法返回的值。
public void set(T value)
initialValue()
方法来设置线程局部变量的值。
value
- 存储在此线程局部变量的当前线程副本中的值。
public void remove()
initialValue()
方法重新初始化其值。这将导致在当前线程多次调用
initialValue 方法。