Вид класса

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

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

Вид выполняет следующие задачи:

Участие в макете.

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

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

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

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

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

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

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

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

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

Методы для рендеринга:

• paint

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

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

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

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

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

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

• insertUpdate
• removeUpdate
• changedUpdate