Package org.apache.tika.sax

Class AbstractRecursiveParserWrapperHandler

java.lang.Object

org.xml.sax.helpers.DefaultHandler

org.apache.tika.sax.AbstractRecursiveParserWrapperHandler

All Implemented Interfaces:

Serializable, ContentHandler, DTDHandler, EntityResolver, ErrorHandler

Direct Known Subclasses:

RecursiveParserWrapperHandler

public abstract class AbstractRecursiveParserWrapperHandler
extends DefaultHandler
implements Serializable

This is a special handler to be used only with the RecursiveParserWrapper. It allows for finer-grained processing of embedded documents than in the legacy handlers. Subclasses can choose how to process individual embedded documents.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static Property	CONTAINER_EXCEPTION
static Property	EMBEDDED_DEPTH
static Property	EMBEDDED_EXCEPTION
static Property	EMBEDDED_RESOURCE_LIMIT_REACHED
static Property	EMBEDDED_RESOURCE_PATH
static Property	PARSE_TIME_MILLIS
static Property	TIKA_CONTENT
static Property	TIKA_CONTENT_HANDLER	Simple class name of the content handler
static Property	WRITE_LIMIT_REACHED

Constructor Summary

Constructors

Constructor	Description
AbstractRecursiveParserWrapperHandler(ContentHandlerFactory contentHandlerFactory)
AbstractRecursiveParserWrapperHandler(ContentHandlerFactory contentHandlerFactory, int maxEmbeddedResources)

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 each embedded document.
ContentHandlerFactory	getContentHandlerFactory()
ContentHandler	getNewContentHandler()
ContentHandler	getNewContentHandler(OutputStream os, Charset charset)
boolean	hasHitMaximumEmbeddedResources()
void	startEmbeddedDocument(ContentHandler contentHandler, Metadata metadata)	This is called before parsing each embedded document.

Methods inherited from class org.xml.sax.helpers.DefaultHandler

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

Methods inherited from class java.lang.Object

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

Field Detail

TIKA_CONTENT

public static final Property TIKA_CONTENT

TIKA_CONTENT_HANDLER

public static final Property TIKA_CONTENT_HANDLER

Simple class name of the content handler

PARSE_TIME_MILLIS

public static final Property PARSE_TIME_MILLIS

WRITE_LIMIT_REACHED

public static final Property WRITE_LIMIT_REACHED

EMBEDDED_RESOURCE_LIMIT_REACHED

public static final Property EMBEDDED_RESOURCE_LIMIT_REACHED

EMBEDDED_EXCEPTION

public static final Property EMBEDDED_EXCEPTION

CONTAINER_EXCEPTION

public static final Property CONTAINER_EXCEPTION

EMBEDDED_RESOURCE_PATH

public static final Property EMBEDDED_RESOURCE_PATH

EMBEDDED_DEPTH

public static final Property EMBEDDED_DEPTH

Constructor Detail

AbstractRecursiveParserWrapperHandler

public AbstractRecursiveParserWrapperHandler(ContentHandlerFactory contentHandlerFactory)

AbstractRecursiveParserWrapperHandler

public AbstractRecursiveParserWrapperHandler(ContentHandlerFactory contentHandlerFactory,
                                             int maxEmbeddedResources)

Method Detail

getNewContentHandler

public ContentHandler getNewContentHandler()

getNewContentHandler

public ContentHandler getNewContentHandler(OutputStream os,
                                           Charset charset)

startEmbeddedDocument

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

This is called before parsing each embedded document. Override this for custom behavior. Make sure to call this in your custom classes because this tracks the number of embedded documents.

Parameters:

contentHandler - local handler to be used on this embedded document

metadata - embedded document's metadata

Throws:

SAXException

endEmbeddedDocument

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

This is called after parsing each embedded document. Override this for custom behavior. This is currently a no-op.

Parameters:

contentHandler - content handler that was used on this embedded document

metadata - metadata for this embedded document

Throws:

SAXException

endDocument

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

This is called after the full parse has completed. Override this for custom behavior. Make sure to call this as super.endDocument(...) in subclasses because this adds whether or not the embedded resource maximum has been hit to the metadata.

Parameters:

contentHandler - content handler that was used on the main document

metadata - metadata that was gathered for the main document

Throws:

SAXException

hasHitMaximumEmbeddedResources

public boolean hasHitMaximumEmbeddedResources()

Returns:

whether this handler has hit the maximum embedded resources during the parse

getContentHandlerFactory

public ContentHandlerFactory getContentHandlerFactory()