XMLOutputFactory (Платформа Java SE 7)

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
См. Также:: XMLInputFactory, XMLEventWriter, XMLStreamWriter

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

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

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

Конструкторы
Модификатор Конструктор и Описание

protected XMLOutputFactory()

Конструкторы
Модификатор	Конструктор и Описание
`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()` Создайте новый экземпляр фабрики.
`static XMLInputFactory`	`newInstance(String factoryId, ClassLoader classLoader)` Осуждаемый. Этот метод был осужден, потому что он возвращает экземпляр XMLInputFactory, который имеет неправильный класс. Используйте новый метод `newFactory(java.lang.String, java.lang.ClassLoader)` вместо этого.
`abstract void`	`setProperty(String name, Object value)` Позволяет пользователю устанавливать определенные функции/свойства на базовой реализации.

Методы 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
```
    Создайте новый экземпляр фабрики.
    
    Броски:
    
    FactoryConfigurationError - если экземпляр этой фабрики не может быть загружен
  - newFactory
```
public static XMLOutputFactory newFactory()
                                   throws FactoryConfigurationError
```
    Создайте новый экземпляр фабрики. Этот статический метод создает новый экземпляр фабрики. Этот метод использует следующую упорядоченную процедуру поиска, чтобы определить класс реализации XMLOutputFactory загрузки: Используйте javax.xml.stream. Системное свойство XMLOutputFactory. Используйте файл свойств "lib/stax.properties" в каталоге JRE. Этот конфигурационный файл находится в стандарте java.util. Свойства форматируют, и содержит полностью определенное имя класса реализации с ключом, являющимся системным свойством, определенным выше. Используйте API Служб (как детализировано в спецификации JAR), при наличии, чтобы определить имя класса. API Служб будет искать имя класса в файле META-INF/services/javax.xml.stream.XMLOutputFactory во флягах, доступных времени выполнения. Значение по умолчанию платформы экземпляр XMLOutputFactory. Как только приложение получило ссылку на XMLOutputFactory, оно может использовать фабрику, чтобы сконфигурировать и получить потоковые экземпляры. Отметьте, что это - новый метод, который заменяет осуждаемый newInstance () метод. Никакие изменения в поведении не определяются этим заменяющим методом относительно осуждаемого метода.
    
    Броски:
    
    FactoryConfigurationError - если экземпляр этой фабрики не может быть загружен
  - newInstance
```
public static XMLInputFactory newInstance(String factoryId,
                          ClassLoader classLoader)
                                   throws FactoryConfigurationError
```
    Осуждаемый. Этот метод был осужден, потому что он возвращает экземпляр XMLInputFactory, который имеет неправильный класс. Используйте новый метод newFactory(java.lang.String, java.lang.ClassLoader) вместо этого.
    
    Создайте новый экземпляр фабрики.
    
    Параметры:
    factoryId - Имя фабрики, чтобы найти, то же самое как имя свойства
    classLoader - classLoader, чтобы использовать
    
    Возвраты:
    реализация фабрики
    
    Броски:
    
    FactoryConfigurationError - если экземпляр этой фабрики не может быть загружен
  - newFactory
```
public static XMLOutputFactory newFactory(String factoryId,
                          ClassLoader classLoader)
                                   throws FactoryConfigurationError
```
    Создайте новый экземпляр фабрики. Если classLoader параметром является нуль, то ContextClassLoader используется. Отметьте, что это - новый метод, который заменяет осуждаемый newInstance (Представьте factoryId в виде строки, ClassLoder 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 - Имя свойства (возможно, не нуль),
    
    Возвраты:
    истина, если свойство поддерживается и ложь иначе

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс XMLOutputFactory

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

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

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

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

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

IS_REPAIRING_NAMESPACES

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

XMLOutputFactory

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

newInstance

newFactory

newInstance

newFactory

createXMLStreamWriter

createXMLStreamWriter

createXMLStreamWriter

createXMLStreamWriter

createXMLEventWriter

createXMLEventWriter

createXMLEventWriter

createXMLEventWriter

setProperty

getProperty

isPropertySupported