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