Класс ScopedValue<T>

public final class ScopedValue<T> extends Object

    private static final ScopedValue<String> NAME = ScopedValue.newInstance();

    ScopedValue.where(NAME, "duke").run(() -> doSomething());

    ScopedValue.where(NAME, "duke1").run(() -> doSomething());

    ScopedValue.where(NAME, "duke2").run(() -> doSomething());

    ScopedValue.where(NAME, "duchess").run(() -> doMore());

    private static final ScopedValue<String> NAME = ScopedValue.newInstance();

    ScopedValue.where(NAME, "duke").run(() -> {
        try (var scope = StructuredTaskScope.open()) {

             scope.fork(() -> childTask1());
             scope.fork(() -> childTask2());
             scope.fork(() -> childTask3());

             scope.join();

             ..
         }
    });

Примечание API:

В случаях, когда требуется «односторонняя передача» данных без использования параметров методов, следует предпочесть ScopedValue вместо ThreadLocal. Хотя ThreadLocal можно использовать для передачи данных методу без параметров, у такого подхода есть несколько недостатков:

1. ThreadLocal не препятствует удалённому вызываемому коду устанавливать новое значение.
2. У ThreadLocal неограниченный срок жизни, поэтому оно сохраняет значение и после завершения метода, если его явно не удалить.
3. Наследование требует значительных затрат: при создании каждого дочернего потока необходимо копировать карту локальных переменных потока и их значений.

Примечание по реализации:

Значения области видимости предназначены для использования в относительно небольшом количестве. Метод get() сначала выполняет поиск во внешних областях видимости, чтобы найти ближайшую связь значения области видимости. Затем результат поиска кэшируется в небольшом кэше локальных переменных потока. Последующие вызовы get() для этого значения области видимости почти всегда будут очень быстрыми. Однако если программа циклически использует множество значений области видимости, процент попаданий в кэш будет низким, а производительность — неудовлетворительной. Такая конструкция позволяет очень быстро наследовать значения области видимости потокам StructuredTaskScope^{ПРЕДВАРИТЕЛЬНАЯ ВЕРСИЯ}: по сути, достаточно скопировать указатель; для выхода из связи значения области видимости также требуется лишь обновить указатель.

Поскольку кэш значений области видимости для каждого потока невелик, клиентам следует свести к минимуму количество используемых связанных значений. Например, если таким способом необходимо передать несколько значений, имеет смысл создать класс-запись для их хранения, а затем связать одно ScopedValue с экземпляром этой записи.

В этой версии эталонная реализация предоставляет несколько системных свойств для настройки производительности значений области видимости.

Системное свойство java.lang.ScopedValue.cacheSize управляет размером кэша значений области видимости для каждого потока. Этот кэш крайне важен для производительности значений области видимости. Если он слишком мал, библиотеке времени выполнения придётся снова и снова выполнять поиск при каждом вызове get(). Если он слишком велик, память будет расходоваться без необходимости. Размер кэша значений области видимости по умолчанию — 16 записей. Его размер можно изменить в диапазоне от 2 до 16 записей. Значение ScopedValue.cacheSize должно быть целой степенью числа 2.

Например, можно использовать -Djava.lang.ScopedValue.cacheSize=8.

Другое системное свойство — jdk.preserveScopedValueCache. Оно определяет, сохраняется ли кэш значений области видимости для каждого потока, когда виртуальный поток заблокирован. По умолчанию это свойство имеет значение true, то есть каждый виртуальный поток сохраняет свой кэш значений области видимости во время блокировки. Как и в случае с ScopedValue.cacheSize, здесь приходится выбирать между объёмом памяти и скоростью: если многие виртуальные потоки большую часть времени заблокированы, установка значения false может заметно сэкономить память, но после блокирующей операции кэш значений области видимости каждого виртуального потока потребуется создать заново.

Начиная с версии:

25