Package org.apache.tika.sax

Class WriteOutContentHandler

java.lang.Object

org.xml.sax.helpers.DefaultHandler

org.apache.tika.sax.ContentHandlerDecorator

org.apache.tika.sax.WriteOutContentHandler

All Implemented Interfaces:

ContentHandler, DTDHandler, EntityResolver, ErrorHandler

Direct Known Subclasses:

LanguageHandler, RichTextContentHandler

public class WriteOutContentHandler
extends ContentHandlerDecorator

SAX event handler that writes content up to an optional write limit out to a character stream or other decorated handler.

Constructor Summary

Constructors

Constructor	Description
WriteOutContentHandler()	Creates a content handler that writes character events to an internal string buffer.
WriteOutContentHandler(int writeLimit)	Creates a content handler that writes character events to an internal string buffer.
WriteOutContentHandler(OutputStream stream)	Deprecated. -- please use WriteOutContentHandler(Writer)
WriteOutContentHandler(Writer writer)	Creates a content handler that writes character events to the given writer.
WriteOutContentHandler(Writer writer, int writeLimit)	Creates a content handler that writes content up to the given write limit to the given character stream.
WriteOutContentHandler(ContentHandler handler, int writeLimit)	Creates a content handler that writes content up to the given write limit to the given content handler.
WriteOutContentHandler(ContentHandler handler, int writeLimit, boolean throwOnWriteLimitReached, ParseContext parseContext)	The default is to throw a WriteLimitReachedException

Method Summary

Modifier and Type	Method	Description
void	characters(char[] ch, int start, int length)	Writes the given characters to the given character stream.
void	ignorableWhitespace(char[] ch, int start, int length)

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

endDocument, endElement, endPrefixMapping, error, fatalError, handleException, processingInstruction, setContentHandler, setDocumentLocator, skippedEntity, startDocument, startElement, startPrefixMapping, toString, warning

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

notationDecl, resolveEntity, unparsedEntityDecl

Methods inherited from class java.lang.Object

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

Constructor Detail

WriteOutContentHandler

public WriteOutContentHandler(ContentHandler handler,
                              int writeLimit)

Creates a content handler that writes content up to the given write limit to the given content handler.

Parameters:

handler - content handler to be decorated

writeLimit - write limit

Since:

Apache Tika 0.10

WriteOutContentHandler

public WriteOutContentHandler(Writer writer,
                              int writeLimit)

Creates a content handler that writes content up to the given write limit to the given character stream.

Parameters:

writer - character stream

writeLimit - write limit

Since:

Apache Tika 0.10

WriteOutContentHandler

public WriteOutContentHandler(Writer writer)

Creates a content handler that writes character events to the given writer.

Parameters:

writer - writer

WriteOutContentHandler

@Deprecated
public WriteOutContentHandler(OutputStream stream)

Deprecated.

-- please use WriteOutContentHandler(Writer)

Creates a content handler that writes character events to the given output stream using the default encoding.

Parameters:

stream - output stream

WriteOutContentHandler

public WriteOutContentHandler(int writeLimit)

Creates a content handler that writes character events to an internal string buffer. Use the ContentHandlerDecorator.toString() method to access the collected character content.

The internal string buffer is bounded at the given number of characters. If this write limit is reached, then a SAXException is thrown. The WriteLimitReachedException.isWriteLimitReached(Throwable) method can be used to detect this case.

Parameters:

writeLimit - maximum number of characters to include in the string, or -1 to disable the write limit

Since:

Apache Tika 0.7

WriteOutContentHandler

public WriteOutContentHandler()

Creates a content handler that writes character events to an internal string buffer. Use the ContentHandlerDecorator.toString() method to access the collected character content.

The internal string buffer is bounded at 100k characters. If this write limit is reached, then a SAXException is thrown. The WriteLimitReachedException.isWriteLimitReached(Throwable) method can be used to detect this case.

WriteOutContentHandler

public WriteOutContentHandler(ContentHandler handler,
                              int writeLimit,
                              boolean throwOnWriteLimitReached,
                              ParseContext parseContext)

The default is to throw a WriteLimitReachedException

Parameters:

handler -

writeLimit -

throwOnWriteLimitReached -

parseContext -

Method Detail

characters

public void characters(char[] ch,
                       int start,
                       int length)
                throws SAXException

Writes the given characters to the given character stream.

Specified by:

characters in interface ContentHandler

Overrides:

characters in class ContentHandlerDecorator

Throws:

SAXException

ignorableWhitespace

public void ignorableWhitespace(char[] ch,
                                int start,
                                int length)
                         throws SAXException

Specified by:

ignorableWhitespace in interface ContentHandler

Overrides:

ignorableWhitespace in class ContentHandlerDecorator

Throws:

SAXException