Класс 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 для возврата документа, который генерирует другой reader. Чтение управляет тем, как структурирован документ. Хотя 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-документа должна, следовательно, содержать всю информацию, обнаруженную во время чтения документа. Это ограничено необходимостью поддержки редактирования (т. е. иногда требуется нормализация неправильных документов). Руководящим принципом является то, что информация не должна теряться, но может быть синтезирована для создания более корректной модели или переупорядочена.