org.apache.tika.sax

Class StandardsExtractingContentHandler

java.lang.Object

org.xml.sax.helpers.DefaultHandler

org.apache.tika.sax.ContentHandlerDecorator

org.apache.tika.sax.StandardsExtractingContentHandler

All Implemented Interfaces:

org.xml.sax.ContentHandler, org.xml.sax.DTDHandler, org.xml.sax.EntityResolver, org.xml.sax.ErrorHandler

public class StandardsExtractingContentHandler
extends ContentHandlerDecorator

StandardsExtractingContentHandler is a Content Handler used to extract standard references while parsing.

This handler relies on complex regular expressions which can be slow on some types of input data.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	STANDARD_REFERENCES

Constructor Summary

Constructors

Constructor and Description
StandardsExtractingContentHandler(org.xml.sax.ContentHandler handler, Metadata metadata) Creates a decorator for the given SAX event handler and Metadata object.

Method Summary

Modifier and Type	Method and Description
void	characters(char[] ch, int start, int length) The characters method is called whenever a Parser wants to pass raw characters to the ContentHandler.
void	endDocument() This method is called whenever the Parser is done parsing the file.
double	getThreshold() Gets the threshold to be used for selecting the standard references found within the text based on their score.
void	setMaxBufferLength(int maxBufferLength) The number of characters to store in memory for checking for standards.
void	setThreshold(double score) Sets the score to be used as threshold.

Methods inherited from class org.apache.tika.sax.ContentHandlerDecorator

endElement, endPrefixMapping, ignorableWhitespace, processingInstruction, setDocumentLocator, skippedEntity, startDocument, startElement, startPrefixMapping, toString

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

error, fatalError, notationDecl, resolveEntity, unparsedEntityDecl, warning

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

STANDARD_REFERENCES

public static final java.lang.String STANDARD_REFERENCES

See Also:

Constant Field Values

Constructor Detail

StandardsExtractingContentHandler

public StandardsExtractingContentHandler(org.xml.sax.ContentHandler handler,
                                         Metadata metadata)

Creates a decorator for the given SAX event handler and Metadata object.

Parameters:

handler - SAX event handler to be decorated.

metadata - Metadata object.

Method Detail

getThreshold

public double getThreshold()

Gets the threshold to be used for selecting the standard references found within the text based on their score.

Returns:

the threshold to be used for selecting the standard references found within the text based on their score.

setThreshold

public void setThreshold(double score)

Sets the score to be used as threshold.

Parameters:

score - the score to be used as threshold.

characters

public void characters(char[] ch,
                       int start,
                       int length)
                throws org.xml.sax.SAXException

The characters method is called whenever a Parser wants to pass raw characters to the ContentHandler. However, standard references are often split across different calls to characters, depending on the specific Parser used. Therefore, we simply add all characters to a StringBuilder and analyze it once the document is finished.

Specified by:

characters in interface org.xml.sax.ContentHandler

Overrides:

characters in class ContentHandlerDecorator

Throws:

org.xml.sax.SAXException

endDocument

public void endDocument()
                 throws org.xml.sax.SAXException

This method is called whenever the Parser is done parsing the file. So, we check the output for any standard references.

Specified by:

endDocument in interface org.xml.sax.ContentHandler

Overrides:

endDocument in class ContentHandlerDecorator

Throws:

org.xml.sax.SAXException

setMaxBufferLength

public void setMaxBufferLength(int maxBufferLength)

The number of characters to store in memory for checking for standards. If this is unbounded, the complex regular expressions can take a long time to process some types of data. Only increase this limit with great caution.