Класс Annotation

java.lang.Object

java.text.Annotation

public class Annotation extends Object

Объект Annotation используется как оболочка для значения текстового атрибута, если атрибут обладает характеристиками аннотации. Эти характеристики таковы:

Текстовый диапазон, к которому применяется атрибут, критически важен для семантики этого диапазона. Это означает, что атрибут нельзя применить к поддиапазонам текстового диапазона, к которому он применяется, и, если два смежных текстовых диапазона имеют одинаковое значение этого атрибута, атрибут всё равно нельзя применить к объединённому диапазону в целом с этим значением.
Атрибут или его значение обычно перестают применяться, если исходный текст изменяется.

Примером служит грамматическая информация, связанная с предложением: для предыдущего предложения можно сказать, что «an example» — это подлежащее, но нельзя сказать то же самое об «an», «example» или «exam». При изменении текста грамматическая информация обычно становится недействительной. Другой пример — японская информация о чтении (yomi).

Обёртывание значения атрибута в объект Annotation гарантирует, что смежные фрагменты текста не будут объединены, даже если значения атрибутов совпадают, и указывает текстовым контейнерам, что атрибут следует отбросить, если исходный текст изменён.

Начиная с:

1.2

См. также:

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

Конструктор	Описание
`Annotation(Object value)`	Создаёт запись аннотации с заданным значением, которое может быть null.

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

Модификатор и тип	Метод	Описание
`Object`	`getValue()`	Возвращает значение атрибута, которое может быть null.
`String`	`toString()`	Возвращает строковое представление этого объекта Annotation.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли какой-либо другой объект этому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API может быть удалён в будущей версии. Финализация объявлена устаревшей и может быть удалена в одном из следующих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает значение хеш-кода для этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать, пока он не будет разбужен, обычно посредством вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать, пока он не будет разбужен, обычно посредством вызова notify или interrupt, либо пока не истечёт заданный интервал реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать, пока он не будет разбужен, обычно посредством вызова notify или interrupt, либо пока не истечёт заданный интервал реального времени.

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

Annotation

public Annotation(Object value)

Создаёт запись аннотации с заданным значением, которое может быть null.

Параметры:: value — значение атрибута

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

getValue

public Object getValue()

Возвращает значение атрибута, которое может быть null.

Возвращает:: значение атрибута

toString

public String toString()

Возвращает строковое представление этого объекта Annotation.

Переопределяет:: toString в классе Object
Возвращает:: String представление этого Annotation

© 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.