Класс 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. Поддержка редактирования в значительной степени использует возможности текстового пакета.

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

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

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 из текстового пакета.

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

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

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

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

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