javax.imageio.spi

Class ImageReaderWriterSpi

java.lang.Object

javax.imageio.spi.IIOServiceProvider

javax.imageio.spi.ImageReaderWriterSpi

All Implemented Interfaces:

RegisterableService

Direct Known Subclasses:

ImageReaderSpi, ImageWriterSpi

public abstract class ImageReaderWriterSpi
extends IIOServiceProvider

An abstract superclass that contains the common parts of ImageReaderSpi and ImageWriterSpi.

Since:

1.4

Field Summary

Fields

Modifier and Type	Field and Description
protected java.lang.String[]	extraImageMetadataFormatClassNames
protected java.lang.String[]	extraImageMetadataFormatNames The names of additional formats for encoding image metadata, other than the standard and the native formats, or null if this plug-in does not provide any extra formats.
protected java.lang.String[]	extraStreamMetadataFormatClassNames
protected java.lang.String[]	extraStreamMetadataFormatNames The names of additional formats for encoding stream metadata, other than the standard and the native formats, or null if this plug-in does not provide any extra formats.
protected java.lang.String[]	MIMETypes The MIME types of the supported image formats.
protected java.lang.String[]	names The human-readable, localized names of the supported image formats.
protected java.lang.String	nativeImageMetadataFormatClassName
protected java.lang.String	nativeImageMetadataFormatName The name of the format that allows encoding all image metadata without loss, or null if this plug-in does not provide a format that preserves all image metadata.
protected java.lang.String	nativeStreamMetadataFormatClassName
protected java.lang.String	nativeStreamMetadataFormatName The name of the format that allows encoding all stream metadata without loss, or null if this plug-in does not provide a format that preserves all stream metadata.
protected java.lang.String	pluginClassName The fully qualified name of the class that implements the ImageReader or ImageWriter interface.
protected java.lang.String[]	suffixes The file suffixes of the supported image formats.
protected boolean	supportsStandardImageMetadataFormat Indicates whether the per-image metadata objects associated with this plug-in support format “javax_imageio_1.0” in their getAsTree and setAsTree methods.
protected boolean	supportsStandardStreamMetadataFormat Indicates whether the per-stream metadata objects associated with this plug-in support format “javax_imageio_1.0” in their getAsTree and setAsTree methods.

Fields inherited from class javax.imageio.spi.IIOServiceProvider

vendorName, version

Constructor Summary

Constructors

Constructor and Description
ImageReaderWriterSpi() Constructs an ImageReaderWriteSpi instance, without specifying a number of parameters.
ImageReaderWriterSpi(java.lang.String vendorName, java.lang.String version, java.lang.String[] names, java.lang.String[] suffixes, java.lang.String[] MIMETypes, java.lang.String pluginClassName, boolean supportsStandardStreamMetadataFormat, java.lang.String nativeStreamMetadataFormatName, java.lang.String nativeStreamMetadataFormatClassName, java.lang.String[] extraStreamMetadataFormatNames, java.lang.String[] extraStreamMetadataFormatClassNames, boolean supportsStandardImageMetadataFormat, java.lang.String nativeImageMetadataFormatName, java.lang.String nativeImageMetadataFormatClassName, java.lang.String[] extraImageMetadataFormatNames, java.lang.String[] extraImageMetadataFormatClassNames) Constructs an ImageReaderWriteSpi instance, specifying a number of parameters.

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.String[]	getExtraImageMetadataFormatNames() Returns the names of additional formats for encoding image metadata, other than the standard and the native formats, or null if this plug-in does not provide any extra formats.
java.lang.String[]	getExtraStreamMetadataFormatNames() Returns the names of additional formats for encoding stream metadata, other than the standard and the native formats, or null if this plug-in does not provide any extra formats.
java.lang.String[]	getFileSuffixes() Returns the file suffixes of the supported image formats, for example [“tiff”, “tif”, “png”].
java.lang.String[]	getFormatNames() Returns the human-readable, localized names of the supported image formats.
javax.imageio.metadata.IIOMetadataFormat	getImageMetadataFormat(java.lang.String formatName) Returns an IIOMetadataFormat object that represents the requested image metadata format or null if the given format is supported but no IIOMetadataFormat can be created for it.
java.lang.String[]	getMIMETypes() Returns the MIME types of the supported image formats, for example [“image/tiff”, “image/png”].
java.lang.String	getNativeImageMetadataFormatName() Returns the name of the format that allows encoding all image metadata without loss, or null if this plug-in does not provide a format that preserves all image metadata.
java.lang.String	getNativeStreamMetadataFormatName() Returns the name of the format that allows encoding all stream metadata without loss, or null if this plug-in does not provide a format that preserves all stream metadata.
java.lang.String	getPluginClassName() Returns the fully qualified name of the class that implements the ImageReader or ImageWriter interface.
javax.imageio.metadata.IIOMetadataFormat	getStreamMetadataFormat(java.lang.String formatName) Returns an IIOMetadataFormat object that represents the requested stream metadata format or null if the given format is supported but no IIOMetadataFormat can be created for it.
boolean	isStandardImageMetadataFormatSupported() Returns whether the per-image metadata objects associated with this plug-in support format “javax_imageio_1.0” in their getAsTree and setAsTree methods.
boolean	isStandardStreamMetadataFormatSupported() Returns whether the per-stream metadata objects associated with this plug-in support format “javax_imageio_1.0” in their getAsTree and setAsTree methods.

