Class RecursiveParserWrapperHandler

java.lang.Object

org.xml.sax.helpers.DefaultHandler

org.apache.tika.sax.AbstractRecursiveParserWrapperHandler

org.apache.tika.sax.RecursiveParserWrapperHandler

All Implemented Interfaces:

Serializable, ContentHandler, DTDHandler, EntityResolver, ErrorHandler

public class RecursiveParserWrapperHandler
extends AbstractRecursiveParserWrapperHandler

This is the default implementation of AbstractRecursiveParserWrapperHandler. See its documentation for more details.

This caches the a metadata object for each embedded file and for the container file. It places the extracted content in the metadata object, with this key: TikaCoreProperties.TIKA_CONTENT If memory is a concern, subclass AbstractRecursiveParserWrapperHandler to handle each embedded document.

NOTE: This handler must only be used with the RecursiveParserWrapper

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
protected final List<Metadata>	metadataList

Fields inherited from class AbstractRecursiveParserWrapperHandler

EMBEDDED_DEPTH_LIMIT_REACHED, EMBEDDED_RESOURCE_LIMIT_REACHED

Constructor Summary

Constructors

Constructor	Description
RecursiveParserWrapperHandler(ContentHandlerFactory contentHandlerFactory)	Create a handler for recursive parsing.

Method Summary

Modifier and Type	Method	Description
void	endDocument(ContentHandler contentHandler, Metadata metadata)	This is called after the full parse has completed.
void	endEmbeddedDocument(ContentHandler contentHandler, Metadata metadata)	This is called after parsing an embedded document.
List<Metadata>	getMetadataList()
void	startEmbeddedDocument(ContentHandler contentHandler, Metadata metadata)	This is called before parsing an embedded document

Methods inherited from class AbstractRecursiveParserWrapperHandler

createHandler, decrementEmbeddedDepth, getContentHandlerFactory

Methods inherited from class DefaultHandler

characters, endDocument, endElement, endPrefixMapping, error, fatalError, ignorableWhitespace, notationDecl, processingInstruction, resolveEntity, setDocumentLocator, skippedEntity, startDocument, startElement, startPrefixMapping, unparsedEntityDecl, warning

Methods inherited from class Object

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

Methods inherited from interface ContentHandler

declaration

Field Details

metadataList

protected final List<Metadata> metadataList

Constructor Details

RecursiveParserWrapperHandler

public RecursiveParserWrapperHandler(ContentHandlerFactory contentHandlerFactory)

Create a handler for recursive parsing.

Embedded resource limits are now configured via EmbeddedLimits in the ParseContext, not on the handler.

Parameters:

contentHandlerFactory - factory for creating content handlers

Method Details

startEmbeddedDocument

public void startEmbeddedDocument(ContentHandler contentHandler,
 Metadata metadata)
                           throws SAXException

This is called before parsing an embedded document

Overrides:

startEmbeddedDocument in class AbstractRecursiveParserWrapperHandler

Parameters:

contentHandler - - local content handler to use on the embedded document

metadata - metadata to use for the embedded document

Throws:

SAXException

endEmbeddedDocument

public void endEmbeddedDocument(ContentHandler contentHandler,
 Metadata metadata)
                         throws SAXException

This is called after parsing an embedded document.

Overrides:

endEmbeddedDocument in class AbstractRecursiveParserWrapperHandler

Parameters:

contentHandler - local contenthandler used on the embedded document

metadata - metadata from the embedded document

Throws:

SAXException

endDocument

public void endDocument(ContentHandler contentHandler,
 Metadata metadata)
                 throws SAXException

Description copied from class: AbstractRecursiveParserWrapperHandler

This is called after the full parse has completed. Override this for custom behavior. Make sure to call this as super.endDocument(...) in subclasses.

Overrides:

endDocument in class AbstractRecursiveParserWrapperHandler

Parameters:

contentHandler - content handler used on the main document

metadata - metadata from the main document

Throws:

SAXException

getMetadataList

public List<Metadata> getMetadataList()

Returns:

a list of Metadata objects, one for the main document and one for each embedded document