javax.imageio.spi

Класс ImageOutputStreamSpi

java.lang. Объект

javax.imageio.spi. IIOServiceProvider

javax.imageio.spi. ImageOutputStreamSpi

Все Реализованные Интерфейсы:

RegisterableService

public abstract class ImageOutputStreamSpi
extends IIOServiceProvider

Интерфейс поставщика услуг (SPI) для ImageOutputStreams. Для получения дополнительной информации по интерфейсам поставщика услуг см. комментарий class для IIORegistry class.

Этот интерфейс позволяет произвольным объектам быть "обернутыми" экземплярами ImageOutputStream. Например, деталь ImageOutputStreamSpi мог бы позволить обобщение OutputStream использоваться в качестве места назначения; другой мог бы вывести к a File или к устройству, такому как последовательный порт.

Обрабатывая создание ImageOutputStreams как сменная служба, становится возможно обработать будущие выходные места назначения, не изменяя API. Кроме того, высокоэффективные реализации ImageOutputStream (например, собственные реализации для определенной платформы), может быть установлен и использоваться прозрачно приложениями.

См. Также:

IIORegistry, ImageOutputStream

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
protected Class<?>	outputClass A Class объект, указывающий на юридический объектный тип для использования createInputStreamInstance метод.

Поля, наследованные от class javax.imageio.spi. IIOServiceProvider

vendorName, version

Сводка конструктора

Конструкторы

Модификатор	Конструктор и Описание
protected	ImageOutputStreamSpi() Создает пробел ImageOutputStreamSpi.
	ImageOutputStreamSpi(String vendorName, String version, Class<?> outputClass) Конструкции ImageOutputStreamSpi с данным набором значений.

Сводка метода

Модификатор и Тип	Метод и Описание
boolean	canUseCacheFile() Возвраты true если ImageOutputStream реализация, связанная с этим поставщиком услуг, может дополнительно использовать кэш File для улучшенной производительности и/или памяти footrprint.
ImageOutputStream	createOutputStreamInstance(Object output) Возвращает экземпляр ImageOutputStream реализация связалась с этим поставщиком услуг.
abstract ImageOutputStream	createOutputStreamInstance(Object output, boolean useCache, File cacheDir) Возвращает экземпляр ImageOutputStream реализация связалась с этим поставщиком услуг.
Class<?>	getOutputClass() Возвраты a Class объект, представляющий class или тип интерфейса, который должен быть реализован выходным местом назначения, чтобы быть "обернутым" в ImageOutputStream через createOutputStreamInstance метод.
boolean	needsCacheFile() Возвраты true если ImageOutputStream реализация, связанная с этим поставщиком услуг, требует использования кэша File.

Методы, наследованные от class javax.imageio.spi. IIOServiceProvider

getDescription, getVendorName, getVersion, onDeregistration, onRegistration

Методы, наследованные от class java.lang. Объект

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

Полевая Деталь

outputClass

protected Class<?> outputClass

A Class объект, указывающий на юридический объектный тип для использования createInputStreamInstance метод.

Деталь конструктора

ImageOutputStreamSpi

protected ImageOutputStreamSpi()

Создает пробел ImageOutputStreamSpi. Это до подкласса, чтобы инициализировать переменные экземпляра и/или реализации метода переопределения, чтобы обеспечить рабочие версии всех методов.

ImageOutputStreamSpi

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

Конструкции ImageOutputStreamSpi с данным набором значений.

Параметры:

vendorName - имя поставщика.

version - идентификатор версии.

outputClass - a Class объект, указывающий на юридический объектный тип для использования createOutputStreamInstance метод.

Броски:

IllegalArgumentException - если vendorName null.

IllegalArgumentException - если version null.

Деталь метода

getOutputClass

public Class<?> getOutputClass()

Возвраты a Class объект, представляющий class или тип интерфейса, который должен быть реализован выходным местом назначения, чтобы быть "обернутым" в ImageOutputStream через createOutputStreamInstance метод.

Типичные возвращаемые значения могли бы включать OutputStream.class или File.class, но любой class может использоваться.

Возвраты:

a 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 - объект типа class, возвращенного getOutputClass.

useCache - a boolean указание, должен ли файл кэша использоваться в случаях, где это является дополнительным.

cacheDir - a File указание, где файл кэша должен быть создан, или null использовать системный каталог.

Возвраты:

ImageOutputStream экземпляр.

Броски:

IllegalArgumentException - если output не экземпляр корректного class или null.

IllegalArgumentException - если файл кэша необходим, но cacheDir не -null и не каталог.

IOException - если файл кэша необходим, но не может быть создан.

См. Также:

getOutputClass()

createOutputStreamInstance

public ImageOutputStream createOutputStreamInstance(Object output)
                                             throws IOException

Возвращает экземпляр ImageOutputStream реализация связалась с этим поставщиком услуг. Файл кэша будет создаваться в системно-зависимом каталоге временного файла значения по умолчанию, если нужно.

Параметры:

output - объект типа class, возвращенного getOutputClass.

Возвраты:

ImageOutputStream экземпляр.

Броски:

IllegalArgumentException - если output не экземпляр корректного class или null.

IOException - если файл кэша необходим, но не может быть создан.

См. Также:

getOutputClass()