ImageMetadataReader (Metadata-Extractor - JavaDoc - An Open Source Java Library for Image File Metadata)

java.lang.Object
- com.drew.imaging.ImageMetadataReader

```
public class ImageMetadataReader
extends Object
```
Obtains metadata from all supported file formats, including JPEG, RAW (NEF/CRw/CR2) and TIFF. If the caller knows their file to be of a particular type, they may prefer to use the dedicated MetadataReader directly (JpegMetadataReader for Jpeg files, or TiffMetadataReader for TIFF and RAW files). The dedicated readers offer a very slight performance improvement, though for most scenarios it is simpler, more convenient and more robust to use this class.

Author:

Drew Noakes http://drewnoakes.com

Method Summary

Methods
Modifier and Type	Method and Description
`static void`	`main(String[] args)` An application entry point.
`static Metadata`	`readMetadata(BufferedInputStream inputStream, boolean waitForBytes)` Reads metadata from an input stream.
`static Metadata`	`readMetadata(File file)` Reads metadata from a file.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - readMetadata
```
public static Metadata readMetadata(BufferedInputStream inputStream,
                    boolean waitForBytes)
                             throws ImageProcessingException,
                                    IOException
```
    Reads metadata from an input stream. The file inputStream examined to determine its type and consequently the appropriate method to extract the data, though this inputStream transparent to the caller.
    
    Parameters:
    inputStream - a stream from which the image data may be read. The stream must be positioned at the beginning of the image data.
    
    Returns:
    a populated Metadata object containing directories of tags with values and any processing errors.
    
    Throws:
    
    ImageProcessingException - for general processing errors.
    
    IOException
  - readMetadata
```
public static Metadata readMetadata(File file)
                             throws ImageProcessingException,
                                    IOException
```
    Reads metadata from a file. The file is examined to determine its type and consequently the appropriate method to extract the data, though this is transparent to the caller.
    
    Parameters:
    file - a file from which the image data may be read.
    
    Returns:
    a populated Metadata object containing directories of tags with values and any processing errors.
    
    Throws:
    
    ImageProcessingException - for general processing errors.
    
    IOException
  - main
```
public static void main(String[] args)
                 throws MetadataException,
                        IOException
```
    An application entry point. Takes the name of one or more files as arguments and prints the contents of all metadata directories to System.out. If /thumb is passed, then any thumbnail data will be written to a file with name of the input file having '.thumb.jpg' appended.
    
    Parameters:
    args - the command line arguments
    
    Throws:
    
    MetadataException
    
    IOException

Class ImageMetadataReader

Method Summary

Methods inherited from class java.lang.Object

Method Detail

readMetadata

readMetadata

main