javax.swing.text.html

Класс HTMLDocument. HTMLReader

java.lang. Объект

javax.swing.text.html.HTMLEditorKit.ParserCallback

javax.swing.text.html.HTMLDocument.HTMLReader

Включение класса:

HTMLDocument

public class HTMLDocument.HTMLReader
extends HTMLEditorKit.ParserCallback

Читатель HTML, чтобы загрузить документ HTML структурой элемента HTML. Это - ряд обратных вызовов от синтаксического анализатора, реализованного, чтобы создать ряд элементов, тегированных с атрибутами. Синтаксический анализ создает маркеры (ElementSpec), которые описывают поддерево элемента, требуемое, и разрывают его в документ при защите блокировки записи, используя метод вставки на документе внешний класс.

Читатель может быть сконфигурирован, регистрируя действия (типа HTMLDocument.HTMLReader.TagAction) это описывает, как обработать действие. Идея позади обеспеченных действий состоит в том, что самые естественные операции редактирования текста могут быть обеспечены, если структура элемента сводится к абзацам с выполнениями некоторого стиля в них. Некоторые вещи более естественно определяются структурно, таким образом, произвольная структура должна быть позволена выше абзацев, но должна будет быть отредактирована со структурными действиями. Импликация этого - то, что некоторые из элементов HTML, определенных в проанализированном потоке, будут свернуты в атрибуты, и в некоторых случаях абзацы будут синтезироваться. Когда элементы HTML были преобразованы в атрибуты, ключ атрибута будет иметь тип HTML.Tag, и значение будет иметь тип AttributeSet так, чтобы никакая информация не была потеряна. Это позволяет многим из существующих действий работать так, чтобы пользователь мог ввести ввод, поразить клавишу Return, возвратить, удалить, и т.д. и иметь разумный результат. Выборы могут быть созданы, и атрибуты, примененные или удаленные, и т.д. С этим в памяти, работа, сделанная читателем, может быть категоризирована в следующие виды задач:

Блок

Создайте структуру как, она определяется в потоке. Это производит элементы, которые содержат другие элементы.

Абзац

Как блок за исключением того, что ожидается, что элемент будет использоваться с представлением абзаца, таким образом, не должен будет быть синтезирован элемент абзаца.

Символ

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

Особенный

Произведите встроенный графический элемент.

Форма

Произведите элемент, который походит на встроенный графический элемент, за исключением того, что ему также связали компонентную модель с этим.

Скрытый

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

В настоящий момент <АППЛЕТ>, <PARAM>, <MAP>, <ОБЛАСТЬ>, <ССЫЛКА>, <СЦЕНАРИЙ> и <СТИЛЬ> неподдерживаются.

Присвоение описанных действий показывают в следующей таблице для тегов, определенных в HTML.Tag.

Тег	Действие
HTML.Tag.A	CharacterAction
HTML.Tag.ADDRESS	CharacterAction
HTML.Tag.APPLET	HiddenAction
HTML.Tag.AREA	AreaAction
HTML.Tag.B	CharacterAction
HTML.Tag.BASE	BaseAction
HTML.Tag.BASEFONT	CharacterAction
HTML.Tag.BIG	CharacterAction
HTML.Tag.BLOCKQUOTE	BlockAction
HTML.Tag.BODY	BlockAction
HTML.Tag.BR	SpecialAction
HTML.Tag.CAPTION	BlockAction
HTML.Tag.CENTER	BlockAction
HTML.Tag.CITE	CharacterAction
HTML.Tag.CODE	CharacterAction
HTML.Tag.DD	BlockAction
HTML.Tag.DFN	CharacterAction
HTML.Tag.DIR	BlockAction
HTML.Tag.DIV	BlockAction
HTML.Tag.DL	BlockAction
HTML.Tag.DT	ParagraphAction
HTML.Tag.EM	CharacterAction
HTML.Tag.FONT	CharacterAction
HTML.Tag.FORM	С 1.4 BlockAction
HTML.Tag.FRAME	SpecialAction
HTML.Tag.FRAMESET	BlockAction
HTML.Tag.H1	ParagraphAction
HTML.Tag.H2	ParagraphAction
HTML.Tag.H3	ParagraphAction
HTML.Tag.H4	ParagraphAction
HTML.Tag.H5	ParagraphAction
HTML.Tag.H6	ParagraphAction
HTML.Tag.HEAD	HeadAction
HTML.Tag.HR	SpecialAction
HTML.Tag.HTML	BlockAction
HTML.Tag.I	CharacterAction
HTML.Tag.IMG	SpecialAction
HTML.Tag.INPUT	FormAction
HTML.Tag.ISINDEX	IsndexAction
HTML.Tag.KBD	CharacterAction
HTML.Tag.LI	BlockAction
HTML.Tag.LINK	LinkAction
HTML.Tag.MAP	MapAction
HTML.Tag.MENU	BlockAction
HTML.Tag.META	MetaAction
HTML.Tag.NOFRAMES	BlockAction
HTML.Tag.OBJECT	SpecialAction
HTML.Tag.OL	BlockAction
HTML.Tag.OPTION	FormAction
HTML.Tag.P	ParagraphAction
HTML.Tag.PARAM	HiddenAction
HTML.Tag.PRE	PreAction
HTML.Tag.SAMP	CharacterAction
HTML.Tag.SCRIPT	HiddenAction
HTML.Tag.SELECT	FormAction
HTML.Tag.SMALL	CharacterAction
HTML.Tag.STRIKE	CharacterAction
HTML.Tag.S	CharacterAction
HTML.Tag.STRONG	CharacterAction
HTML.Tag.STYLE	StyleAction
HTML.Tag.SUB	CharacterAction
HTML.Tag.SUP	CharacterAction
HTML.Tag.TABLE	BlockAction
HTML.Tag.TD	BlockAction
HTML.Tag.TEXTAREA	FormAction
HTML.Tag.TH	BlockAction
HTML.Tag.TITLE	TitleAction
HTML.Tag.TR	BlockAction
HTML.Tag.TT	CharacterAction
HTML.Tag.U	CharacterAction
HTML.Tag.UL	BlockAction
HTML.Tag.VAR	CharacterAction

