All Downloads are FREE. Search and download functionalities are using the official Maven repository.

org.daisy.streamline.api.identity.Identifier Maven / Gradle / Ivy

The newest version!
package org.daisy.streamline.api.identity;

import org.daisy.streamline.api.media.AnnotatedFile;
import org.daisy.streamline.api.media.AnnotatedInputStream;
import org.daisy.streamline.api.media.InputStreamSupplier;


/**
 * Provides an interface for identifying a file format.
 * 
 * @author Joel Håkansson
 */
public interface Identifier {

	/**
	 * Identifies the file format of the specified file.
	 * @param f the file to identify
	 * @return returns the identified file
	 * @throws IdentificationFailedException if identification is unsuccessful
	 */
	public AnnotatedFile identify(AnnotatedFile f) throws IdentificationFailedException;
	
	/**
	 * Identifies the format of the specified source.
	 * @param source the source to identify
	 * @return returns the identified source
	 * @throws IdentificationFailedException if identification is unsuccessful
	 */
	public AnnotatedInputStream identify(InputStreamSupplier source) throws IdentificationFailedException;
	
}




© 2015 - 2024 Weber Informatics LLC | Privacy Policy