Интерфейс Characters

Все суперинтерфейсы:: XMLEvent, XMLStreamConstants

public interface Characters extends XMLEvent

Здесь описан интерфейс для событий Characters. Все текстовые события регистрируются как события Characters. Content, CData и пробельные символы регистрируются как события Characters. IgnorableWhitespace в большинстве случаев будет иметь значение false, если для текущего элемента не объявлено содержимое элемента.

Начиная с версии:: 1.6

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

Поля, объявленные в интерфейсе XMLStreamConstants

ATTRIBUTE, CDATA, CHARACTERS, COMMENT, DTD, END_DOCUMENT, END_ELEMENT, ENTITY_DECLARATION, ENTITY_REFERENCE, NAMESPACE, NOTATION_DECLARATION, PROCESSING_INSTRUCTION, SPACE, START_DOCUMENT, START_ELEMENT

Модификатор и тип	Поле	Описание
`static final int`	`ATTRIBUTE`	Указывает, что событие является атрибутом
`static final int`	`CDATA`	Указывает, что событие является разделом CDATA
`static final int`	`CHARACTERS`	Указывает, что событие содержит символьные данные
`static final int`	`COMMENT`	Указывает, что событие является комментарием
`static final int`	`DTD`	Указывает, что событие является DTD
`static final int`	`END_DOCUMENT`	Указывает, что событие является концом документа
`static final int`	`END_ELEMENT`	Указывает, что событие является концом элемента
`static final int`	`ENTITY_DECLARATION`	Указывает на объявление сущности
`static final int`	`ENTITY_REFERENCE`	Указывает, что событие является ссылкой на сущность
`static final int`	`NAMESPACE`	Указывает, что событие является объявлением пространства имен
`static final int`	`NOTATION_DECLARATION`	Указывает на нотацию
`static final int`	`PROCESSING_INSTRUCTION`	Указывает, что событие является инструкцией обработки
`static final int`	`SPACE`	Символьные данные состоят из пробельных символов (см. [XML], раздел 2.10 «Обработка пробельных символов»).
`static final int`	`START_DOCUMENT`	Указывает, что событие является началом документа
`static final int`	`START_ELEMENT`	Указывает, что событие является началом элемента

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

Модификатор и тип	Метод	Описание
`String`	`getData()`	Получает символьные данные этого события
`boolean`	`isCData()`	Возвращает true, если это раздел CDATA.
`boolean`	`isIgnorableWhiteSpace()`	Возвращает true, если это ignorableWhiteSpace.
`boolean`	`isWhiteSpace()`	Возвращает true, если эти символьные данные целиком состоят из пробельных символов.

Методы, объявленные в интерфейсе XMLEvent

asCharacters, asEndElement, asStartElement, getEventType, getLocation, getSchemaType, isAttribute, isCharacters, isEndDocument, isEndElement, isEntityReference, isNamespace, isProcessingInstruction, isStartDocument, isStartElement, writeAsEncodedUnicode

Модификатор и тип	Метод	Описание
`Characters`	`asCharacters()`	Возвращает это событие как Characters; если событие не является Characters, может возникнуть исключение приведения типа.
`EndElement`	`asEndElement()`	Возвращает это событие как событие конца элемента; если событие не является концом элемента, может возникнуть исключение приведения типа.
`StartElement`	`asStartElement()`	Возвращает это событие как событие начала элемента; если событие не является началом элемента, может возникнуть исключение приведения типа.
`int`	`getEventType()`	Возвращает целочисленный код этого события.
`Location`	`getLocation()`	Возвращает расположение этого события.
`QName`	`getSchemaType()`	Этот метод предоставлен для того, чтобы реализации могли предоставлять дополнительные сведения о типе связанного события.
`boolean`	`isAttribute()`	Вспомогательная функция для проверки, является ли это событие атрибутом.
`boolean`	`isCharacters()`	Вспомогательная функция для проверки, является ли это событие событием Characters.
`boolean`	`isEndDocument()`	Вспомогательная функция для проверки, является ли это событие концом документа.
`boolean`	`isEndElement()`	Вспомогательная функция для проверки, является ли это событие концом элемента.
`boolean`	`isEntityReference()`	Вспомогательная функция для проверки, является ли это событие ссылкой на сущность.
`boolean`	`isNamespace()`	Вспомогательная функция для проверки, является ли это событие пространством имен.
`boolean`	`isProcessingInstruction()`	Вспомогательная функция для проверки, является ли это событие инструкцией обработки.
`boolean`	`isStartDocument()`	Вспомогательная функция для проверки, является ли это событие началом документа.
`boolean`	`isStartElement()`	Вспомогательная функция для проверки, является ли это событие началом элемента.
`void`	`writeAsEncodedUnicode(Writer writer)`	Этот метод записывает XMLEvent в соответствии со спецификацией XML 1.0 в виде символов Unicode.

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

getData

String getData()

Получает символьные данные этого события

Возвращает:: символьные данные

isWhiteSpace

boolean isWhiteSpace()

Возвращает true, если эти символьные данные целиком состоят из пробельных символов. Пробельные символы внутри документа сообщаются как CHARACTERS. Этот метод позволяет проверять события CHARACTERS и определять, состоят ли они только из пробельных символов

Возвращает:: true, если Characters целиком состоят из пробельных символов, в противном случае false

isCData

boolean isCData()

Возвращает true, если это раздел CData. Если это событие CData, его типом будет CDATA. Если для javax.xml.stream.isCoalescing установлено значение true, разделы CDATA, окруженные символами, не являющимися CDATA, будут сообщаться как одно событие Characters. В этом случае данный метод вернет false.

Возвращает:: true, если это CDATA, в противном случае false

isIgnorableWhiteSpace

boolean isIgnorableWhiteSpace()

Возвращает true, если это ignorableWhiteSpace. Если это событие ignorableWhiteSpace, его типом будет SPACE.

Возвращает:: true, если это игнорируемые пробельные символы, в противном случае false

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