compact2, compact3

javax.xml.stream

Класс XMLOutputFactory

java.lang. Объект

javax.xml.stream. XMLOutputFactory

public abstract class XMLOutputFactory
extends Object

Определяет абстрактную реализацию фабрики для того, чтобы получить XMLEventWriters и XMLStreamWriters. Следующая таблица определяет стандартные свойства этой спецификации. Каждое свойство изменяется по уровню поддержки, требуемой каждой реализацией. Уровень требуемой поддержки описывается в столбце 'Required'.

Параметры конфигурации
Имя свойства	Поведение	Возвратите тип	Значение по умолчанию	Необходимый
javax.xml.stream.isRepairingNamespaces	префиксы значений по умолчанию на выходной стороне	Булев	Ложь	Да

Следующие абзацы описывают пространство имен и снабжают префиксом алгоритм восстановления:

Свойство может быть установлено со следующей строкой кода: setProperty("javax.xml.stream.isRepairingNamespaces",new Boolean(true|false));

Это свойство определяет, что пространство имен по умолчанию писателя снабжает префиксом объявления. Значение по умолчанию является ложью.

Если писатель isRepairingNamespaces это создаст объявление пространства имен на текущем StartElement для какого-либо атрибута, у которого в настоящий момент нет объявления пространства имен в контексте. Если у StartElement будут туры, но никакой префикс, определенный, то префикс будет присвоен, если префикс не был объявлен в родителе текущего StartElement, это будет объявлено на текущем StartElement. Если defaultNamespace связывается и в контексте, и пространство имен по умолчанию соответствует URI атрибута или StartElement QName, никакой префикс не будет присвоен.

Если элемент или название атрибута будут иметь префикс, но не будут связаны ни с каким URI пространства имен, то префикс будет удален во время сериализации.

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

Если элемент или название атрибута используют префикс, который связывается с различным URI чем наследованное от контекста пространства имен родителя того элемента и нет никакого объявления пространства имен в контексте текущего элемента тогда, такое объявление пространства имен добавляется.

Если элемент или название атрибута связываются с префиксом и есть объявление пространства имен, которое связывает тот префикс с различным URI тогда, что объявление пространства имен или удаляется, если корректное отображение наследовано от родительского контекста того элемента, или изменено на URI пространства имен элемента или атрибута, используя тот префикс.

С тех пор:

1.6

Версия:

1.2

См. Также:

XMLInputFactory, XMLEventWriter, XMLStreamWriter

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
static String	IS_REPAIRING_NAMESPACES Свойство, используемое, чтобы установить префикс, принимающий значение по умолчанию на выходной стороне

Сводка конструктора

Конструкторы

Модификатор	Конструктор и Описание
protected	XMLOutputFactory()

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

Модификатор и Тип	Метод и Описание
abstract XMLEventWriter	createXMLEventWriter(OutputStream stream) Создайте новый XMLEventWriter, который пишет в поток
abstract XMLEventWriter	createXMLEventWriter(OutputStream stream, String encoding) Создайте новый XMLEventWriter, который пишет в поток
abstract XMLEventWriter	createXMLEventWriter(Result result) Создайте новый XMLEventWriter, который пишет в результат JAXP.
abstract XMLEventWriter	createXMLEventWriter(Writer stream) Создайте новый XMLEventWriter, который пишет в писателя
abstract XMLStreamWriter	createXMLStreamWriter(OutputStream stream) Создайте новый XMLStreamWriter, который пишет в поток
abstract XMLStreamWriter	createXMLStreamWriter(OutputStream stream, String encoding) Создайте новый XMLStreamWriter, который пишет в поток
abstract XMLStreamWriter	createXMLStreamWriter(Result result) Создайте новый XMLStreamWriter, который пишет в результат JAXP.
abstract XMLStreamWriter	createXMLStreamWriter(Writer stream) Создайте новый XMLStreamWriter, который пишет в писателя
abstract Object	getProperty(String name) Получите функцию/свойство на базовой реализации
abstract boolean	isPropertySupported(String name) Запросите набор свойств, которые поддерживает эта фабрика.
static XMLOutputFactory	newFactory() Создайте новый экземпляр фабрики.
static XMLOutputFactory	newFactory(String factoryId, ClassLoader classLoader) Создайте новый экземпляр фабрики.
static XMLOutputFactory	newInstance() Создает новый экземпляр фабрики точно тем же самым способом как newFactory() метод.
static XMLInputFactory	newInstance(String factoryId, ClassLoader classLoader) Осуждаемый. Этот метод был осужден, потому что он возвращает экземпляр XMLInputFactory, который имеет неправильный class. Используйте новый метод newFactory(java.lang.String, java.lang.ClassLoader) вместо этого.
abstract void	setProperty(String name, Object value) Позволяет пользователю устанавливать определенные функции/свойства на базовой реализации.

