Класс MinimalHTMLWriter

java.lang.Object

javax.swing.text.AbstractWriter

javax.swing.text.html.MinimalHTMLWriter

public class MinimalHTMLWriter extends AbstractWriter

MinimalHTMLWriter — это резервный записывающий объект, используемый HTMLEditorKit для вывода HTML документа, созданного не этим EditorKit. Формат документа:

<html>
  <head>
    <style>
       <!-- list of named styles
        p.normal {
           font-family: SansSerif;
           margin-height: 0;
           font-size: 14
        }
       -->
     </style>
  </head>
  <body>
   <p style=normal>
       Bold, italic, and underline attributes
       of the run are emitted as HTML tags.
       The remaining attributes are emitted as
       part of the style attribute of a <span> tag.
       The syntax is similar to inline styles.
   </p>
  </body>
</html>

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

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

NEWLINE

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

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

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

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

Модификатор и тип	Метод	Описание
`protected void`	`endFontTag()`	Больше не используется; вместо этого выводится <span>.
`protected boolean`	`inFontTag()`	Возвращает true, если в данный момент мы находимся внутри тега <font>.
`protected boolean`	`isText(Element elem)`	Возвращает true, если элемент является текстовым элементом.
`protected void`	`startFontTag(String style)`	Больше не используется; вместо этого выводится <span>.
`protected void`	`text(Element elem)`	Выводит текст.
`void`	`write()`	Создает HTML-вывод из StyledDocument.
`protected void`	`writeAttributes(AttributeSet attr)`	Выводит все атрибуты следующих типов: StyleConstants.ParagraphConstants, StyleConstants.CharacterConstants, StyleConstants.FontConstants, StyleConstants.ColorConstants.
`protected void`	`writeBody()`	Перебирает элементы документа и обрабатывает их в зависимости от того, являются ли они ветвями или листьями.
`protected void`	`writeComponent(Element elem)`	Предназначен для обработки элементов Component; намеренно не реализован.
`protected void`	`writeContent(Element elem, boolean needsIndenting)`	Выводит набор атрибутов в соответствии с требованиями HTML.
`protected void`	`writeEndParagraph()`	Выводит закрывающий тег для тега <p>.
`protected void`	`writeEndTag(String endTag)`	Выводит закрывающий тег с соответствующим отступом.
`protected void`	`writeHeader()`	Выводит теги <head> и <style>, а затем вызывает writeStyles() для вывода всех именованных стилей в качестве содержимого тега <style>.
`protected void`	`writeHTMLTags(AttributeSet attr)`	Создает для текста теги полужирного начертания <b>, курсива <i> и подчеркивания <u> на основе его настроек атрибутов.
`protected void`	`writeImage(Element elem)`	Предназначен для обработки элементов Icon; намеренно не реализован.
`protected void`	`writeLeaf(Element elem)`	Предназначен для вывода других нетекстовых листовых элементов.
`protected void`	`writeNonHTMLAttributes(AttributeSet attr)`	Выводит оставшиеся атрибуты на уровне символов (атрибуты, отличные от полужирного начертания, курсива и подчеркивания) в соответствии с требованиями HTML.
`protected void`	`writeStartParagraph(Element elem)`	Выводит открывающий тег абзаца.
`protected void`	`writeStartTag(String tag)`	Выводит открывающий тег с соответствующим отступом.
`protected void`	`writeStyles()`	Выводит все именованные стили в качестве содержимого тега <style>.

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

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

Модификатор и тип	Метод	Описание
`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`	`output(char[] content, int start, int length)`	Последний этап вывода содержимого.
`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)`	Выводит строку.
`protected void`	`writeLineSeparator()`	Выводит разделитель строк.

Методы, объявленные в классе 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, либо истечения заданного интервала реального времени.

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

MinimalHTMLWriter

public MinimalHTMLWriter(Writer w, StyledDocument doc)

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

Параметры:: w — Writer; doc — StyledDocument

MinimalHTMLWriter

public MinimalHTMLWriter(Writer w, StyledDocument doc, int pos, int len)

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

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

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

write

public void write() throws IOException, BadLocationException

Создает HTML-вывод из StyledDocument.

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

writeAttributes

protected void writeAttributes(AttributeSet attr) throws IOException

Выводит все атрибуты следующих типов: StyleConstants.ParagraphConstants, StyleConstants.CharacterConstants, StyleConstants.FontConstants, StyleConstants.ColorConstants. Имя и значение атрибута разделяются двоеточием. Каждая пара разделяется точкой с запятой.

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

text

protected void text(Element elem) throws IOException, BadLocationException

