Класс HTMLWriter

java.lang.Object

javax.swing.text.AbstractWriter

javax.swing.text.html.HTMLWriter

public class HTMLWriter extends AbstractWriter

Средство записи для HTMLDocument.

Краткое описание полей

Поля, объявленные в классе AbstractWriter

NEWLINE

Модификатор и тип	Поле	Описание
`protected static final char`	`NEWLINE`	Способ, которым текстовый пакет представляет символы новой строки.

Краткое описание конструкторов

Конструктор	Описание
`HTMLWriter(Writer w, HTMLDocument doc)`	Создает новый HTMLWriter.
`HTMLWriter(Writer w, HTMLDocument doc, int pos, int len)`	Создает новый HTMLWriter.

Краткое описание методов

Модификатор и тип	Метод	Описание
`protected void`	`closeOutUnwantedEmbeddedTags(AttributeSet attr)`	Выполняет поиск в наборе атрибутов и для каждого тега, хранящегося в векторе тегов.
`protected void`	`comment(Element elem)`	Выводит комментарии.
`protected void`	`emptyTag(Element elem)`	Выводит все пустые элементы (все теги, для которых нет соответствующего закрывающего тега).
`protected void`	`endTag(Element elem)`	Выводит закрывающий тег элемента.
`protected boolean`	`isBlockTag(AttributeSet attr)`	Определяет, является ли HTML.Tag, связанный с элементом, блочным тегом.
`protected boolean`	`matchNameAttribute(AttributeSet attr, HTML.Tag tag)`	Возвращает true, если StyleConstants.NameAttribute совпадает с тегом, переданным в качестве параметра.
`protected void`	`output(char[] chars, int start, int length)`	Этот метод переопределен для замены символьных сущностей, например <, на <.
`protected void`	`selectContent(AttributeSet attr)`	Выводит содержимое элемента формы SELECT.
`protected void`	`startTag(Element elem)`	Выводит открывающий тег элемента.
`protected boolean`	`synthesizedElement(Element elem)`	Возвращает `true`, если элемент является синтезированным.
`protected void`	`text(Element elem)`	Выводит текст.
`protected void`	`textAreaContent(AttributeSet attr)`	Выводит текст, содержащийся в элементе формы TEXTAREA.
`void`	`write()`	Обходит дерево Element и управляет выводом всех тегов и их атрибутов.
`protected void`	`writeAttributes(AttributeSet attr)`	Выводит набор атрибутов.
`protected void`	`writeEmbeddedTags(AttributeSet attr)`	Ищет встроенные теги в AttributeSet и выводит их.
`protected void`	`writeLineSeparator()`	Выводит разделитель строк.
`protected void`	`writeOption(Option option)`	Выводит содержимое элемента формы Option.

Методы, объявленные в классе AbstractWriter

decrIndent, getCanWrapLines, getCurrentLineLength, getDocument, getElementIterator, getEndOffset, getIndentLevel, getIndentSpace, getLineLength, getLineSeparator, getStartOffset, getText, getWriter, incrIndent, indent, inRange, isLineEmpty, setCanWrapLines, setCurrentLineLength, setIndentSpace, setLineLength, setLineSeparator, write, write, write

