org.apache.tika.parser
Interface Parser

All Superinterfaces:

Serializable

All Known Implementing Classes:

AbstractParser, AdobeFontMetricParser, AudioParser, AutoDetectParser, ChmParser, ClassParser, CompositeExternalParser, CompositeParser, CryptoParser, DcXMLParser, DefaultParser, DelegatingParser, DWGParser, EmptyParser, EpubContentParser, EpubParser, ErrorParser, ExternalParser, FeedParser, FictionBookParser, FLVParser, ForkParser, HDFParser, HtmlParser, ImageParser, IWorkPackageParser, JpegParser, MboxParser, MidiParser, Mp3Parser, MP4Parser, NetCDFParser, NetworkParser, OfficeParser, OOXMLParser, OpenDocumentContentParser, OpenDocumentMetaParser, OpenDocumentParser, OpenOfficeParser, OSGiParser, PackageParser, ParserDecorator, ParserPostProcessor, PDFParser, PRTParser, PSDParser, RFC822Parser, RTFParser, TiffParser, TNEFParser, TrueTypeParser, TXTParser, XMLParser

public interface Parser
extends Serializable

Tika parser interface.

Method Summary

Set<MediaType>	getSupportedTypes(ParseContext context) Returns the set of media types supported by this parser when used with the given parse context.
void	parse(InputStream stream, ContentHandler handler, Metadata metadata, ParseContext context) Parses a document stream into a sequence of XHTML SAX events.

Method Detail

getSupportedTypes

Set<MediaType> getSupportedTypes(ParseContext context)

Returns the set of media types supported by this parser when used with the given parse context.

Parameters:

context - parse context

Returns:

immutable set of media types

Since:

Apache Tika 0.7

parse

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

Parses a document stream into a sequence of XHTML SAX events. Fills in related document metadata in the given metadata object.

The given document stream is consumed but not closed by this method. The responsibility to close the stream remains on the caller.

Information about the parsing context can be passed in the context parameter. See the parser implementations for the kinds of context information they expect.

Parameters:

stream - the document stream (input)

handler - handler for the XHTML SAX events (output)

metadata - document metadata (input and output)

context - parse context

Throws:

IOException - if the document stream could not be read

SAXException - if the SAX events could not be processed

TikaException - if the document could not be parsed

Since:

Apache Tika 0.5