Класс Аннотация

public class Annotation extends Object

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

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

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

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