Модификатор и тип	Метод	Описание
`protected void`	`decrIndent()`	Уменьшает уровень отступа.
`protected boolean`	`getCanWrapLines()`	Возвращает, допускается ли перенос строк.
`protected int`	`getCurrentLineLength()`	Возвращает текущую длину строки.
`protected Document`	`getDocument()`	Получает документ.
`protected ElementIterator`	`getElementIterator()`	Получает ElementIterator.
`int`	`getEndOffset()`	Возвращает последний выводимый индекс.
`protected int`	`getIndentLevel()`	Возвращает текущий уровень отступа.
`protected int`	`getIndentSpace()`	Возвращает величину отступа в пробелах.
`protected int`	`getLineLength()`	Возвращает максимальную длину строки.
`String`	`getLineSeparator()`	Возвращает строку, используемую для представления символов новой строки.
`int`	`getStartOffset()`	Возвращает первый выводимый индекс.
`protected String`	`getText(Element elem)`	Возвращает текст, связанный с элементом.
`protected Writer`	`getWriter()`	Возвращает Writer, используемый для вывода содержимого.
`protected void`	`incrIndent()`	Увеличивает уровень отступа.
`protected void`	`indent()`	Выполняет отступ.
`protected boolean`	`inRange(Element next)`	Этот метод определяет, находится ли текущий элемент в заданном диапазоне.
`protected boolean`	`isLineEmpty()`	Возвращает true, если текущую строку следует считать пустой.
`protected void`	`setCanWrapLines(boolean newValue)`	Задает, допускается ли перенос строк.
`protected void`	`setCurrentLineLength(int length)`	Задает текущую длину строки.
`protected void`	`setIndentSpace(int space)`	Позволяет подклассам задавать количество пробелов, соответствующее одному уровню отступа.
`protected void`	`setLineLength(int l)`	Позволяет подклассам задавать количество символов, выводимых в каждой строке.
`void`	`setLineSeparator(String value)`	Задает строку, используемую для представления символов новой строки.
`protected void`	`write(char ch)`	Выводит символ.
`protected void`	`write(char[] chars, int startIndex, int length)`	Все методы записи вызывают этот метод.
`protected void`	`write(String content)`	Выводит строку.

Методы, объявленные в классе Object

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект какому-либо другому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API может быть удален в будущей версии. Финализация устарела и будет удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Переводит текущий поток в состояние ожидания до пробуждения, обычно посредством вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Переводит текущий поток в состояние ожидания до пробуждения, обычно посредством вызова notify или interrupt, либо до истечения заданного интервала реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Переводит текущий поток в состояние ожидания до пробуждения, обычно посредством вызова notify или interrupt, либо до истечения заданного интервала реального времени.

Подробное описание конструкторов

HTMLWriter

public HTMLWriter(Writer w, HTMLDocument doc)

Создает новый HTMLWriter.

Параметры:: w — объект Writer; doc — HTMLDocument

HTMLWriter

public HTMLWriter(Writer w, HTMLDocument doc, int pos, int len)

Создает новый HTMLWriter.

Параметры:: w — объект Writer; doc — HTMLDocument; pos — позиция в документе, с которой следует получить содержимое; len — объем выводимого содержимого

Подробное описание методов

write

public void write() throws IOException, BadLocationException

Обходит дерево Element и управляет выводом всех тегов и их атрибутов.

Переопределение:: write в классе AbstractWriter
Вызывает исключения:: IOException — при любой ошибке ввода-вывода; BadLocationException — если pos указывает на недопустимую позицию в документе.

writeAttributes

protected void writeAttributes(AttributeSet attr) throws IOException

Выводит набор атрибутов. Игнорирует все атрибуты с ключом типа HTML.Tag, атрибуты с ключом типа StyleConstants и атрибуты с ключом типа HTML.Attribute.ENDTAG.

Переопределение:: writeAttributes в классе AbstractWriter
Параметры:: attr — AttributeSet
Вызывает исключения:: IOException — при любой ошибке ввода-вывода

emptyTag

protected void emptyTag(Element elem) throws BadLocationException, IOException

Выводит все пустые элементы (все теги, для которых нет соответствующего закрывающего тега).

Параметры:: elem — Element
Вызывает исключения:: IOException — при любой ошибке ввода-вывода; BadLocationException — если pos указывает на недопустимую позицию в документе.

isBlockTag

protected boolean isBlockTag(AttributeSet attr)

Определяет, является ли HTML.Tag, связанный с элементом, блочным тегом.

Параметры:: attr — AttributeSet
Возвращает:: true, если тег является блочным, иначе false.

startTag

protected void startTag(Element elem) throws IOException, BadLocationException

