compact2, compact3

javax.xml.stream

Class XMLOutputFactory

java.lang.Object

javax.xml.stream.XMLOutputFactory

public abstract class XMLOutputFactory
extends Object

定义了一个让xmleventwriters和xmlstreamwriters厂的抽象实现。下表定义了本规范的标准属性。每个属性在每个实现所需的支持级别上都不不同。所需的支持级别描述在“所需的”列中。

Configuration parameters
Property Name	Behavior	Return type	Default Value	Required
javax.xml.stream.isRepairingNamespaces	defaults prefixes on the output side	Boolean	False	Yes

下面的段落描述了命名空间和前缀修复算法：

该属性可以设置以下代码行：setProperty("javax.xml.stream.isRepairingNamespaces",new Boolean(true|false));

此属性指定写者默认的命名空间前缀声明。默认值是错误的。

如果一个作家isrepairingnamespaces将会产生电流的任何属性，目前没有一个范围的命名空间声明不同命名空间声明。如果有一个URI前缀不同但没有指定一个前缀将被分配，如果前缀尚未宣布家长当前startElement将会在当前startElement宣布。如果defaultnamespace一定范围和默认命名空间匹配的属性或不同属性没有前缀将被指定的URI。

如果一个元素或属性名称前缀，但不受任何命名空间URI，那么前缀将被删除在序列化期间。

如果在一开始或空元素标签元素和/或属性名称绑定到不同的命名空间URI和使用相同的前缀，那么元素或第一次出现的属性保留原有的前缀和下面的属性有一个新的前缀，前缀绑定到这些属性的命名空间URI取代。

如果一个元素或属性名称使用前缀绑定到一个不同的URI比从该元素的父命名空间上下文继承并在当前元素这样一个命名空间的声明上下文没有命名空间声明说。

如果一个元素或属性名称绑定到一个前缀有一个命名空间声明，绑定到一个不同的URI前缀，命名空间的声明如果正确的映射是从该元素的父上下文继承或删除，或改为命名空间URI的元素或属性使用前缀。

从以下版本开始：

一点六

Version:

一点二

另请参见：

XMLInputFactory， XMLEventWriter， XMLStreamWriter

Field Summary

Fields

Modifier and Type	Field and Description
static String	IS_REPAIRING_NAMESPACES 用于设置前缀拖欠输出侧的特性

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	XMLOutputFactory()

方法摘要

Modifier and Type	Method and Description
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实例，这是错误的类。使用新的方法newFactory(java.lang.String, java.lang.ClassLoader)相反。
abstract void	setProperty(String name, Object value) 允许用户在底层实现上设置特定的功能/属性。

Methods inherited from class java.lang.Object

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

Field Detail

IS_REPAIRING_NAMESPACES

public static final String IS_REPAIRING_NAMESPACES

用于设置前缀拖欠输出侧的特性

另请参见：

Constant Field Values

Constructor Detail

XMLOutputFactory

protected XMLOutputFactory()

方法详细信息

newInstance

public static XMLOutputFactory newInstance()
                                    throws FactoryConfigurationError

创建了一个新的工厂，以同样的方式方法的 newFactory()。

异常

FactoryConfigurationError -如果该厂不能实例被加载

newFactory

public static XMLOutputFactory newFactory()
                                   throws FactoryConfigurationError

创建工厂的一个新实例。

这种静态方法创建一个新的工厂实例。此方法使用以下命令查找程序来确定xmloutputfactory实现类负载：

• 使用javax.xml.stream.xmloutputfactory系统性能。
• 使用属性文件的“库/ StAX。属性”在JRE目录。这个配置文件是java.util.properties格式标准，包含实现类的完全限定名的关键是上面定义的系统性能。
• 使用服务提供商装载设施，由ServiceLoader类定义，试图定位和加载使用default loading mechanism服务的实现：服务提供者装载设备将使用current thread's context class loader尝试加载服务。如果上下文类加载器是空的，将使用的system class loader。
• 否则，系统默认实现返回。

一旦申请获得参考一xmloutputfactory可以使用工厂配置和获取流实例。

请注意，这是一种新的方法取代了过时的newinstance()方法。在行为上没有变化是由这种方法相对于过时的方法定义。

异常

FactoryConfigurationError -的情况下， service configuration error或者执行不可用或不能被实例化。

newInstance

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

过时的。 此方法已被否决因为它返回XMLInputFactory实例，这是错误的类。使用新的方法newFactory(java.lang.String, java.lang.ClassLoader)相反。

创建工厂的一个新实例。

参数

factoryId -工厂找到名字，相同的属性名

classLoader -类装载器使用

结果

本厂实施

异常

FactoryConfigurationError -如果该厂不能实例被加载

newFactory

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

创建工厂的一个新实例。如果类装载器的参数为null，然后用contextclassloader。

此方法使用以下命令查找程序来确定xmloutputfactory实现类负载：

• 利用确定的factoryId系统属性的值。
• 使用属性文件的“库/ StAX。属性”在JRE目录。这个配置文件是java.util.properties格式标准，包含实现类的完全限定名的关键是给出的factoryId。
• 如果factoryId“javax. XML流。xmloutputfactory”，使用服务提供商的装卸设施，由ServiceLoader类定义，试图找到并加载一个服务的实现使用指定的ClassLoader。如果classLoader是无效的，将default loading mechanism：即服务提供商装载设备将使用current thread's context class loader尝试加载服务。如果上下文类加载器是空的，将使用的system class loader。
• 否则，抛出一个FactoryConfigurationError。

API Note:

这里定义的参数factoryid与其他JAXP的工厂，第一个参数是完全合格的工厂类的名字，提供工厂实施不一致。

请注意，这是一种新的方法取代了过时的newInstance(String factoryId, ClassLoader classLoader)方法。原始的方法被错误地定义为返回XMLInputFactory。

参数

factoryId -工厂找到名字，相同的属性名

classLoader -类装载器使用

结果

本厂实施

异常

FactoryConfigurationError -的情况下， service configuration error或者执行不可用或不能被实例化。

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 -属性的名称（不得为空）

结果

如果属性是支持的，否则为假