Class XMLOutputFactory

public static final String IS_REPAIRING_NAMESPACES

Property used to control whether to default namespace prefixes. If true, the writer will create a namespace declaration for any attribute that doesn't have a namespace declaration in scope.

Field Value:

"javax.xml.stream.isRepairingNamespaces"

protected XMLOutputFactory()

The basic constructor. Object is special, because it has no superclass, so there is no call to super().

public abstract XMLEventWriter createXMLEventWriter(OutputStream stream)
            throws XMLStreamException

Creates a new event writer.

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

Creates a new event writer.

public abstract XMLEventWriter createXMLEventWriter(Writer stream)
            throws XMLStreamException

Creates a new event writer.

public abstract XMLEventWriter createXMLEventWriter(Result result)
            throws XMLStreamException

Creates a new event writer.

Throws:

UnsupportedOperationException - if this method is not supported

public abstract XMLStreamWriter createXMLStreamWriter(OutputStream stream)
            throws XMLStreamException

Creates a new stream writer.

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

Creates a new stream writer.

public abstract XMLStreamWriter createXMLStreamWriter(Writer stream)
            throws XMLStreamException

Creates a new stream writer.

public abstract XMLStreamWriter createXMLStreamWriter(Result result)
            throws XMLStreamException

Creates a new stream writer.

Throws:

UnsupportedOperationException - if this method is not supported

public abstract Object getProperty(String name)
            throws IllegalArgumentException

Returns the implementation-specific property of the given name.

Throws:

IllegalArgumentException - if the property is not supported

public abstract boolean isPropertySupported(String name)

Indicates whether the specified property is supported.

public static XMLOutputFactory newInstance()
            throws FactoryConfigurationError

Creates a new output factory.

See Also:

newInstance(String,ClassLoader)

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

Creates a new output factory. The implementation class to load is the first found in the following locations:

1. the javax.xml.stream.XMLOutputFactory system property
2. the above named property value in the $JAVA_HOME/lib/stax.properties file
3. the class name specified in the META-INF/services/javax.xml.stream.XMLOutputFactory system resource
4. the default factory class

Parameters:

factoryId - the name of the factory, same as the property

classLoader - the class loader to use

Returns:

a new factory instance

Throws:

FactoryConfigurationError - if an instance of this factory could not be loaded

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

Sets the implementation-specific property of the given name.

Throws:

IllegalArgumentException - if the property is not supported