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