Однажды </HTML> встречается, Действия больше не уведомляются.

Вложенная Сводка Класса

Вложенные Классы

Модификатор и Тип	Класс и Описание
class	HTMLDocument. HTMLReader. BlockAction
class	HTMLDocument. HTMLReader. CharacterAction
class	HTMLDocument. HTMLReader. FormAction Действие, чтобы поддерживать формы, создавая все элементы, используемые, чтобы представить средства управления формой.
class	HTMLDocument. HTMLReader. HiddenAction
class	HTMLDocument. HTMLReader. IsindexAction
class	HTMLDocument. HTMLReader. ParagraphAction
class	HTMLDocument. HTMLReader. PreAction
class	HTMLDocument. HTMLReader. SpecialAction
class	HTMLDocument. HTMLReader. TagAction Действие, которое будет выполнено в ответ на парсинг тега.

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
protected MutableAttributeSet	charAttr
protected Vector<DefaultStyledDocument.ElementSpec>	parseBuffer

Поля, унаследованные от класса javax.swing.text.html.HTMLEditorKit.ParserCallback

ПОДРАЗУМЕВАЕМЫЙ

Сводка конструктора

Конструкторы

Конструктор и Описание
HTMLDocument.HTMLReader(int offset)
HTMLDocument.HTMLReader(int offset, int popDepth, int pushDepth, HTML.Tag insertTag)

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
protected void	addContent(char[] data, int offs, int length) Добавляет некоторый текст с текущими символьными атрибутами.
protected void	addContent(char[] data, int offs, int length, boolean generateImpliedPIfNecessary) Добавляет некоторый текст с текущими символьными атрибутами.
protected void	addSpecialElement(HTML.Tag t, MutableAttributeSet a) Добавляет контент, который в основном определяется полностью в наборе атрибута.
protected void	blockClose(HTML.Tag t) Добавляет инструкция к буферу синтаксического анализа, чтобы закрыть блочный элемент данного типа.
protected void	blockOpen(HTML.Tag t, MutableAttributeSet attr) Добавляет инструкция к буферу синтаксического анализа, чтобы создать блочный элемент с данными атрибутами.
void	flush() Последний метод, к которому обращаются читатель.
void	handleComment(char[] data, int pos)
void	handleEndOfLineString(String eol) Это вызывается после того, как поток был проанализирован, но прежде flush.
void	handleEndTag(HTML.Tag t, int pos) Обратный вызов от синтаксического анализатора.
void	handleSimpleTag(HTML.Tag t, MutableAttributeSet a, int pos) Обратный вызов от синтаксического анализатора.
void	handleStartTag(HTML.Tag t, MutableAttributeSet a, int pos) Обратный вызов от синтаксического анализатора.
void	handleText(char[] data, int pos) Вызванный синтаксическим анализатором, чтобы указать на блок текста был встречен.
protected void	popCharacterStyle() Выталкивает ранее продвинутый символьный стиль от стека, чтобы возвратиться к предыдущему стилю.
protected void	preContent(char[] data) Добавляет данный контент, с которым встретились в ПРЕД элемент.
protected void	pushCharacterStyle() Продвигает текущий символьный стиль на стеке в подготовке к формированию нового вложенного символьного стиля.
protected void	registerTag(HTML.Tag t, HTMLDocument.HTMLReader.TagAction a) Регистрирует обработчик для данного тега.
protected void	textAreaContent(char[] data) Добавляет данный контент к документу текстовой области.

