javax.xml.stream

Интерфейсный XMLEventWriter

Все Суперинтерфейсы:

XMLEventConsumer

public interface XMLEventWriter
extends XMLEventConsumer

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

С тех пор:

1.6

См. Также:

XMLEventReader, XMLEvent, Characters, ProcessingInstruction, StartElement, EndElement

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

Методы

Модификатор и Тип	Метод и Описание
void	add(XMLEvent event) Добавьте событие к потоку вывода, Добавляющему, что START_ELEMENT откроет новый контекст пространства имен, который будет закрыт, когда соответствующий END_ELEMENT будет записан.
void	add(XMLEventReader reader) Добавляет весь поток к потоку вывода, вызовы затем () на inputStream параметре, пока hasNext () не возвращает false, Это должно быть обработано как метод удобства, который выполнит следующий цикл по всем событиям в читателе события, и вызов прибавляют каждое событие.
void	close() Освобождает любые ресурсы, связанные с этим потоком
void	flush() Записи любые кэшируемые события к базовому выходному механизму
NamespaceContext	getNamespaceContext() Возвращает текущий контекст пространства имен.
Строка	getPrefix(String uri) Получает префикс, с которым связываются туры
void	setDefaultNamespace(String uri) Связывает URI с пространством имен по умолчанию, Этот URI связывается в пределах текущего START_ELEMENT / пара END_ELEMENT.
void	setNamespaceContext(NamespaceContext context) Устанавливает текущий контекст пространства имен для привязки туров и префикса.
void	setPrefix(String prefix, String uri) Устанавливает префикс, с которым связываются туры.

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

сброс

void flush()
           throws XMLStreamException

Записи любые кэшируемые события к базовому выходному механизму

Броски:

XMLStreamException

близко

void close()
           throws XMLStreamException

Освобождает любые ресурсы, связанные с этим потоком

Броски:

XMLStreamException

добавить

void add(XMLEvent event)
         throws XMLStreamException

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

Требуемые и дополнительные поля для событий, добавленных к писателю
Тип события	Обязательные поля	Дополнительные Поля	Необходимое Поведение
START_ELEMENT	Имя QName	пространства имен, атрибуты	START_ELEMENT будет записан, написав имя, пространства имен, и атрибуты события в XML 1.0 допустимый синтаксис для START_ELEMENTs. Имя написано, ища префикс для туров пространства имен. Писатель может быть сконфигурирован, чтобы уважать префиксы QNames. Если писатель уважает префиксы, это должно использовать префиксный набор на QName. Поведение по умолчанию является к поиску значением для префикса на внутреннем контексте пространства имен EventWriter. Каждый атрибут (если кто-либо) пишется, используя поведение, определенное в разделе атрибута этой таблицы. Каждое пространство имен (если кто-либо) пишется, используя поведение, определенное в разделе пространства имен этой таблицы.
END_ELEMENT	Имя Qname	Ни один	Хорошо сформированный тег END_ELEMENT пишется. Имя написано, ища префикс для туров пространства имен. Писатель может быть сконфигурирован, чтобы уважать префиксы QNames. Если писатель уважает префиксы, это должно использовать префиксный набор на QName. Поведение по умолчанию является к поиску значением для префикса на внутреннем контексте пространства имен EventWriter. Если имя END_ELEMENT не соответствует имя START_ELEMENT, XMLStreamException бросается.
АТРИБУТ	Имя QName, Строковое значение	Тип QName	Атрибут пишется, используя тот же самый алгоритм, чтобы найти лексическую форму как использующийся в START_ELEMENT. Значение по умолчанию должно использовать двойные кавычки, чтобы обернуть значения атрибута и выйти из любых двойных кавычек, найденных в значении. Значение типа игнорируется.
ПРОСТРАНСТВО ИМЕН	Строковый префикс, Строка namespaceURI, булевская переменная isDefaultNamespaceDeclaration	Ни один	Объявление пространства имен пишется. Если пространство имен является объявлением пространства имен по умолчанию (isDefault, истина), тогда xmlns =", $namespaceURI" пишется, и префикс дополнительный. Если isDefault является ложью, префикс должен быть объявлен, и писатель должен предварительно ожидать xmlns к префиксу и выписать стандартное префиксное объявление.
PROCESSING_INSTRUCTION	Ни один	Строковая цель, Строковые данные	Данные не должны присутствовать и могут быть нулем. Цель требуется и многие не быть нулем. Писатель запишет раздел данных непосредственно после цели, включенной в соответствующий синтаксис XML 1.0
КОММЕНТАРИЙ	Ни один	Строковый комментарий	Если комментарий присутствует (не нуль), это пишется, иначе, пустой комментарий пишется
START_DOCUMENT	Ни один	Строковое кодирование, автономная булевская переменная, Строковая версия	Событие START_DOCUMENT не обязано быть записанным потоку. Если существующий атрибуты пишутся в соответствующем синтаксисе объявления XML
END_DOCUMENT	Ни один	Ни один	Ничто не пишется выводу
DTD	Строка DocumentTypeDefinition	Ни один	DocumentTypeDefinition пишется выводу

Определенный:

add в интерфейсе XMLEventConsumer

Параметры:

event - событие, которое будет добавлено

Броски:

XMLStreamException

добавить

void add(XMLEventReader reader)
         throws XMLStreamException

Добавляет весь поток к потоку вывода, вызовы затем () на inputStream параметре, пока hasNext () не возвращает false, Это должно быть обработано как метод удобства, который выполнит следующий цикл по всем событиям в читателе события, и вызов прибавляют каждое событие.

Параметры:

reader - поток событий, чтобы добавить к выводу

Броски:

XMLStreamException

getPrefix

String getPrefix(String uri)
                 throws XMLStreamException

Получает префикс, с которым связываются туры

Параметры:

uri - туры, чтобы искать

Броски:

XMLStreamException

setPrefix

void setPrefix(String prefix,
             String uri)
               throws XMLStreamException

Устанавливает префикс, с которым связываются туры. Этот префикс связывается в пределах текущего START_ELEMENT / пара END_ELEMENT. Если этот метод вызывают прежде, чем START_ELEMENT был записан, префикс связывается в корневом контексте.

Параметры:

prefix - префикс, чтобы связать с турами

uri - туры, чтобы связать с префиксом

Броски:

XMLStreamException

setDefaultNamespace

void setDefaultNamespace(String uri)
                         throws XMLStreamException

Связывает URI с пространством имен по умолчанию, Этот URI связывается в пределах текущего START_ELEMENT / пара END_ELEMENT. Если этот метод вызывают прежде, чем START_ELEMENT был записан, туры связывается в корневом контексте.

Параметры:

uri - туры, чтобы связать с пространством имен по умолчанию

Броски:

XMLStreamException

setNamespaceContext

void setNamespaceContext(NamespaceContext context)
                         throws XMLStreamException

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

Параметры:

context - контекст пространства имен, чтобы использовать для этого писателя

Броски:

XMLStreamException

getNamespaceContext

NamespaceContext getNamespaceContext()

Возвращает текущий контекст пространства имен.

Возвраты:

текущий контекст пространства имен