Класс 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-документе.

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

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

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

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

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

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

Настройка с учетом текущей темы оформления

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

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

Без потери данных

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