Methods inherited from class javax.imageio.spi.IIOServiceProvider

getDescription, getVendorName, getVersion, onDeregistration, onRegistration

Methods inherited from class java.lang.Object

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

Field Detail

names

protected java.lang.String[] names

The human-readable, localized names of the supported image formats. This value should be non-null after construction.

See Also:

getFormatNames()

suffixes

protected java.lang.String[] suffixes

The file suffixes of the supported image formats. This value should be non-null after construction.

See Also:

getFileSuffixes()

MIMETypes

protected java.lang.String[] MIMETypes

The MIME types of the supported image formats. This value should be non-null after construction.

See Also:

getMIMETypes()

pluginClassName

protected java.lang.String pluginClassName

The fully qualified name of the class that implements the ImageReader or ImageWriter interface. This value should be non-null after construction.

See Also:

getPluginClassName()

supportsStandardStreamMetadataFormat

protected boolean supportsStandardStreamMetadataFormat

Indicates whether the per-stream metadata objects associated with this plug-in support format “javax_imageio_1.0” in their getAsTree and setAsTree methods.

See Also:

isStandardStreamMetadataFormatSupported()

nativeStreamMetadataFormatName

protected java.lang.String nativeStreamMetadataFormatName

The name of the format that allows encoding all stream metadata without loss, or null if this plug-in does not provide a format that preserves all stream metadata.

nativeStreamMetadataFormatClassName

protected java.lang.String nativeStreamMetadataFormatClassName

extraStreamMetadataFormatNames

protected java.lang.String[] extraStreamMetadataFormatNames

The names of additional formats for encoding stream metadata, other than the standard and the native formats, or null if this plug-in does not provide any extra formats.

extraStreamMetadataFormatClassNames

protected java.lang.String[] extraStreamMetadataFormatClassNames

supportsStandardImageMetadataFormat

protected boolean supportsStandardImageMetadataFormat

Indicates whether the per-image metadata objects associated with this plug-in support format “javax_imageio_1.0” in their getAsTree and setAsTree methods.

See Also:

isStandardImageMetadataFormatSupported()

nativeImageMetadataFormatName

protected java.lang.String nativeImageMetadataFormatName

The name of the format that allows encoding all image metadata without loss, or null if this plug-in does not provide a format that preserves all image metadata.

nativeImageMetadataFormatClassName

protected java.lang.String nativeImageMetadataFormatClassName

extraImageMetadataFormatNames

protected java.lang.String[] extraImageMetadataFormatNames

The names of additional formats for encoding image metadata, other than the standard and the native formats, or null if this plug-in does not provide any extra formats.

extraImageMetadataFormatClassNames

protected java.lang.String[] extraImageMetadataFormatClassNames

Constructor Detail

ImageReaderWriterSpi

public ImageReaderWriterSpi()

Constructs an ImageReaderWriteSpi instance, without specifying a number of parameters. Constructors of concrete subclasses must ensure that they set all inherited fields to meaningful values.

ImageReaderWriterSpi

public ImageReaderWriterSpi(java.lang.String vendorName,
                    java.lang.String version,
                    java.lang.String[] names,
                    java.lang.String[] suffixes,
                    java.lang.String[] MIMETypes,
                    java.lang.String pluginClassName,
                    boolean supportsStandardStreamMetadataFormat,
                    java.lang.String nativeStreamMetadataFormatName,
                    java.lang.String nativeStreamMetadataFormatClassName,
                    java.lang.String[] extraStreamMetadataFormatNames,
                    java.lang.String[] extraStreamMetadataFormatClassNames,
                    boolean supportsStandardImageMetadataFormat,
                    java.lang.String nativeImageMetadataFormatName,
                    java.lang.String nativeImageMetadataFormatClassName,
                    java.lang.String[] extraImageMetadataFormatNames,
                    java.lang.String[] extraImageMetadataFormatClassNames)

Constructs an ImageReaderWriteSpi instance, specifying a number of parameters.

Parameters:

names - the human-readable, localized names of the supported image formats, for example [“Tagged Image File Format”, “Portable Network Graphics”].