Выводит текст.

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

writeStartTag

protected void writeStartTag(String tag) throws IOException

Выводит открывающий тег с соответствующим отступом. Также увеличивает уровень отступа.

Параметры:: tag — открывающий тег
Выбрасывает:: IOException — при любой ошибке ввода-вывода

writeEndTag

protected void writeEndTag(String endTag) throws IOException

Выводит закрывающий тег с соответствующим отступом. Также уменьшает уровень отступа.

Параметры:: endTag — закрывающий тег
Выбрасывает:: IOException — при любой ошибке ввода-вывода

writeHeader

protected void writeHeader() throws IOException

Выводит теги <head> и <style>, а затем вызывает writeStyles() для вывода всех именованных стилей в качестве содержимого тега <style>. Содержимое обрамляется допустимыми маркерами комментария HTML, чтобы документ можно было просматривать в приложениях и браузерах, не поддерживающих этот тег.

Выбрасывает:: IOException — при любой ошибке ввода-вывода

writeStyles

protected void writeStyles() throws IOException

Выводит все именованные стили в качестве содержимого тега <style>.

Выбрасывает:: IOException — при любой ошибке ввода-вывода

writeBody

protected void writeBody() throws IOException, BadLocationException

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

Выбрасывает:: IOException — при любой ошибке ввода-вывода; BadLocationException — если мы находимся в недопустимом месте документа.

writeEndParagraph

protected void writeEndParagraph() throws IOException

Выводит закрывающий тег для тега <p>. Перед выводом тега этот метод проверяет, что все остальные открытые теги надлежащим образом закрыты.

Выбрасывает:: IOException — при любой ошибке ввода-вывода

writeStartParagraph

protected void writeStartParagraph(Element elem) throws IOException

Выводит открывающий тег абзаца. Если с абзацем связан именованный стиль, этот метод также создает атрибут class для тега <p> и задает в качестве его значения имя стиля.

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

writeLeaf

protected void writeLeaf(Element elem) throws IOException

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

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

writeImage

protected void writeImage(Element elem) throws IOException

Предназначен для обработки элементов Icon; намеренно не реализован. Способ реализации этого метода зависит от выбранной политики. Например, если вы создаете тег <img>, как следует представлять атрибут src (расположение изображения)? В одних случаях это может быть URL, в других — данные, прочитанные из потока.

Параметры:: elem — элемент типа StyleConstants.IconElementName
Выбрасывает:: IOException — если произошла ошибка ввода-вывода.

writeComponent

protected void writeComponent(Element elem) throws IOException

Предназначен для обработки элементов Component; намеренно не реализован. Способ реализации этого метода зависит от выбранной политики.

Параметры:: elem — элемент типа StyleConstants.ComponentElementName
Выбрасывает:: IOException — если произошла ошибка ввода-вывода.

isText

protected boolean isText(Element elem)

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

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

writeContent

protected void writeContent(Element elem, boolean needsIndenting) throws IOException, BadLocationException

Выводит набор атрибутов в соответствии с требованиями HTML.

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

writeHTMLTags

protected void writeHTMLTags(AttributeSet attr) throws IOException

Создает для текста теги полужирного начертания <b>, курсива <i> и подчеркивания <u> на основе его настроек атрибутов.

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

writeNonHTMLAttributes

protected void writeNonHTMLAttributes(AttributeSet attr) throws IOException

Выводит оставшиеся атрибуты на уровне символов (атрибуты, отличные от полужирного начертания, курсива и подчеркивания) в соответствии с требованиями HTML. Поскольку такие атрибуты, как семейство и размер шрифта, не имеют прямого соответствия тегам HTML, создается тег <span>, атрибуту style которого присваивается список оставшихся атрибутов, как для встроенных стилей.

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

inFontTag

protected boolean inFontTag()

Возвращает true, если в данный момент мы находимся внутри тега <font>.

Возвращает:: true, если в данный момент мы находимся внутри тега <font>.

endFontTag

protected void endFontTag() throws IOException

Больше не используется; вместо этого выводится <span>.

Выводит закрывающий тег для тега <font>.

Выбрасывает:: IOException — при любой ошибке ввода-вывода

startFontTag

protected void startFontTag(String style) throws IOException

Больше не используется; вместо этого выводится <span>.

Выводит открывающий тег для тега <font>. Поскольку теги font нельзя вкладывать друг в друга, этот метод закрывает все внешние теги font перед выводом нового открывающего тега.

Параметры:: style — стиль шрифта
Выбрасывает:: IOException — при любой ошибке ввода-вывода

© 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.