javax.imageio.spi

Class ImageOutputStreamSpi

Implemented Interfaces:
RegisterableService

public abstract class ImageOutputStreamSpi
extends IIOServiceProvider

An abstract superclass for service providers that create image output streams for a file, URL, byte array or any other target.
Since:
1.4

Field Summary

protected Class
outputClass
Indicates which kind of output is produced by the streams created by createOutputStreamInstance(Object).

Fields inherited from class javax.imageio.spi.IIOServiceProvider

vendorName, version

Constructor Summary

ImageOutputStreamSpi()
Constructs a service provider for image output streams, given no parameters.
ImageOutputStreamSpi(String vendorName, String version, Class outputClass)
Constructs a service provider for image output streams, given the vendor name, a version string and the kind of producable output.

Method Summary

boolean
canUseCacheFile()
Determines whether ImageOutputStreams created by this service provider benefit from using a cache file.
ImageOutputStream
createOutputStreamInstance(Object output)
abstract ImageOutputStream
createOutputStreamInstance(Object output, boolean useCache, File cacheDir)
Class
getOutputClass()
Determines which kind of output is produced by the streams created by createOutputStreamInstance(Object).
boolean
needsCacheFile()
Determines whether ImageOutputStreams created by this service provider require the use of a cache file.

Methods inherited from class javax.imageio.spi.IIOServiceProvider

getDescription, getVendorName, getVersion, onDeregistration, onRegistration

Methods inherited from class java.lang.Object

clone, equals, extends Object> getClass, finalize, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

outputClass

protected Class outputClass
Indicates which kind of output is produced by the streams created by createOutputStreamInstance(Object).

Constructor Details

ImageOutputStreamSpi

protected ImageOutputStreamSpi()
Constructs a service provider for image output streams, given no parameters. It is up to the sub-class to set IIOServiceProvider.vendorName, IIOServiceProvider.version and outputClass to non-null values.

ImageOutputStreamSpi

public ImageOutputStreamSpi(String vendorName,
                            String version,
                            Class outputClass)
Constructs a service provider for image output streams, given the vendor name, a version string and the kind of producable output.
Throws:
IllegalArgumentException - if vendorName or version is null.

Method Details

canUseCacheFile

public boolean canUseCacheFile()
Determines whether ImageOutputStreams created by this service provider benefit from using a cache file.

The default behavior is to return false.

Returns:
true if the created streams are faster or need less memory when a cache file is being used; false if no positive effect results from the cache file.

createOutputStreamInstance

public ImageOutputStream createOutputStreamInstance(Object output)
            throws IOException

createOutputStreamInstance

public abstract ImageOutputStream createOutputStreamInstance(Object output,
                                                             boolean useCache,
                                                             File cacheDir)
            throws IOException

getOutputClass

public Class getOutputClass()
Determines which kind of output is produced by the streams created by createOutputStreamInstance(Object).

needsCacheFile

public boolean needsCacheFile()
Determines whether ImageOutputStreams created by this service provider require the use of a cache file.

The default behavior is to return false.

Returns:
true if the created streams can only work when a cache file is being used; false if no cache file is needed.

ImageOutputStreamSpi.java -- Service provider for image output streams. Copyright (C) 2004, 2005 Free Software Foundation, Inc. This file is part of GNU Classpath. GNU Classpath is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version. GNU Classpath is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with GNU Classpath; see the file COPYING. If not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. Linking this library statically or dynamically with other modules is making a combined work based on this library. Thus, the terms and conditions of the GNU General Public License cover the whole combination. As a special exception, the copyright holders of this library give you permission to link this library with independent modules to produce an executable, regardless of the license terms of these independent modules, and to copy and distribute the resulting executable under terms of your choice, provided that you also meet, for each linked independent module, the terms and conditions of the license of that module. An independent module is a module which is not derived from or based on this library. If you modify this library, you may extend this exception to your version of the library, but you are not obligated to do so. If you do not wish to do so, delete this exception statement from your version.