javax.imageio.spi

Класс ImageInputStreamSpi

java.lang. Объект

javax.imageio.spi. IIOServiceProvider

javax.imageio.spi. ImageInputStreamSpi

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

RegisterableService

public abstract class ImageInputStreamSpi
extends IIOServiceProvider

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

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

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

См. Также:

IIORegistry, ImageInputStream

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

Поля

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

Поля 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 объект, представляющий класс или интерфейсный тип, который должен быть реализован входным источником, чтобы быть "обернутым" в ImageInputStream через createInputStreamInstance метод.
boolean	needsCacheFile() Возвраты true если ImageInputStream реализация, связанная с этим поставщиком услуг, требует использования кэша File.

Методы javax.imageio.spi унаследованный от класса. IIOServiceProvider

getDescription, getVendorName, getVersion, onDeregistration, onRegistration

Методы 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 объект, представляющий класс или интерфейсный тип, который должен быть реализован входным источником, чтобы быть "обернутым" в ImageInputStream через createInputStreamInstance метод.

Типичные возвращаемые значения могли бы включать InputStream.class или URL.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 - объект типа класса, возвращенного getInputClass.

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

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

Возвраты:

ImageInputStream экземпляр.

Броски:

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

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

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

См. Также:

getInputClass(), canUseCacheFile(), needsCacheFile()

createInputStreamInstance

public ImageInputStream createInputStreamInstance(Object input)
                                           throws IOException

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

Параметры:

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

Возвраты:

ImageInputStream экземпляр.

Броски:

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

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

См. Также:

getInputClass()