Класс HTMLEditorKit

public class HTMLEditorKit extends StyledEditorKit implements Accessible

Компонент Swing JEditorPane поддерживает различные типы содержимого через механизм подключаемых модулей, называемый EditorKit. Поскольку HTML — очень популярный формат содержимого, для него предусмотрена некоторая поддержка по умолчанию. Эта поддержка предоставляется данным классом, который поддерживает HTML версии 3.2 (с некоторыми расширениями) и переходит к версии 4.0. Тег <applet> не поддерживается, но предоставляется некоторая поддержка для тега <object>.

Существует несколько целей, которые преследует предоставленный HTML EditorKit, что влияет на то, как моделируется HTML. Это существенно повлияло на его дизайн.

Поддержка редактирования

Может показаться очевидным, что плагин для JEditorPane должен обеспечивать поддержку редактирования, но это имеет несколько аспектов проектирования. Существует значительное количество HTML-документов, которые не полностью соответствуют спецификации HTML. Для их редактирования они должны быть несколько нормализованы в правильную форму. Кроме того, пользователи не хотят видеть избыточное редактирование структуры, поэтому предпочтительнее использовать традиционные жесты редактирования текста, а не точно следовать структуре HTML-документа.

Моделирование HTML обеспечивается классом HTMLDocument. В его документации описаны подробности моделирования HTML. Поддержка редактирования в значительной степени опирается на пакет text.

Расширяемость/Масштабируемость

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

1. Парсер заменяемый. По умолчанию используется парсер Hot Java, основанный на DTD. Можно использовать другой DTD или полностью другой парсер. Чтобы изменить парсер, переопределите метод getParser. Парсер по умолчанию динамически загружается при первом запросе, поэтому файлы класса никогда не будут загружены, если используется альтернативный парсер. Парсер по умолчанию находится в отдельном пакете с именем parser ниже этого пакета.
2. Парсер управляет ParserCallback, который предоставляется HTMLDocument. Чтобы изменить обработчик, необходимо унаследовать от HTMLDocument и переопределить метод createDefaultDocument для возвращения документа, который создает другой ридер. Ридер контролирует структуру документа. Хотя Document по умолчанию поддерживает HTML, нет ничего, что препятствует поддержке тегов, отличных от HTML, которые приводят к альтернативным структурам элементов.
3. Представления по умолчанию моделей предоставляются в виде иерархии реализаций View, поэтому можно легко настроить отображение конкретного элемента или добавить возможности для новых типов элементов, предоставив новые реализации View. Набор представлений по умолчанию предоставляется классом HTMLFactory. Это можно легко изменить, унаследовав или заменив HTMLFactory и переопределив метод getViewFactory для возвращения альтернативной фабрики.
4. Реализации View в основном работают с атрибутами CSS, которые хранятся в представлениях. Это позволяет иметь несколько представлений, отображаемых на одной модели, которые выглядят существенно по-разному. Это особенно полезно для печати. Для большинства атрибутов HTML атрибуты HTML преобразуются в атрибуты CSS для отображения. Это помогает сделать реализации View более универсальными.

Асинхронная загрузка

Большие документы включают много парсинга и требуют некоторого времени для загрузки. По умолчанию этот набор инструментов создает документы, которые будут загружаться асинхронно, если они загружаются с помощью JEditorPane.setPage. Это контролируется свойством в документе. Метод createDefaultDocument можно переопределить для изменения этого. Упаковку работ выполняет класс HTMLDocument.HTMLReader. Фактическая работа выполняется классами DefaultStyledDocument и AbstractDocument в пакете text.

Настройка текущего LAF

HTML предоставляет хорошо известный набор функций без точного указания характеристик отображения. Swing имеет механизм темы для своих реализаций внешнего вида и ощущения. Желательно, чтобы внешний вид и ощущения передавали характеристики отображения в HTML-представления. Пользователь с плохим зрением, например, захочет высокой контрастности и шрифтов, больших, чем обычно.

Поддержка этого обеспечивается классом StyleSheet. Отображение HTML сильно зависит от значения свойства StyleSheet в EditorKit.

Без потерь

EditorKit имеет возможность чтения и сохранения документов. Обычно для пользователей предпочтительно, если при этих операциях нет потери данных. Политика HTMLEditorKit будет заключаться в хранении не распознаваемых или не обязательно видимых вещей, чтобы они могли быть впоследствии записаны. Модель HTML-документа, следовательно, должна содержать всю информацию, обнаруженную при чтении документа. Это ограничено некоторыми способами необходимостью поддержки редактирования (т.е. иногда некорректные документы должны быть нормализованы). Руководящий принцип заключается в том, что информация не должна теряться, но некоторые из нее могут быть синтезированы для создания более корректной модели или перегруппированы.