org.apache.tika.detect
Class ContainerAwareDetector

java.lang.Object
  extended by org.apache.tika.detect.ContainerAwareDetector
All Implemented Interfaces:
java.io.Serializable, Detector

public class ContainerAwareDetector
extends java.lang.Object
implements Detector

A detector that knows about the container formats that we support (eg POIFS, Zip), and is able to peek inside them to better figure out the contents. Delegates to another Detector (normally MimeTypes) to handle detection for non container formats. Should normally be used with a TikaInputStream to minimise the memory usage.

See Also:
Serialized Form

Constructor Summary
ContainerAwareDetector(Detector fallbackDetector)
          Creates a new container detector, which will use the given detector for non container formats.
 
Method Summary
 MediaType detect(java.io.InputStream input, Metadata metadata)
          Detects the content type of the given input document.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ContainerAwareDetector

public ContainerAwareDetector(Detector fallbackDetector)
Creates a new container detector, which will use the given detector for non container formats.

Parameters:
fallbackDetector - The detector to use for non-containers
Method Detail

detect

public MediaType detect(java.io.InputStream input,
                        Metadata metadata)
                 throws java.io.IOException
Description copied from interface: Detector
Detects the content type of the given input document. Returns application/octet-stream if the type of the document can not be detected.

If the document input stream is not available, then the first argument may be null. Otherwise the detector may read bytes from the start of the stream to help in type detection. The given stream is guaranteed to support the mark feature and the detector is expected to mark the stream before reading any bytes from it, and to reset the stream before returning. The stream must not be closed by the detector.

The given input metadata is only read, not modified, by the detector.

Specified by:
detect in interface Detector
Parameters:
input - document input stream, or null
metadata - input metadata for the document
Returns:
detected media type, or application/octet-stream
Throws:
java.io.IOException - if the document input stream could not be read


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