Методы, наследованные от class java.lang. Объект

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

Полевая Деталь

IS_REPAIRING_NAMESPACES

public static final String IS_REPAIRING_NAMESPACES

Свойство, используемое, чтобы установить префикс, принимающий значение по умолчанию на выходной стороне

См. Также:

Постоянные Значения полей

Деталь конструктора

XMLOutputFactory

protected XMLOutputFactory()

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

newInstance

public static XMLOutputFactory newInstance()
                                    throws FactoryConfigurationError

Создает новый экземпляр фабрики точно тем же самым способом как newFactory() метод.

Броски:

FactoryConfigurationError - если экземпляр этой фабрики не может быть загружен

newFactory

public static XMLOutputFactory newFactory()
                                   throws FactoryConfigurationError

Создайте новый экземпляр фабрики.

Этот статический метод создает новый экземпляр фабрики. Этот метод использует следующую упорядоченную процедуру поиска, чтобы определить реализацию XMLOutputFactory class, чтобы загрузиться:

• Используйте javax.xml.stream. Системное свойство XMLOutputFactory.
• Используйте файл свойств "lib/stax.properties" в каталоге JRE. Этот конфигурационный файл находится в стандарте java.util. Свойства форматируют, и содержит полностью определенное имя реализации class с ключом, являющимся системным свойством, определенным выше.
• Используйте средства загрузки поставщика услуг, определенные ServiceLoader class, чтобы попытаться расположиться и загрузить реализацию службы.
• Иначе, реализация системного значения по умолчанию возвращается.

Как только приложение получило ссылку на XMLOutputFactory, оно может использовать фабрику, чтобы сконфигурировать и получить потоковые экземпляры.

Отметьте, что это - новый метод, который заменяет осуждаемый newInstance () метод. Никакие изменения в поведении не определяются этим заменяющим методом относительно осуждаемого метода.

Броски:

FactoryConfigurationError - в случае ошибки конфигурации службы или если реализация не доступна или не может быть инстанцирована.

newInstance

public static XMLInputFactory newInstance(String factoryId,
                                          ClassLoader classLoader)
                                   throws FactoryConfigurationError

Осуждаемый. Этот метод был осужден, потому что он возвращает экземпляр XMLInputFactory, который имеет неправильный class. Используйте новый метод newFactory(java.lang.String, java.lang.ClassLoader) вместо этого.

Создайте новый экземпляр фабрики.

Параметры:

factoryId - Имя фабрики, чтобы найти, то же самое как имя свойства

classLoader - classLoader, чтобы использовать

Возвраты:

реализация фабрики

Броски:

FactoryConfigurationError - если экземпляр этой фабрики не может быть загружен

newFactory

public static XMLOutputFactory newFactory(String factoryId,
                                          ClassLoader classLoader)
                                   throws FactoryConfigurationError

Создайте новый экземпляр фабрики. Если classLoader параметром является нуль, то ContextClassLoader используется.

Этот метод использует следующую упорядоченную процедуру поиска, чтобы определить реализацию XMLOutputFactory class, чтобы загрузиться:

• Используйте значение системного свойства, идентифицированного factoryId.
• Используйте файл свойств "lib/stax.properties" в каталоге JRE. Этот конфигурационный файл находится в стандарте java.util. Свойства форматируют, и содержит полностью определенное имя реализации class с ключом, являющимся данным factoryId.
• Если factoryId "javax.xml.stream. XMLOutputFactory", используют средства загрузки поставщика услуг, определенные ServiceLoader class, чтобы попытаться расположиться и загрузить реализацию службы.
• Иначе, броски a FactoryConfigurationError.

