org.apache.tika.utils

Class XMLReaderUtils

java.lang.Object

org.apache.tika.utils.XMLReaderUtils

All Implemented Interfaces:

Serializable

public class XMLReaderUtils
extends Object
implements Serializable

Utility functions for reading XML. If you are doing SAX parsing, make sure to use the OfflineContentHandler to guard against XML External Entity attacks.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
XMLReaderUtils()

Method Summary

Modifier and Type	Method and Description
static Document	buildDOM(InputStream is, ParseContext context) This checks context for a user specified DocumentBuilder.
static DocumentBuilder	getDocumentBuilder() Returns the DOM builder specified in this parsing context.
static DocumentBuilderFactory	getDocumentBuilderFactory() Returns the DOM builder factory specified in this parsing context.
static SAXParser	getSAXParser() Returns the SAX parser specified in this parsing context.
static SAXParserFactory	getSAXParserFactory() Returns the SAX parser factory specified in this parsing context.
static Transformer	getTransformer() Returns a new transformer
static XMLInputFactory	getXMLInputFactory() Returns the StAX input factory specified in this parsing context.
static XMLReader	getXMLReader() Returns the XMLReader specified in this parsing context.
static void	parseSAX(InputStream is, org.xml.sax.helpers.DefaultHandler contentHandler, ParseContext context) This checks context for a user specified SAXParser.
static void	setMaxEntityExpansions(int maxEntityExpansions) Set the maximum number of entity expansions allowable in SAX/DOM/StAX parsing.
static void	setPoolSize(int poolSize) Set the pool size for cached XML parsers.

Methods inherited from class java.lang.Object

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

Constructor Detail

XMLReaderUtils

public XMLReaderUtils()

Method Detail

setMaxEntityExpansions

public static void setMaxEntityExpansions(int maxEntityExpansions)

Set the maximum number of entity expansions allowable in SAX/DOM/StAX parsing. NOTE:A value less than or equal to zero indicates no limit. This will override the system property JAXP_ENTITY_EXPANSION_LIMIT_KEY and the DEFAULT_MAX_ENTITY_EXPANSIONS value for pa

Parameters:

maxEntityExpansions - -- maximum number of allowable entity expansions

Since:

Apache Tika 1.19

getXMLReader

public static XMLReader getXMLReader()
                              throws TikaException

Returns the XMLReader specified in this parsing context. If a reader is not explicitly specified, then one is created using the specified or the default SAX parser.

Returns:

XMLReader

Throws:

TikaException

Since:

Apache Tika 1.13

See Also:

getSAXParser()

getSAXParser

public static SAXParser getSAXParser()
                              throws TikaException

Returns the SAX parser specified in this parsing context. If a parser is not explicitly specified, then one is created using the specified or the default SAX parser factory.

Make sure to wrap your handler in the OfflineContentHandler to prevent XML External Entity attacks

Returns:

SAX parser

Throws:

TikaException - if a SAX parser could not be created

Since:

Apache Tika 0.8

See Also:

getSAXParserFactory()

getSAXParserFactory

public static SAXParserFactory getSAXParserFactory()

Returns the SAX parser factory specified in this parsing context. If a factory is not explicitly specified, then a default factory instance is created and returned. The default factory instance is configured to be namespace-aware, not validating, and to use secure XML processing.

Make sure to wrap your handler in the OfflineContentHandler to prevent XML External Entity attacks

Returns:

SAX parser factory

Since:

Apache Tika 0.8

getDocumentBuilderFactory

public static DocumentBuilderFactory getDocumentBuilderFactory()

Returns the DOM builder factory specified in this parsing context. If a factory is not explicitly specified, then a default factory instance is created and returned. The default factory instance is configured to be namespace-aware and to apply reasonable security features.

Returns:

DOM parser factory

Since:

Apache Tika 1.13

getDocumentBuilder

public static DocumentBuilder getDocumentBuilder()
                                          throws TikaException

Returns the DOM builder specified in this parsing context. If a builder is not explicitly specified, then a builder instance is created and returned. The builder instance is configured to apply an IGNORING_SAX_ENTITY_RESOLVER, and it sets the ErrorHandler to null.

Returns:

DOM Builder

Throws:

TikaException

Since:

Apache Tika 1.13

getXMLInputFactory

public static XMLInputFactory getXMLInputFactory()

Returns the StAX input factory specified in this parsing context. If a factory is not explicitly specified, then a default factory instance is created and returned. The default factory instance is configured to be namespace-aware and to apply reasonable security using the IGNORING_STAX_ENTITY_RESOLVER.

Returns:

StAX input factory

Since:

Apache Tika 1.13

getTransformer

public static Transformer getTransformer()
                                  throws TikaException

Returns a new transformer

The transformer instance is configured to to use secure XML processing.

Returns:

Transformer

Throws:

TikaException - when the transformer can not be created

Since:

Apache Tika 1.17

buildDOM

public static Document buildDOM(InputStream is,
                                ParseContext context)
                         throws TikaException,
                                IOException,
                                SAXException

This checks context for a user specified DocumentBuilder. If one is not found, this reuses a DocumentBuilder from the pool.

Parameters:

is - InputStream to parse

context - context to use

Returns:

a document

Throws:

TikaException

IOException

SAXException

Since:

Apache Tika 1.19

parseSAX

public static void parseSAX(InputStream is,
                            org.xml.sax.helpers.DefaultHandler contentHandler,
                            ParseContext context)
                     throws TikaException,
                            IOException,
                            SAXException

This checks context for a user specified SAXParser. If one is not found, this reuses a SAXParser from the pool.

Parameters:

is - InputStream to parse

contentHandler - handler to use

context - context to use

Throws:

TikaException

IOException

SAXException

Since:

Apache Tika 1.19

setPoolSize

public static void setPoolSize(int poolSize)
                        throws TikaException

Set the pool size for cached XML parsers.

Parameters:

poolSize -

Throws:

TikaException

Since:

Apache Tika 1.19