org.apache.tika.parser.pdf
Class PDFParser

java.lang.Object
  extended by org.apache.tika.parser.AbstractParser
      extended by org.apache.tika.parser.pdf.PDFParser
All Implemented Interfaces:
Serializable, Parser

public class PDFParser
extends AbstractParser

PDF parser.

This parser can process also encrypted PDF documents if the required password is given as a part of the input metadata associated with a document. If no password is given, then this parser will try decrypting the document using the empty password that's often used with PDFs.

See Also:
Serialized Form

Field Summary
static String PASSWORD
          Metadata key for giving the document password to the parser.
 
Constructor Summary
PDFParser()
           
 
Method Summary
 boolean getEnableAutoSpace()
           
 boolean getExtractAnnotationText()
          If true, text in annotations will be extracted.
 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.
 void setEnableAutoSpace(boolean v)
          If true (the default), the parser should estimate where spaces should be inserted between words.
 void setExtractAnnotationText(boolean v)
          If true (the default), text in annotations will be extracted.
 
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
 

Field Detail

PASSWORD

public static final String PASSWORD
Metadata key for giving the document password to the parser.

Since:
Apache Tika 0.5
See Also:
Constant Field Values
Constructor Detail

PDFParser

public PDFParser()
Method Detail

getSupportedTypes

public Set<MediaType> getSupportedTypes(ParseContext context)
Description copied from interface: Parser
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

parse

public void parse(InputStream stream,
                  ContentHandler handler,
                  Metadata metadata,
                  ParseContext context)
           throws IOException,
                  SAXException,
                  TikaException
Description copied from interface: Parser
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

setEnableAutoSpace

public void setEnableAutoSpace(boolean v)
If true (the default), the parser should estimate where spaces should be inserted between words. For many PDFs this is necessary as they do not include explicit whitespace characters.


getEnableAutoSpace

public boolean getEnableAutoSpace()
See Also:
#setEnableAutoSpace.

setExtractAnnotationText

public void setExtractAnnotationText(boolean v)
If true (the default), text in annotations will be extracted.


getExtractAnnotationText

public boolean getExtractAnnotationText()
If true, text in annotations will be extracted.



Copyright © 2007-2011 The Apache Software Foundation. All Rights Reserved.