Отметьте, что это - новый метод, который заменяет осуждаемый newInstance(String factoryId, ClassLoader classLoader) метод. Никакие изменения в поведении не определяются этим заменяющим методом относительно осуждаемого метода.

Параметры:

factoryId - Имя фабрики, чтобы найти, то же самое как имя свойства

classLoader - classLoader, чтобы использовать

Возвраты:

реализация фабрики

Броски:

FactoryConfigurationError - в случае ошибки конфигурации службы или если реализация не доступна или не может быть инстанцирована.

createXMLStreamWriter

public abstract XMLStreamWriter createXMLStreamWriter(Writer stream)
                                               throws XMLStreamException

Создайте новый XMLStreamWriter, который пишет в писателя

Параметры:

stream - писатель, чтобы записать в

Броски:

XMLStreamException

createXMLStreamWriter

public abstract XMLStreamWriter createXMLStreamWriter(OutputStream stream)
                                               throws XMLStreamException

Создайте новый XMLStreamWriter, который пишет в поток

Параметры:

stream - поток, чтобы записать в

Броски:

XMLStreamException

createXMLStreamWriter

public abstract XMLStreamWriter createXMLStreamWriter(OutputStream stream,
                                                      String encoding)
                                               throws XMLStreamException

Создайте новый XMLStreamWriter, который пишет в поток

Параметры:

stream - поток, чтобы записать в

encoding - кодирование, чтобы использовать

Броски:

XMLStreamException

createXMLStreamWriter

public abstract XMLStreamWriter createXMLStreamWriter(Result result)
                                               throws XMLStreamException

Создайте новый XMLStreamWriter, который пишет в результат JAXP. Этот метод является дополнительным.

Параметры:

result - результат записать в

Броски:

UnsupportedOperationException - если этот метод не поддерживается этим XMLOutputFactory

XMLStreamException

createXMLEventWriter

public abstract XMLEventWriter createXMLEventWriter(Result result)
                                             throws XMLStreamException

Создайте новый XMLEventWriter, который пишет в результат JAXP. Этот метод является дополнительным.

Параметры:

result - результат записать в

Броски:

UnsupportedOperationException - если этот метод не поддерживается этим XMLOutputFactory

XMLStreamException

createXMLEventWriter

public abstract XMLEventWriter createXMLEventWriter(OutputStream stream)
                                             throws XMLStreamException

Создайте новый XMLEventWriter, который пишет в поток

Параметры:

stream - поток, чтобы записать в

Броски:

XMLStreamException

createXMLEventWriter

public abstract XMLEventWriter createXMLEventWriter(OutputStream stream,
                                                    String encoding)
                                             throws XMLStreamException

Создайте новый XMLEventWriter, который пишет в поток

Параметры:

stream - поток, чтобы записать в

encoding - кодирование, чтобы использовать

Броски:

XMLStreamException

createXMLEventWriter

public abstract XMLEventWriter createXMLEventWriter(Writer stream)
                                             throws XMLStreamException

Создайте новый XMLEventWriter, который пишет в писателя

Параметры:

stream - поток, чтобы записать в

Броски:

XMLStreamException

setProperty

public abstract void setProperty(String name,
                                 Object value)
                          throws IllegalArgumentException

Позволяет пользователю устанавливать определенные функции/свойства на базовой реализации.

Параметры:

name - Имя свойства

value - Значение свойства

Броски:

IllegalArgumentException - если свойство не поддерживается

getProperty

public abstract Object getProperty(String name)
                            throws IllegalArgumentException

Получите функцию/свойство на базовой реализации

Параметры:

name - Имя свойства

Возвраты:

Значение свойства

Броски:

IllegalArgumentException - если свойство не поддерживается

isPropertySupported

public abstract boolean isPropertySupported(String name)

Запросите набор свойств, которые поддерживает эта фабрика.

Параметры:

name - Имя свойства (возможно, не нуль),

Возвраты:

истина, если свойство поддерживается и ложь иначе