[4231] | 1 | /*
|
---|
[6127] | 2 | * Copyright 2002-2012 Drew Noakes
|
---|
[4231] | 3 | *
|
---|
[6127] | 4 | * Licensed under the Apache License, Version 2.0 (the "License");
|
---|
| 5 | * you may not use this file except in compliance with the License.
|
---|
| 6 | * You may obtain a copy of the License at
|
---|
[4231] | 7 | *
|
---|
[6127] | 8 | * http://www.apache.org/licenses/LICENSE-2.0
|
---|
[4231] | 9 | *
|
---|
[6127] | 10 | * Unless required by applicable law or agreed to in writing, software
|
---|
| 11 | * distributed under the License is distributed on an "AS IS" BASIS,
|
---|
| 12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
---|
| 13 | * See the License for the specific language governing permissions and
|
---|
| 14 | * limitations under the License.
|
---|
| 15 | *
|
---|
| 16 | * More information about this project is available at:
|
---|
| 17 | *
|
---|
| 18 | * http://drewnoakes.com/code/exif/
|
---|
| 19 | * http://code.google.com/p/metadata-extractor/
|
---|
[4231] | 20 | */
|
---|
| 21 | package com.drew.metadata;
|
---|
| 22 |
|
---|
[6127] | 23 | import com.drew.lang.BufferReader;
|
---|
| 24 | import com.drew.lang.annotations.NotNull;
|
---|
| 25 |
|
---|
[4231] | 26 | /**
|
---|
[6127] | 27 | * Interface through which all classes responsible for decoding a particular type of metadata may be called.
|
---|
| 28 | * Note that the data source is not specified on this interface. Instead it is suggested that implementations
|
---|
| 29 | * take their data within a constructor. Constructors might be overloaded to allow for different sources, such as
|
---|
| 30 | * files, streams and byte arrays. As such, instances of implementations of this interface would be single-use and
|
---|
| 31 | * not thread-safe.
|
---|
[4231] | 32 | *
|
---|
[6127] | 33 | * @author Drew Noakes http://drewnoakes.com
|
---|
[4231] | 34 | */
|
---|
| 35 | public interface MetadataReader
|
---|
| 36 | {
|
---|
[6127] | 37 | /**
|
---|
| 38 | * Extract metadata from the source and merge it into an existing Metadata object.
|
---|
| 39 | *
|
---|
| 40 | * @param reader The reader from which the metadata should be extracted.
|
---|
| 41 | * @param metadata The Metadata object into which extracted values should be merged.
|
---|
| 42 | */
|
---|
| 43 | public void extract(@NotNull final BufferReader reader, @NotNull final Metadata metadata);
|
---|
[4231] | 44 | }
|
---|