org.apache.tika.parser.image

Class ImageMetadataExtractor

java.lang.Object

org.apache.tika.parser.image.ImageMetadataExtractor

public class ImageMetadataExtractor
extends Object

Uses the Metadata Extractor library to read EXIF and IPTC image metadata and map to Tika fields.

As of 2.4.0 the library supports jpeg and tiff. As of 2.8.0 the library supports webp.

Constructor Summary

Constructors

Constructor and Description
ImageMetadataExtractor(Metadata metadata)
ImageMetadataExtractor(Metadata metadata, org.apache.tika.parser.image.ImageMetadataExtractor.DirectoryHandler... handlers)

Method Summary

Modifier and Type	Method and Description
protected void	handle(Iterator<com.drew.metadata.Directory> directories) Copies extracted tags to tika metadata using registered handlers.
protected void	handle(com.drew.metadata.Metadata metadataExtractor) Copies extracted tags to tika metadata using registered handlers.
void	parseHeif(InputStream is)
void	parseJpeg(File file)
void	parseRawExif(byte[] exifData)
void	parseRawExif(InputStream stream, int length, boolean needsExifHeader)
void	parseRawXMP(byte[] xmpData)
void	parseTiff(File file)
void	parseWebP(File file)

Methods inherited from class java.lang.Object

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

Constructor Detail

ImageMetadataExtractor

public ImageMetadataExtractor(Metadata metadata)

Parameters:

metadata - to extract to, using default directory handlers

ImageMetadataExtractor

public ImageMetadataExtractor(Metadata metadata,
                              org.apache.tika.parser.image.ImageMetadataExtractor.DirectoryHandler... handlers)

Parameters:

metadata - to extract to

handlers - handlers in order, note that handlers may override values from earlier handlers

Method Detail

parseJpeg

public void parseJpeg(File file)
               throws IOException,
                      SAXException,
                      TikaException

Throws:

IOException

SAXException

TikaException

parseTiff

public void parseTiff(File file)
               throws IOException,
                      SAXException,
                      TikaException

Throws:

IOException

SAXException

TikaException

parseWebP

public void parseWebP(File file)
               throws IOException,
                      TikaException

Throws:

IOException

TikaException

parseHeif

public void parseHeif(InputStream is)
               throws IOException,
                      TikaException

Throws:

IOException

TikaException

parseRawExif

public void parseRawExif(InputStream stream,
                         int length,
                         boolean needsExifHeader)
                  throws IOException,
                         SAXException,
                         TikaException

Throws:

IOException

SAXException

TikaException

parseRawExif

public void parseRawExif(byte[] exifData)
                  throws IOException,
                         SAXException,
                         TikaException

Throws:

IOException

SAXException

TikaException

parseRawXMP

public void parseRawXMP(byte[] xmpData)
                 throws IOException,
                        SAXException,
                        TikaException

Throws:

IOException

SAXException

TikaException

handle

protected void handle(com.drew.metadata.Metadata metadataExtractor)
               throws com.drew.metadata.MetadataException

Copies extracted tags to tika metadata using registered handlers.

Parameters:

metadataExtractor - Tag directories from a Metadata Extractor "reader"

Throws:

com.drew.metadata.MetadataException - This method does not handle exceptions from Metadata Extractor

handle

protected void handle(Iterator<com.drew.metadata.Directory> directories)
               throws com.drew.metadata.MetadataException

Copies extracted tags to tika metadata using registered handlers.

Parameters:

directories - Metadata Extractor Directory instances.

Throws:

com.drew.metadata.MetadataException - This method does not handle exceptions from Metadata Extractor