Класс ClassValue<T>
public abstract class ClassValue<T> extends Object
ClassValue для кэширования информации, необходимой для быстрого отправки сообщения, для каждого встреченного класса.- Since:
- 1.7
Краткое описание конструкторов
| Модификатор | Конструктор | Описание |
|---|---|---|
protected |
Единственный конструктор. |
Краткое описание методов
Подробное описание конструкторов
ClassValue
protected ClassValue()
Подробное описание методов
computeValue
protected abstract T computeValue(Class<?> type)
ClassValue. Этот метод будет вызван в первом потоке, который обращается к значению с помощью метода get.
Обычно этот метод вызывается не более одного раза на класс, но он может быть вызван снова, если был вызов remove.
Если этот метод генерирует исключение, соответствующий вызов get завершится аномально с этим исключением, и значение класса не будет записано.
- Параметры:
-
type- тип, значение класса которого необходимо вычислить - Возвращает:
- новое вычисленное значение, связанное с этим
ClassValue, для данного класса или интерфейса - См. также:
get
public T get(Class<?> type)
computeValue. Фактическая установка значения на класс выполняется атомарно. В этот момент, если несколько конкурирующих потоков вычислили значения, одно выбирается и возвращается всем конкурирующим потокам.
Параметр type обычно является классом, но он может быть любого типа, например, интерфейса, примитивного типа (например, int.class) или void.class.
В отсутствие вызовов remove, значение класса имеет простую диаграмму состояния: неинициализированное и инициализированное. При выполнении вызовов remove, правила наблюдения за значением более сложные. См. документацию для remove для получения дополнительной информации.
- Параметры:
-
type- тип, значение класса которого необходимо вычислить или получить - Возвращает:
- текущее значение, связанное с этим
ClassValue, для данного класса или интерфейса - Исключения:
-
NullPointerException- если аргумент равен null - См. также:
remove
public void remove(Class<?> type)
computeValue. Это может привести к дополнительному вызову метода computeValue для данного класса. Чтобы объяснить взаимодействие между вызовами get и remove, мы должны смоделировать переходы состояний значения класса, учитывая чередование между неинициализированными и инициализированными состояниями. Для этого пронумеруем эти состояния последовательно, обращая внимание на то, что неинициализированные (или удаленные) состояния имеют четные номера, а инициализированные (или повторно инициализированные) состояния имеют нечетные номера.
Когда поток T удаляет значение класса в состоянии 2N, ничего не происходит, так как значение класса уже неинициализировано. В противном случае состояние атомарно переходит в состояние 2N+1.
Когда поток T запрашивает значение класса в состоянии 2N, поток сначала пытается инициализировать значение класса в состояние 2N+1 путем вызова computeValue и установки полученного значения.
Когда T пытается установить вновь вычисленное значение, если состояние по-прежнему находится в 2N, значение класса будет инициализировано вычисленным значением, переведя его в состояние 2N+1.
В противном случае, независимо от того, является ли новое состояние четным или нечетным, T отбросит вновь вычисленное значение и повторит операцию get.
Отбрасывание и повторная попытка являются важным условием, так как в противном случае T потенциально мог бы установить катастрофически устаревшее значение. Например:
-
TвызываетCV.get(C)и видит состояние2N -
Tбыстро вычисляет зависящее от времени значениеV0и готовится его установить -
Tсталкивается с неудачным страничным или планировочным событием и засыпает на длительное время - ...тем временем,
T2также вызываетCV.get(C)и видит состояние2N -
T2быстро вычисляет подобное зависящее от времени значениеV1и устанавливает его наCV.get(C) -
T2(или третий поток) затем вызываетCV.remove(C), отменяя работуT2 - предыдущие действия
T2повторяются несколько раз - также, соответствующие вычисленные значения меняются со временем:
V1,V2, ... - ...тем временем,
Tпросыпается и пытается установитьV0; это должно потерпеть неудачу
CV.computeValue использует блокировки для правильного наблюдения за зависящими от времени состояниями при вычислении V1 и т.д. Это не устраняет угрозу устаревшего значения, поскольку существует временной интервал между возвращением computeValue в T и установкой нового значения. Во время этого интервала никакой пользовательской синхронизации невозможна.- Параметры:
-
type- тип, значение класса которого необходимо удалить - Исключения:
-
NullPointerException- если аргумент равен null
© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/lang/ClassValue.html