Класс HTMLWriter

java.lang.Object

javax.swing.text.AbstractWriter

javax.swing.text.html.HTMLWriter

public class HTMLWriter extends AbstractWriter

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

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

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

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

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

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

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

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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/text/html/HTMLWriter.html