Class StAXUtils
- java.lang.Object
-
- org.apache.axiom.om.util.StAXUtils
-
public class StAXUtils extends Object
Utility class containing StAX related methods.This class defines a set of methods to get
XMLStreamReaderandXMLStreamWriterinstances. This class caches the corresponding factories, i.e.XMLInputFactoryandXMLOutputFactoryobjects.Default properties for these factories can be specified using
XMLInputFactory.propertiesandXMLOutputFactory.propertiesfiles. These files are loaded using the class loader that loaded theStAXUtilsclass. Properties with boolean, integer and string values are supported. Both standard StAX properties and implementation specific properties can be specified. This feature should be used with care since changing some properties to non default values will break Axiom. Good candidates forXMLInputFactory.propertiesare:javax.xml.stream.isCoalescing- Requires the processor to coalesce adjacent character data (text nodes and CDATA sections). This property also controls whether CDATA sections are reported or not.
com.ctc.wstx.inputBufferLength- Size of input buffer (in chars), to use for reading XML content from input stream/reader. This property is Woodstox specific.
com.ctc.wstx.minTextSegment- Property to specify shortest non-complete text segment (part of CDATA section or text content) that the parser is allowed to return, if not required to coalesce text. This property is Woodstox specific.
Good candidates for
XMLOutputFactory.propertiesare:com.ctc.wstx.outputEscapeCr- Property that determines whether Carriage Return (\r) characters are to be escaped when output or not. If enabled, all instances of of character \r are escaped using a character entity (where possible, that is, within CHARACTERS events, and attribute values). Otherwise they are output as is. The main reason to enable this property is to ensure that carriage returns are preserved as is through parsing, since otherwise they will be converted to canonical XML linefeeds (\n), when occurring along or as part of \r\n pair. This property is Woodstox specific.
-
-
Constructor Summary
Constructors Constructor Description StAXUtils()
-
Method Summary
-
-
-
Method Detail
-
getXMLInputFactory
public static XMLInputFactory getXMLInputFactory()
Get a cachedXMLInputFactoryinstance using the default configuration.- Returns:
- an
XMLInputFactoryinstance.
-
getXMLInputFactory
public static XMLInputFactory getXMLInputFactory(boolean factoryPerClassLoaderPolicy)
Deprecated.Get a cachedXMLInputFactoryinstance using the default configuration and the specified cache policy.- Parameters:
factoryPerClassLoaderPolicy- the cache policy; seegetXMLInputFactory(StAXParserConfiguration, boolean)for more details- Returns:
- an
XMLInputFactoryinstance.
-
getXMLInputFactory
public static XMLInputFactory getXMLInputFactory(StAXParserConfiguration configuration, boolean factoryPerClassLoaderPolicy)
Deprecated.Get a cachedXMLInputFactoryinstance using the specified configuration and cache policy.- Parameters:
configuration- the configuration applied to the requested factoryfactoryPerClassLoaderPolicy- If set totrue, the factory cached for the current class loader will be returned. If set tofalse, the singleton factory (instantiated using the class loader that loadedStAXUtils) will be returned.- Returns:
- an
XMLInputFactoryinstance.
-
createXMLStreamReader
public static XMLStreamReader createXMLStreamReader(InputStream in, String encoding) throws XMLStreamException
- Throws:
XMLStreamException
-
createXMLStreamReader
public static XMLStreamReader createXMLStreamReader(StAXParserConfiguration configuration, InputStream in, String encoding) throws XMLStreamException
- Throws:
XMLStreamException
-
createXMLStreamReader
public static XMLStreamReader createXMLStreamReader(InputStream in) throws XMLStreamException
- Throws:
XMLStreamException
-
createXMLStreamReader
public static XMLStreamReader createXMLStreamReader(StAXParserConfiguration configuration, InputStream in) throws XMLStreamException
- Throws:
XMLStreamException
-
createXMLStreamReader
public static XMLStreamReader createXMLStreamReader(StAXParserConfiguration configuration, String systemId, InputStream in) throws XMLStreamException
- Throws:
XMLStreamException
-
createXMLStreamReader
public static XMLStreamReader createXMLStreamReader(Reader in) throws XMLStreamException
- Throws:
XMLStreamException
-
createXMLStreamReader
public static XMLStreamReader createXMLStreamReader(StAXParserConfiguration configuration, Reader in) throws XMLStreamException
- Throws:
XMLStreamException
-
getXMLOutputFactory
public static XMLOutputFactory getXMLOutputFactory()
Deprecated.Get a cachedXMLOutputFactoryinstance using the default configuration.- Returns:
- an
XMLOutputFactoryinstance.
-
getXMLOutputFactory
public static XMLOutputFactory getXMLOutputFactory(boolean factoryPerClassLoaderPolicy)
Deprecated.Get a cachedXMLOutputFactoryinstance using the default configuration and the specified cache policy.- Parameters:
factoryPerClassLoaderPolicy- the cache policy; seegetXMLOutputFactory(StAXWriterConfiguration, boolean)for more details- Returns:
- an
XMLOutputFactoryinstance.
-
getXMLOutputFactory
public static XMLOutputFactory getXMLOutputFactory(StAXWriterConfiguration configuration, boolean factoryPerClassLoaderPolicy)
Deprecated.Get a cachedXMLOutputFactoryinstance using the specified configuration and cache policy.- Parameters:
configuration- the configuration applied to the requested factoryfactoryPerClassLoaderPolicy- If set totrue, the factory cached for the current class loader will be returned. If set tofalse, the singleton factory (instantiated using the class loader that loadedStAXUtils) will be returned.- Returns:
- an
XMLOutputFactoryinstance.
-
setFactoryPerClassLoader
public static void setFactoryPerClassLoader(boolean value)
Deprecated.Per class loader factories are no longer supported. The code now always uses the class loader that loaded theStAXUtilsclass.
-
createXMLStreamWriter
public static XMLStreamWriter createXMLStreamWriter(OutputStream out) throws XMLStreamException
Deprecated.- Throws:
XMLStreamException
-
createXMLStreamWriter
public static XMLStreamWriter createXMLStreamWriter(StAXWriterConfiguration configuration, OutputStream out) throws XMLStreamException
Deprecated.- Throws:
XMLStreamException
-
createXMLStreamWriter
public static XMLStreamWriter createXMLStreamWriter(OutputStream out, String encoding) throws XMLStreamException
Deprecated.- Throws:
XMLStreamException
-
createXMLStreamWriter
public static XMLStreamWriter createXMLStreamWriter(StAXWriterConfiguration configuration, OutputStream out, String encoding) throws XMLStreamException
Deprecated.- Throws:
XMLStreamException
-
createXMLStreamWriter
public static XMLStreamWriter createXMLStreamWriter(Writer out) throws XMLStreamException
Deprecated.- Throws:
XMLStreamException
-
createXMLStreamWriter
public static XMLStreamWriter createXMLStreamWriter(StAXWriterConfiguration configuration, Writer out) throws XMLStreamException
Deprecated.- Throws:
XMLStreamException
-
getXMLInputFactory
public static XMLInputFactory getXMLInputFactory(StAXParserConfiguration configuration)
Get a cachedXMLInputFactoryinstance using the specified configuration.- Parameters:
configuration- the configuration applied to the requested factory- Returns:
- an
XMLInputFactoryinstance.
-
getXMLOutputFactory
public static XMLOutputFactory getXMLOutputFactory(StAXWriterConfiguration configuration)
Deprecated.Get a cachedXMLOutputFactoryinstance using the specified configuration.- Parameters:
configuration- the configuration applied to the requested factory- Returns:
- an
XMLOutputFactoryinstance.
-
-