Методы, унаследованные от класса javax.swing.text.html.HTMLEditorKit.ParserCallback

handleError

Методы java.lang унаследованный от класса. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Полевая Деталь

parseBuffer

protected Vector<DefaultStyledDocument.ElementSpec> parseBuffer

charAttr

protected MutableAttributeSet charAttr

Деталь конструктора

HTMLDocument. HTMLReader

public HTMLDocument.HTMLReader(int offset)

HTMLDocument. HTMLReader

public HTMLDocument.HTMLReader(int offset,
                       int popDepth,
                       int pushDepth,
                       HTML.Tag insertTag)

Деталь метода

сброс

public void flush()
           throws BadLocationException

Последний метод, к которому обращаются читатель. Это позволяет любым изменениям на ожидании быть сброшенными в документ. Так как это в настоящий момент загружается синхронно, весь набор изменений продвигаются в в этой точке.

Переопределения:

flush в классе HTMLEditorKit.ParserCallback

Броски:

BadLocationException

handleText

public void handleText(char[] data,
              int pos)

Вызванный синтаксическим анализатором, чтобы указать на блок текста был встречен.

Переопределения:

handleText в классе HTMLEditorKit.ParserCallback

handleStartTag

public void handleStartTag(HTML.Tag t,
                  MutableAttributeSet a,
                  int pos)

Обратный вызов от синтаксического анализатора. Маршрут к соответствующему обработчику для тега.

Переопределения:

handleStartTag в классе HTMLEditorKit.ParserCallback

handleComment

public void handleComment(char[] data,
                 int pos)

Переопределения:

handleComment в классе HTMLEditorKit.ParserCallback

handleEndTag

public void handleEndTag(HTML.Tag t,
                int pos)

Обратный вызов от синтаксического анализатора. Маршрут к соответствующему обработчику для тега.

Переопределения:

handleEndTag в классе HTMLEditorKit.ParserCallback

handleSimpleTag

public void handleSimpleTag(HTML.Tag t,
                   MutableAttributeSet a,
                   int pos)

Обратный вызов от синтаксического анализатора. Маршрут к соответствующему обработчику для тега.

Переопределения:

handleSimpleTag в классе HTMLEditorKit.ParserCallback

handleEndOfLineString

public void handleEndOfLineString(String eol)

Это вызывается после того, как поток был проанализирован, но прежде flush. eol будет один из \n, \r или \r\n, с которым когда-либо встречаются наиболее в парсинге потока.

Переопределения:

handleEndOfLineString в классе HTMLEditorKit.ParserCallback

С тех пор:

1.3

registerTag

protected void registerTag(HTML.Tag t,
               HTMLDocument.HTMLReader.TagAction a)

Регистрирует обработчик для данного тега. По умолчанию все известные теги будут зарегистрированы. Это может использоваться, чтобы изменить обработку определенного тега или добавить поддержку пользовательских тегов.

pushCharacterStyle

protected void pushCharacterStyle()

Продвигает текущий символьный стиль на стеке в подготовке к формированию нового вложенного символьного стиля.

popCharacterStyle

protected void popCharacterStyle()

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

textAreaContent

protected void textAreaContent(char[] data)

Добавляет данный контент к документу текстовой области. Этот метод вызывают, когда мы находимся в контексте текстовой области. Поэтому весь текст, который замечается, принадлежит текстовой области и следовательно добавляется к TextAreaDocument, связанному с текстовой областью.

предварительный контент

protected void preContent(char[] data)

Добавляет данный контент, с которым встретились в ПРЕД элемент. Это синтезирует строки, чтобы содержать выполнения текста, и делает звонки addContent, чтобы фактически добавить текст.

blockOpen

protected void blockOpen(HTML.Tag t,
             MutableAttributeSet attr)

Добавляет инструкция к буферу синтаксического анализа, чтобы создать блочный элемент с данными атрибутами.

blockClose

protected void blockClose(HTML.Tag t)

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

addContent

protected void addContent(char[] data,
              int offs,
              int length)

Добавляет некоторый текст с текущими символьными атрибутами.

Параметры:

data - контент, чтобы добавить

offs - начальное смещение

length - длина

addContent

protected void addContent(char[] data,
              int offs,
              int length,
              boolean generateImpliedPIfNecessary)

Добавляет некоторый текст с текущими символьными атрибутами.

Параметры:

data - контент, чтобы добавить

offs - начальное смещение

length - длина

generateImpliedPIfNecessary - генерировать ли подразумеваемые абзацы

addSpecialElement

protected void addSpecialElement(HTML.Tag t,
                     MutableAttributeSet a)

Добавляет контент, который в основном определяется полностью в наборе атрибута.