Выводит открывающий тег элемента. Игнорирует все синтезированные элементы.

Параметры:: elem — Element
Вызывает исключения:: IOException — при любой ошибке ввода-вывода; BadLocationException — если pos указывает на недопустимую позицию в документе.

textAreaContent

protected void textAreaContent(AttributeSet attr) throws BadLocationException, IOException

Выводит текст, содержащийся в элементе формы TEXTAREA.

Параметры:: attr — AttributeSet
Вызывает исключения:: IOException — при любой ошибке ввода-вывода; BadLocationException — если pos указывает на недопустимую позицию в документе.

text

protected void text(Element elem) throws BadLocationException, IOException

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

Переопределение:: text в классе AbstractWriter
Параметры:: elem — Element
Вызывает исключения:: IOException — при любой ошибке ввода-вывода; BadLocationException — если pos указывает на недопустимую позицию в документе.

selectContent

protected void selectContent(AttributeSet attr) throws IOException

Выводит содержимое элемента формы SELECT.

Параметры:: attr — AttributeSet, связанный с элементом формы
Вызывает исключения:: IOException — при любой ошибке ввода-вывода

writeOption

protected void writeOption(Option option) throws IOException

Выводит содержимое элемента формы Option.

Параметры:: option — Option
Вызывает исключения:: IOException — при любой ошибке ввода-вывода

endTag

protected void endTag(Element elem) throws IOException

Выводит закрывающий тег элемента.

Параметры:: elem — Element
Вызывает исключения:: IOException — при любой ошибке ввода-вывода

comment

protected void comment(Element elem) throws BadLocationException, IOException

Выводит комментарии.

Параметры:: elem — Element
Вызывает исключения:: IOException — при любой ошибке ввода-вывода; BadLocationException — если pos указывает на недопустимую позицию в документе.

synthesizedElement

protected boolean synthesizedElement(Element elem)

Возвращает true, если элемент является синтезированным. В настоящее время проверяется только неявный тег p.

Параметры:: elem — элемент
Возвращает:: true, если элемент является синтезированным.

matchNameAttribute

protected boolean matchNameAttribute(AttributeSet attr, HTML.Tag tag)

Возвращает true, если StyleConstants.NameAttribute совпадает с тегом, переданным в качестве параметра.

Параметры:: attr — набор атрибутов; tag — тег HTML
Возвращает:: true, если StyleConstants.NameAttribute совпадает с тегом, переданным в качестве параметра.

writeEmbeddedTags

protected void writeEmbeddedTags(AttributeSet attr) throws IOException

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

Параметры:: attr — набор атрибутов
Вызывает исключения:: IOException — при любой ошибке ввода-вывода

closeOutUnwantedEmbeddedTags

protected void closeOutUnwantedEmbeddedTags(AttributeSet attr) throws IOException

Выполняет поиск в наборе атрибутов для каждого тега, сохраненного в векторе тегов. Если тег не найден, он удаляется из вектора и выводится соответствующий закрывающий тег.

Параметры:: attr — набор атрибутов
Вызывает исключения:: IOException — при любой ошибке ввода-вывода

writeLineSeparator

protected void writeLineSeparator() throws IOException

Выводит разделитель строк. Метод переопределен, чтобы содержимое символа новой строки не заменялось, если оно находится за пределами стандартного ASCII.

Переопределение:: writeLineSeparator в классе AbstractWriter
Вызывает исключения:: IOException — при любой ошибке ввода-вывода
Начиная с:: 1.3

output

protected void output(char[] chars, int start, int length) throws IOException

Этот метод переопределен для замены символьных сущностей, например <, на <. Для вывода содержимого будет вызван super.output.

Переопределение:: output в классе AbstractWriter
Параметры:: chars — выводимые символы; start — начальный индекс; length — длина выводимого содержимого
Вызывает исключения:: IOException — при любой ошибке ввода-вывода
Начиная с:: 1.3

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.