Класс Annotation

public class Annotation extends Object

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

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

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

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