suffixes - the file suffixes of the supported image formats, for example [“tiff”, “tif”, “png”].

MIMETypes - the MIME types of the supported image formats, for example [“image/tiff”, “image/png”].

pluginClassName - the fully qualified name of the class that implements the ImageReader or ImageWriter interface.

supportsStandardStreamMetadataFormat - whether the per-stream metadata objects associated with this plug-in support format “javax_imageio_1.0” in their getAsTree and setAsTree methods.

nativeStreamMetadataFormatName - the name of the format that allows encoding all stream metadata without loss, or null if this plug-in does not provide a format that preserves all stream metadata.

extraStreamMetadataFormatNames - the names of additional formats for encoding stream metadata, other than the standard and the native formats, or null if this plug-in does not provide any extra formats.

supportsStandardImageMetadataFormat - whether the per-image metadata objects associated with this plug-in support format “javax_imageio_1.0” in their getAsTree and setAsTree methods.

nativeImageMetadataFormatName - the name of the format that allows encoding all image metadata without loss, or null if this plug-in does not provide a format that preserves all image metadata.

extraImageMetadataFormatNames - the names of additional formats for encoding image metadata, other than the standard and the native formats, or null if this plug-in does not provide any extra formats.

Throws:

java.lang.IllegalArgumentException - if vendorName or version is null.

Method Detail

getFormatNames

public java.lang.String[] getFormatNames()

Returns the human-readable, localized names of the supported image formats. For example, a plug-in might return an array with the elements [“Tagged Image File Format”, “Portable Network Graphics”].

getFileSuffixes

public java.lang.String[] getFileSuffixes()

Returns the file suffixes of the supported image formats, for example [“tiff”, “tif”, “png”].

getMIMETypes

public java.lang.String[] getMIMETypes()

Returns the MIME types of the supported image formats, for example [“image/tiff”, “image/png”].

Returns:

an array of MIME type strings, or null if none of the supported formats has an associated MIME type.

getPluginClassName

public java.lang.String getPluginClassName()

Returns the fully qualified name of the class that implements the ImageReader or ImageWriter interface.

isStandardStreamMetadataFormatSupported

public boolean isStandardStreamMetadataFormatSupported()

Returns whether the per-stream metadata objects associated with this plug-in support format “javax_imageio_1.0” in their getAsTree and setAsTree methods.

getNativeStreamMetadataFormatName

public java.lang.String getNativeStreamMetadataFormatName()

Returns the name of the format that allows encoding all stream metadata without loss, or null if this plug-in does not provide a format that preserves all stream metadata.

See Also:

getNativeImageMetadataFormatName()

getExtraStreamMetadataFormatNames

public java.lang.String[] getExtraStreamMetadataFormatNames()

Returns the names of additional formats for encoding stream metadata, other than the standard and the native formats, or null if this plug-in does not provide any extra formats.

See Also:

getExtraImageMetadataFormatNames()

isStandardImageMetadataFormatSupported

public boolean isStandardImageMetadataFormatSupported()

Returns whether the per-image metadata objects associated with this plug-in support format “javax_imageio_1.0” in their getAsTree and setAsTree methods.

getNativeImageMetadataFormatName

public java.lang.String getNativeImageMetadataFormatName()

Returns the name of the format that allows encoding all image metadata without loss, or null if this plug-in does not provide a format that preserves all image metadata.

See Also:

getNativeStreamMetadataFormatName()

getExtraImageMetadataFormatNames

public java.lang.String[] getExtraImageMetadataFormatNames()

Returns the names of additional formats for encoding image metadata, other than the standard and the native formats, or null if this plug-in does not provide any extra formats.

See Also:

getExtraStreamMetadataFormatNames()

getStreamMetadataFormat

public javax.imageio.metadata.IIOMetadataFormat getStreamMetadataFormat(java.lang.String formatName)

Returns an IIOMetadataFormat object that represents the requested stream metadata format or null if the given format is supported but no IIOMetadataFormat can be created for it.

Parameters:

formatName - the requested stream metadata format name

Returns:

an IIOMetadataFormat object or null

Throws:

java.lang.IllegalArgumentException - if formatName is null or is not one of the standard metadata format or this provider's native or extra stream metadata formats

getImageMetadataFormat

public javax.imageio.metadata.IIOMetadataFormat getImageMetadataFormat(java.lang.String formatName)

Returns an IIOMetadataFormat object that represents the requested image metadata format or null if the given format is supported but no IIOMetadataFormat can be created for it.

Parameters:

formatName - the requested image metadata format name

Returns:

an IIOMetadataFormat object or null

Throws:

java.lang.IllegalArgumentException - if formatName is null or is not one of the standard metadata format or this provider's native or extra image metadata formats