javax.imageio.spi

Class ImageOutputStreamSpi

java.lang.Object

javax.imageio.spi.IIOServiceProvider

javax.imageio.spi.ImageOutputStreamSpi

All Implemented Interfaces:

RegisterableService

public abstract class ImageOutputStreamSpi
extends IIOServiceProvider

服务提供者接口（SPI）为 ImageOutputStreams。在服务提供者接口的更多信息，见的 IIORegistry类类的评论。

这个接口允许任意的对象是“包裹”的情况下ImageOutputStream。例如，一个特定的ImageOutputStreamSpi可能允许一个通用的OutputStream作为目的地；另一个可能的输出到一个File或装置，如串行端口。

通过对ImageOutputStreams创作作为一个可插入的服务，就有可能把未来的输出目的地不改变API。同时，对ImageOutputStream高性能实现的（例如，一个特定的平台实现原生）可以安装和透明地使用应用程序。

另请参见：

IIORegistry， ImageOutputStream

Field Summary

Fields

Modifier and Type	Field and Description
protected 类<?>	outputClass 一个 类指示使用的 createInputStreamInstance法法律的对象类型。

Fields inherited from class javax.imageio.spi.IIOServiceProvider

vendorName, version

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	ImageOutputStreamSpi() 建立一个空白 ImageOutputStreamSpi。
	ImageOutputStreamSpi(String vendorName, String version, 类<?> outputClass) 构建一个给定的值的 ImageOutputStreamSpi。

方法摘要

Modifier and Type	Method and Description
boolean	canUseCacheFile() 返回 true如果用这种服务提供商相关的 ImageOutputStream实现可以利用缓存 File改进性能和/或记忆footrprint。
ImageOutputStream	createOutputStreamInstance(Object output) 返回与该服务提供商相关的 ImageOutputStream实现的一个实例。
abstract ImageOutputStream	createOutputStreamInstance(Object output, boolean useCache, File cacheDir) 返回与该服务提供商相关的 ImageOutputStream实现的一个实例。
类<?>	getOutputClass() 返回表示的类或接口类型必须由输出的目标是为了“包装”通过 createOutputStreamInstance在 ImageOutputStream 类对象实现方法。
boolean	needsCacheFile() 返回 true如果用这种服务提供商相关的 ImageOutputStream实施需要使用缓存 File。

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

outputClass

protected 类<?> outputClass

一个 类指示使用的 createInputStreamInstance法法律的对象类型。

Constructor Detail

ImageOutputStreamSpi

protected ImageOutputStreamSpi()

建立一个空白 ImageOutputStreamSpi。它的子类来初始化实例变量和/或覆盖以提供所有工作版本的方法的实现方法。

ImageOutputStreamSpi

public ImageOutputStreamSpi(String vendorName,
                            String version,
                            类<?> outputClass)

构建一个给定的值的 ImageOutputStreamSpi。

参数

vendorName -供应商名称。

version -版本标识符。

outputClass - 类指示使用的 createOutputStreamInstance法法律的对象类型。

异常

如果是 null vendorName IllegalArgumentException。

如果是 null version IllegalArgumentException。

方法详细信息

getOutputClass

public 类<?> getOutputClass()

返回表示的类或接口类型必须由输出的目标是为了“包装”通过 createOutputStreamInstance方法在 ImageOutputStream实施 类对象。

典型的返回值可能包括OutputStream.class或File.class，但任何类都可以使用。

结果

一个 类变量。

另请参见：

createOutputStreamInstance(Object, boolean, File)

canUseCacheFile

public boolean canUseCacheFile()

返回 true如果用这种服务提供商相关的 ImageOutputStream实现可以利用缓存 File改进性能和/或记忆footrprint。如果 false， cacheFile createOutputStreamInstance的参数的值将被忽略。

默认的实现返回false。

结果

true如果缓存文件可以通过服务提供商创建输出流的使用。

needsCacheFile

public boolean needsCacheFile()

返回 true如果用这种服务提供商相关的 ImageOutputStream实施需要使用缓存 File。

默认的实现返回false。

结果

true如果缓存文件是通过服务提供者创建输出流的需要。

createOutputStreamInstance

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

返回与该服务提供商相关的 ImageOutputStream实现的一个实例。如果一个缓存文件的使用是可选的参数， useCache将咨询。在一个高速缓存是必需的，或不适用，对 useCache值将被忽略。

参数

output -一个类类型的对象返回 getOutputClass。

useCache - boolean指示缓存文件应该被使用，在情况下，它是可选的。

cacheDir - File标明缓存文件应该被创建，或 null使用系统目录。

结果

一个 ImageOutputStream实例。

异常

IllegalArgumentException -如果 output不是正确的类的实例或是 null。

IllegalArgumentException -如果一个缓存文件是必要的，但 cacheDir是非 null并不是一个目录。

IOException -如果一个缓存文件是需要的但不能被创造。

另请参见：

getOutputClass()

createOutputStreamInstance

public ImageOutputStream createOutputStreamInstance(Object output)
                                             throws IOException

返回与该服务提供商相关的 ImageOutputStream实现的一个实例。缓存文件将在系统依赖的默认临时文件目录中创建，如果需要的话。

参数

output -一个类类型的对象返回 getOutputClass。

结果

一个 ImageOutputStream实例。

异常

IllegalArgumentException -如果 output不是正确的类的实例或是 null。

IOException -如果一个缓存文件是需要的但不能被创造。

另请参见：

getOutputClass()