Класс Вид

public abstract class View
extends Object
implements SwingConstants

Очень важной частью пакета текстовых элементов является класс View. Как следует из названия, он представляет собой представление текстовой модели или фрагмента текстовой модели. Именно этот класс отвечает за внешний вид текстового компонента. Представление не предназначено быть чем-то совершенно новым, что необходимо изучить, а скорее похоже на лёгкий компонент.

По умолчанию представление очень лёгкое. Оно содержит ссылку на родительское представление, из которого оно может извлечь много информации без хранения состояния, и ссылку на часть модели (Element). Представление не обязательно должно точно соответствовать элементу модели, это просто типичное и, следовательно, удобное отображение. В качестве альтернативы представление может поддерживать несколько объектов Position для сохранения своего местоположения в модели (т. е. представлять фрагмент элемента). Это обычно результат форматирования, когда представления разбиваются на части. Удобство существенной связи с элементом облегчает создание фабрик для создания представлений и облегчает отслеживание фрагментов представления по мере изменения модели, и представление должно изменяться в соответствии с моделью. Простые представления, следовательно, непосредственно представляют элемент, а сложные — нет.

Представление отвечает за следующие задачи:

Участие в выкладке.

Представление имеет метод setSize, который похож на doLayout и setSize в Component вместе. Представление имеет метод preferenceChanged, который похож на invalidate в Component, за исключением того, что можно аннулировать только одну ось, и определятся ребёнок, запросивший изменение.

Представление выражает желаемый размер с помощью трёх значений: минимальный, предпочтительный и максимальный размер. Выкладка в представлении может выполняться независимо по каждой оси. Для правильно работающей реализации View минимальный размер будет меньше или равен предпочтительному размеру, который в свою очередь будет меньше или равен максимальному размеру.

Минимальный набор методов для выкладки:

• getMinimumSpan
• getPreferredSpan
• getMaximumSpan
• getAlignment
• preferenceChanged
• setSize

Метод setSize должен быть готов к вызову многократно (т. е. он может вызываться даже если размер не изменился). Метод setSize обычно вызывается, чтобы убедиться, что выкладка View завершена перед выполнением операции над ней, которая требует обновлённой выкладки. Размер представления всегда должен устанавливаться в значение, находящееся между минимальным и максимальным значениями, определёнными этим представлением. Кроме того, представление всегда должно вызывать метод preferenceChanged в родительском элементе, если оно изменило значения выкладки, и ожидает, что родитель учтёт их. Родительское представление не обязано распознавать изменение, пока не будет отправлен preferenceChanged. Это позволяет реализации родительского представления кэшировать требования дочернего элемента, если это необходимо. Последовательность вызовов примерно следующая:

Точная последовательность вызовов зависит от функциональности выкладки родительского представления (если у представления есть дочерние элементы). Представление может собрать предпочтения дочерних элементов перед определением того, что оно даст каждому дочернему элементу, или оно может итеративно обновлять дочерние элементы по одному.

Отображение части модели.

Это делается в методе paint, который практически аналогичен методу рисования компонента. Предполагается, что представления могут заполнять довольно большой деревовидный структуру. У метода View следующие семантики для отрисовки:

• Представление получает свой размер от родительского элемента во время отрисовки, поэтому оно должно быть готово перевыполнять выкладку, если выделенная область отличается от той, с которой оно готово работать.
• Система координат такая же, как у размещающего Component (т. е. Component возвращаемого методом getContainer). Это означает, что дочернее представление находится в той же системе координат, что и родительское представление, если родитель явно не изменил систему координат. Чтобы запланировать перерисовку, представление может вызвать repaint у размещающего Component.
• По умолчанию дочерние элементы не обрезаются. Эффективнее разрешить обрезку представления только если это действительно необходимо.
• Объект Graphics не инициализируется каким-либо образом. Представление должно установить любые необходимые настройки.
• Представление изначально прозрачное. Хотя представление может отображаться в своём полном размере, как правило, так не происходит. Отрисовка выполняется путём обхода дерева реализаций View. Каждое View отвечает за отрисовку своих дочерних элементов. Такое поведение необходимо для обеспечения потокобезопасности. Хотя реализации представлений необязательно должны быть реализованы с учётом потокобезопасности, другие реализации представлений, использующие конкурентность, могут полагаться на обход дерева для обеспечения потокобезопасности.
• Порядок представлений относительно модели зависит от реализации. Хотя дочерние представления, как правило, упорядочиваются в том же порядке, что и в модели, они могут быть визуально расположены в совершенно другом порядке. Реализации представлений могут иметь порядок Z, если дочерние элементы перекрываются.

Методы отрисовки:

• paint

Перевод между системами координат модели и представления.

Поскольку объекты представления производятся фабрикой и, следовательно, не могут гарантировать определённый шаблон, необходимо выполнять преобразования для правильного определения пространственного представления модели. Методы для этого:

• modelToView
• viewToModel
• getDocument
• getElement
• getStartOffset
• getEndOffset

Выкладка должна быть валидной перед выполнением преобразования. Преобразование недействительно и не должно выполняться во время трансляции изменений из модели с помощью DocumentEvent.

Реагирование на изменения в модели.

Если всё представление представлено многими фрагментами (что является наилучшим вариантом, если вы хотите изменить представление и написать меньше нового кода), было бы непрактично иметь большое количество DocumentListener. Если каждое представление прослушивало модель, только несколько из них фактически были бы заинтересованы в изменениях, транслируемых в данный момент. Поскольку модель не знает о представлениях, у неё нет способа отфильтровать передачу информации о изменениях. Вместо этого за распространение информации об изменениях отвечает сама иерархия представлений. На любом уровне иерархии представлений данное представление знает достаточно о своих дочерних элементах, чтобы оптимально распределить информацию о изменениях дальше. Поэтому изменения транслируются, начиная с корня иерархии представлений. Методы для этого:

• insertUpdate
• removeUpdate
• changedUpdate