Spec-Zone.ru › OpenJDK 17

Интерфейс Constable

Все известные подинтерфейсы:
MemoryLayout
public interface Constable
Представляет тип, который является постоянным. Постоянный тип — это тип, значения которого являются константами, которые могут быть представлены в пуле констант файла Java-класса, как описано в JVMS 4.4, и чьи экземпляры могут описывать себя номинально как ConstantDesc.

Некоторые постоянные типы имеют собственное представление в пуле констант: String, Integer, Long, Float, Double, Class, MethodType и MethodHandle. Типы String, Integer, Long, Float и Double служат своими номинальными описателями; Class, MethodType и MethodHandle имеют соответствующие номинальные описатели ClassDesc, MethodTypeDesc и MethodHandleDesc.

Другие типы ссылок могут быть постоянными, если их экземпляры могут описывать себя в номинальной форме как ConstantDesc. Примерами в API платформы Java SE являются типы, поддерживающие языковые возможности Java, такие как Enum, и классы поддержки выполнения, такие как VarHandle. Обычно они описываются с помощью DynamicConstantDesc, который описывает динамически сгенерированные константы (JVMS 4.4.10).

Номинальная форма экземпляра постоянного типа получается с помощью describeConstable(). Constable не обязательно должен (или может не захотеть) описывать все свои экземпляры в виде ConstantDesc; этот метод возвращает Optional, который может быть пустым, чтобы указать, что номинальный описатель не мог быть создан для экземпляра. (Например, MethodHandle будет генерировать номинальные описатели для прямых обработчиков методов, но не обязательно для тех, которые создаются комбинирующими обработчиками методов.)

См. Спецификацию виртуальной машины Java:
4.4 Пул констант
4.4.10 Структуры CONSTANT_Dynamic_info и CONSTANT_InvokeDynamic_info
С момента:
12

Краткое описание методов

Модификатор и тип Метод Описание
Optional<? extends ConstantDesc> describeConstable()
Возвращает Optional, содержащий номинальный описатель для этого экземпляра, если он может быть построен, или пустой Optional, если он не может быть построен.

Подробное описание методов

describeConstable

Optional<? extends ConstantDesc> describeConstable()
Возвращает Optional, содержащий номинальный описатель для этого экземпляра, если он может быть построен, или пустой Optional, если он не может быть построен.
Возвращает:
An Optional содержащий результирующий номинальный описатель, или пустой Optional, если он не может быть построен.

© 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/constant/Constable.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API