Package org.apache.tika.parser

Class RecursiveParserWrapper

java.lang.Object

org.apache.tika.parser.AbstractParser

org.apache.tika.parser.ParserDecorator

org.apache.tika.parser.RecursiveParserWrapper

All Implemented Interfaces:

Serializable, Parser

public class RecursiveParserWrapper
extends ParserDecorator

This is a helper class that wraps a parser in a recursive handler. It takes care of setting the embedded parser in the ParseContext and handling the embedded path calculations.

After parsing a document, call getMetadata() to retrieve a list of Metadata objects, one for each embedded resource. The first item in the list will contain the Metadata for the outer container file.

Content can also be extracted and stored in the TikaCoreProperties.TIKA_CONTENT field of a Metadata object. Select the type of content to be stored at initialization.

If a WriteLimitReachedException is encountered, the wrapper will stop processing the current resource, and it will not process any of the child resources for the given resource. However, it will try to parse as much as it can. If a WLRE is reached in the parent document, no child resources will be parsed.

The implementation is based on Jukka's RecursiveMetadataParser and Nick's additions. See: RecursiveMetadataParser.

Note that this wrapper holds all data in memory and is not appropriate for files with content too large to be held in memory.

The unit tests for this class are in the tika-parsers module.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor	Description
RecursiveParserWrapper(Parser wrappedParser)	Initialize the wrapper with catchEmbeddedExceptions set to true as default.
RecursiveParserWrapper(Parser wrappedParser, boolean catchEmbeddedExceptions)

Method Summary

Modifier and Type	Method	Description
Set<MediaType>	getSupportedTypes(ParseContext context)	Delegates the method call to the decorated parser.
void	parse(InputStream stream, ContentHandler recursiveParserWrapperHandler, Metadata metadata, ParseContext context)	Delegates the method call to the decorated parser.

Methods inherited from class org.apache.tika.parser.ParserDecorator

getDecorationName, getWrappedParser, withFallbacks, withoutTypes, withTypes

Methods inherited from class org.apache.tika.parser.AbstractParser

parse

Methods inherited from class java.lang.Object

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

Constructor Detail

RecursiveParserWrapper

public RecursiveParserWrapper(Parser wrappedParser)

Initialize the wrapper with catchEmbeddedExceptions set to true as default.

Parameters:

wrappedParser - parser to use for the container documents and the embedded documents

RecursiveParserWrapper

public RecursiveParserWrapper(Parser wrappedParser,
                              boolean catchEmbeddedExceptions)

Parameters:

wrappedParser - parser to wrap

catchEmbeddedExceptions - whether or not to catch+record embedded exceptions. If set to false, embedded exceptions will be thrown and the rest of the file will not be parsed. The following will not be ignored: CorruptedFileException, RuntimeException

Method Detail

getSupportedTypes

public Set<MediaType> getSupportedTypes(ParseContext context)

Description copied from class: ParserDecorator

Delegates the method call to the decorated parser. Subclasses should override this method (and use super.getSupportedTypes() to invoke the decorated parser) to implement extra decoration.

Specified by:

getSupportedTypes in interface Parser

Overrides:

getSupportedTypes in class ParserDecorator

Parameters:

context - parse context

Returns:

immutable set of media types

parse

public void parse(InputStream stream,
                  ContentHandler recursiveParserWrapperHandler,
                  Metadata metadata,
                  ParseContext context)
           throws IOException,
                  SAXException,
                  TikaException

Description copied from class: ParserDecorator

Delegates the method call to the decorated parser. Subclasses should override this method (and use super.parse() to invoke the decorated parser) to implement extra decoration.

Specified by:

parse in interface Parser

Overrides:

parse in class ParserDecorator

Parameters:

stream -

recursiveParserWrapperHandler - -- handler must implement RecursiveParserWrapperHandler

metadata -

context -

Throws:

IOException

SAXException

TikaException

IllegalStateException - if the handler is not a RecursiveParserWrapperHandler