Spec-Zone.ru › OpenJDK 25

Интерфейс Constable

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, если создать его невозможно.
Возвращает:
Optional, содержащий полученный номинальный дескриптор, или пустой Optional, если создать его невозможно.

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, включая концептуальные обзоры, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторское право © 1993, 2025, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 1993, 2025, 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/25/docs/api/java.base/java/lang/constant/Constable.html

Spec-Zone.ru

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