Package org.apache.tika.detect

Class FileCommandDetector

java.lang.Object

org.apache.tika.detect.FileCommandDetector

All Implemented Interfaces:

Serializable, SelfConfiguring, Detector

public class FileCommandDetector
extends Object
implements Detector

This runs the linux 'file' command against a file. If this is called on a TikaInputStream, it will use the underlying Path or spool the full file to disk and then run file against that.

If this is run against any other type of InputStream, it will spool up to maxBytes to disk and then run the detector.

As with all detectors, mark must be supported.

If you want to use file's mime type in the parse, e.g. to select the parser in AutoDetectParser, set setUseMime(boolean) to true. The default behavior is to store the value as FILE_MIME but rely on other detectors for the "active" mime used by Tika.

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static Property	FILE_MIME

Constructor Summary

Constructors

Constructor	Description
FileCommandDetector()

Method Summary

Modifier and Type	Method	Description
static boolean	checkHasFile()
static boolean	checkHasFile(String fileCommandPath)
MediaType	detect(TikaInputStream tis, Metadata metadata, ParseContext parseContext)	Detects the content type of the given input document.
boolean	isUseMime()
void	setFilePath(String fileCommandPath)
void	setMaxBytes(int maxBytes)	If this is not called on a TikaInputStream, this detector will spool up to this many bytes to a file to be detected by the 'file' command.
void	setTimeoutMs(long timeoutMs)
void	setUseMime(boolean useMime)

Methods inherited from class java.lang.Object

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

Field Details

FILE_MIME

public static Property FILE_MIME

Constructor Details

FileCommandDetector

public FileCommandDetector()

Method Details

checkHasFile

public static boolean checkHasFile()

checkHasFile

public static boolean checkHasFile(String fileCommandPath)

detect

public MediaType detect(TikaInputStream tis,
 Metadata metadata,
 ParseContext parseContext)
                 throws 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 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:

tis - document input stream, or null

metadata - input metadata for the document

parseContext - the parse context

Returns:

mime as identified by the file command or application/octet-stream otherwise

Throws:

IOException

setFilePath

public void setFilePath(String fileCommandPath)

setUseMime

public void setUseMime(boolean useMime)

isUseMime

public boolean isUseMime()

setMaxBytes

public void setMaxBytes(int maxBytes)

If this is not called on a TikaInputStream, this detector will spool up to this many bytes to a file to be detected by the 'file' command.

Parameters:

maxBytes -

setTimeoutMs

public void setTimeoutMs(long timeoutMs)