Package loci.formats

Class FormatHandler

java.lang.Object

loci.formats.FormatHandler

All Implemented Interfaces:

Closeable, AutoCloseable, IFormatHandler, IMetadataConfigurable

Direct Known Subclasses:

FormatReader, FormatWriter

public abstract class FormatHandler
extends Object
implements IFormatHandler

Abstract superclass of all biological file format readers and writers.

Field Summary

Fields

Modifier and Type	Field	Description
static final String[]	COMPRESSION_SUFFIXES	Suffixes for supported compression types.
protected String	currentId	Name of current file.
protected String	format	Name of this file format.
protected static final org.slf4j.Logger	LOGGER
protected MetadataOptions	metadataOptions	Metadata parsing options.
protected String[]	suffixes	Valid suffixes for this file format.

Constructor Summary

Constructors

Constructor	Description
FormatHandler(String format, String suffix)	Constructs a format handler with the given name and default suffix.
FormatHandler(String format, String[] suffixes)	Constructs a format handler with the given name and default suffixes.

Method Summary

Modifier and Type	Method	Description
static boolean	checkSuffix(String name, String suffix)	Performs suffix matching for the given filename.
static boolean	checkSuffix(String name, String[] suffixList)	Performs suffix matching for the given filename.
String	getFormat()	Gets the name of this file format.
MetadataOptions	getMetadataOptions()
Class<?>	getNativeDataType()	Returns the native data type of image planes for this reader, as returned by IFormatReader.openPlane(int, int, int, int, int) or IFormatWriter.savePlane(int, java.lang.Object).
String[]	getSuffixes()	Gets the default file suffixes for this file format.
Set<MetadataLevel>	getSupportedMetadataLevels()
boolean	isThisType(String name)	Checks if a file matches the type of this format handler.
void	setMetadataOptions(MetadataOptions options)

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.io.Closeable

close

Methods inherited from interface loci.formats.IFormatHandler

setId

Field Details

LOGGER

protected static final org.slf4j.Logger LOGGER

COMPRESSION_SUFFIXES

public static final String[] COMPRESSION_SUFFIXES

Suffixes for supported compression types.

format

protected String format

Name of this file format.

suffixes

protected String[] suffixes

Valid suffixes for this file format.

currentId

protected String currentId

Name of current file.

metadataOptions

protected MetadataOptions metadataOptions

Metadata parsing options.

Constructor Details

FormatHandler

public FormatHandler(String format,
 String suffix)

Constructs a format handler with the given name and default suffix.

FormatHandler

public FormatHandler(String format,
 String[] suffixes)

Constructs a format handler with the given name and default suffixes.

Method Details

getSupportedMetadataLevels

public Set<MetadataLevel> getSupportedMetadataLevels()

Specified by:

getSupportedMetadataLevels in interface IMetadataConfigurable

getMetadataOptions

public MetadataOptions getMetadataOptions()

Specified by:

getMetadataOptions in interface IMetadataConfigurable

setMetadataOptions

public void setMetadataOptions(MetadataOptions options)

Specified by:

setMetadataOptions in interface IMetadataConfigurable

isThisType

public boolean isThisType(String name)

Checks if a file matches the type of this format handler. The default implementation checks filename suffixes against those known for this format.

Specified by:

isThisType in interface IFormatHandler

getFormat

public String getFormat()

Description copied from interface: IFormatHandler

Gets the name of this file format.

Specified by:

getFormat in interface IFormatHandler

getSuffixes

public String[] getSuffixes()

Description copied from interface: IFormatHandler

Gets the default file suffixes for this file format.

Specified by:

getSuffixes in interface IFormatHandler

getNativeDataType

public Class<?> getNativeDataType()

Description copied from interface: IFormatHandler

Returns the native data type of image planes for this reader, as returned by IFormatReader.openPlane(int, int, int, int, int) or IFormatWriter.savePlane(int, java.lang.Object). For most readers this type will be a byte array; however, some readers call external APIs that work with other types such as BufferedImage.

Specified by:

getNativeDataType in interface IFormatHandler

checkSuffix

public static boolean checkSuffix(String name,
 String suffix)

Performs suffix matching for the given filename.

checkSuffix

public static boolean checkSuffix(String name,
 String[] suffixList)

Performs suffix matching for the given filename.