javax.imageio.spi

Класс ImageInputStreamSpi

java.lang. Объект

javax.imageio.spi. IIOServiceProvider

javax.imageio.spi. ImageInputStreamSpi

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

RegisterableService

public abstract class ImageInputStreamSpi
extends IIOServiceProvider

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

Этот интерфейс позволяет произвольным объектам быть "обернутыми" экземплярами ImageInputStream. Например, деталь ImageInputStreamSpi мог бы позволить обобщение InputStream использоваться в качестве входного источника; другой мог бы взять ввод от a URL.

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

См. Также:

IIORegistry, ImageInputStream

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

Поля

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

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

vendorName, version

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

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

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

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

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

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

inputClass

protected Class<?> inputClass

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

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

ImageInputStreamSpi

protected ImageInputStreamSpi()

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

ImageInputStreamSpi

public ImageInputStreamSpi(String vendorName,
                           String version,
                           Class<?> inputClass)

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

Параметры:

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

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

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

Броски:

IllegalArgumentException - если vendorName null.

IllegalArgumentException - если version null.

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

getInputClass

public Class<?> getInputClass()

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

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

Возвраты:

a Class переменная.

См. Также:

createInputStreamInstance(Object, boolean, File)

canUseCacheFile

public boolean canUseCacheFile()

Возвраты true если ImageInputStream реализация, связанная с этим поставщиком услуг, может дополнительно использовать файл кэша для улучшенной производительности и/или памяти footrprint. Если false, значение useCache параметр createInputStreamInstance будет проигнорирован.

Возвраты реализации по умолчанию false.

Возвраты:

true если файл кэша может использоваться входными потоками, создаваемыми этим поставщиком услуг.

needsCacheFile

public boolean needsCacheFile()

Возвраты true если ImageInputStream реализация, связанная с этим поставщиком услуг, требует использования кэша File. Если true, значение useCache параметр createInputStreamInstance будет проигнорирован.

Возвраты реализации по умолчанию false.

Возвраты:

true если файл кэша необходим входным потокам, создаваемым этим поставщиком услуг.

createInputStreamInstance

public abstract ImageInputStream createInputStreamInstance(Object input,
                                                           boolean useCache,
                                                           File cacheDir)
                                                    throws IOException

Возвращает экземпляр ImageInputStream реализация связалась с этим поставщиком услуг. Если использование файла кэша является дополнительным, useCache с параметром будут консультироваться. Где кэш требуется, или не применимый, значение useCache будет проигнорирован.

Параметры:

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

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

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

Возвраты:

ImageInputStream экземпляр.

Броски:

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

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

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

См. Также:

getInputClass(), canUseCacheFile(), needsCacheFile()

createInputStreamInstance

public ImageInputStream createInputStreamInstance(Object input)
                                           throws IOException

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

Параметры:

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

Возвраты:

ImageInputStream экземпляр.

Броски:

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

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

См. Также:

getInputClass()