Класс ThreadLocal<T>

public class ThreadLocal<T> extends Object

Этот класс предоставляет переменные, локальные для потока. Эти переменные отличаются от обычных аналогов тем, что каждый поток, который обращается к такой переменной (с помощью метода get или set), получает собственную, независимо инициализированную копию переменной. Экземпляры ThreadLocal обычно являются закрытыми статическими полями классов, которым требуется связать состояние с потоком (например, идентификатор пользователя или идентификатор транзакции).

Например, приведённый ниже класс генерирует уникальные идентификаторы, локальные для каждого потока. Идентификатор потока присваивается при первом вызове 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 доступен; после завершения потока все его копии экземпляров локальных переменных потока могут быть собраны сборщиком мусора (если на эти копии не существуют другие ссылки).