Класс IIOServiceProvider

java.lang.Object
- javax.imageio.spi.IIOServiceProvider

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

Прямые известные подклассы:: ImageInputStreamSpi, ImageOutputStreamSpi, ImageReaderWriterSpi, ImageTranscoderSpi

public abstract class IIOServiceProvider
extends Object
implements RegisterableService

Надкласс, описывающий функциональность, общую для всех поставщиков служб ввода/вывода изображений (SPI). Дополнительную информацию о классах поставщиков служб см. в комментарии к классу IIORegistry.

См. также:: IIORegistry, ImageReaderSpi, ImageWriterSpi, ImageTranscoderSpi, ImageInputStreamSpi, ImageOutputStreamSpi

Поля

Модификатор и тип	Поле	Описание
`protected String`	`vendorName`	Строка, которая должна быть возвращена методом `getVendorName`, изначально `null`.
`protected String`	`version`	Строка, которая должна быть возвращена методом `getVersion`, изначально null.

Краткое описание конструкторов

Конструктор	Описание
`IIOServiceProvider()`	Создаёт пустой объект `IIOServiceProvider`.
`IIOServiceProvider(String vendorName, String version)`	Создаёт объект `IIOServiceProvider` с заданным именем поставщика и идентификатором версии.

Краткое описание методов

Модификатор и тип	Метод	Описание
`abstract String`	`getDescription(Locale locale)`	Возвращает краткое, удобочитаемое описание этого поставщика услуг и его реализации.
`String`	`getVendorName()`	Возвращает имя поставщика, ответственного за создание этого поставщика услуг и его реализации.
`String`	`getVersion()`	Возвращает строку, описывающую номер версии этого поставщика услуг и его реализации.
`void`	`onDeregistration(ServiceRegistry registry, Class<?> category)`	Обратный вызов, который будет выполнен при отмене регистрации класса Spi из `ServiceRegistry`.
`void`	`onRegistration(ServiceRegistry registry, Class<?> category)`	Обратный вызов, который будет вызван ровно один раз после создания и регистрации класса Spi в `ServiceRegistry`.

Методы, унаследованные от класса java.lang.Object

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

Подробное описание полей

vendorName

protected String vendorName

Строка, которая должна быть возвращена методом getVendorName, изначально null. Конструкторы должны устанавливать это значение на непустое.

version

protected String version

Строка, которая должна быть возвращена методом getVersion, изначально null. Конструкторы должны устанавливать это значение на непустое.

Подробное описание конструкторов

IIOServiceProvider

public IIOServiceProvider(String vendorName,
                          String version)

Создаёт объект IIOServiceProvider с заданным именем поставщика и идентификатором версии.

Параметры:: vendorName - имя поставщика.; version - идентификатор версии.
Исключения:: IllegalArgumentException - если vendorName является пустой строкой.; IllegalArgumentException - если version является пустой строкой.

IIOServiceProvider

public IIOServiceProvider()

Создаёт пустой объект IIOServiceProvider. Подклассу необходимо инициализировать переменные экземпляра и/или переопределять реализации методов, чтобы гарантировать, что методы getVendorName и getVersion будут возвращать непустые значения.

Подробное описание методов

onRegistration

public void onRegistration(ServiceRegistry registry,
                           Class<?> category)

Обратный вызов, который будет вызван ровно один раз после создания и регистрации класса Spi в ServiceRegistry. Это может быть использовано для проверки того, что среда подходит для этой службы, например, что можно загрузить родные библиотеки. Если служба не может функционировать в среде, в которой она оказалась, она должна отменить свою регистрацию в реестре.

Только реестр должен вызывать этот метод.

По умолчанию ничего не делает.

Определено в:: onRegistration в интерфейсе RegisterableService
Параметры:: registry - реестр, в котором этот объект был зарегистрирован.; category - объект, указывающий категорию реестра, в которой этот объект был зарегистрирован.
См. также:: ServiceRegistry.registerServiceProvider(Object provider)

onDeregistration

public void onDeregistration(ServiceRegistry registry,
                             Class<?> category)

Обратный вызов, который будет вызван при отмене регистрации класса Spi из ServiceRegistry.

Только реестр должен вызывать этот метод.

По умолчанию ничего не делает.

Определено в:: onDeregistration в интерфейсе RegisterableService
Параметры:: registry - реестр, из которого этот объект был (полностью или частично) отменён от регистрации.; category - объект, указывающий категорию реестра, из которой этот объект был отменён от регистрации.
См. также:: ServiceRegistry.deregisterServiceProvider(Object provider)

getVendorName

public String getVendorName()

Возвращает имя поставщика, ответственного за создание этого поставщика услуг и его реализации. Так как имя поставщика может использоваться для выбора поставщика услуг, оно не локализуется.

По умолчанию возвращает значение переменной экземпляра vendorName.

Возвращает:: непустую строку, содержащую имя поставщика.

getVersion

public String getVersion()

Возвращает строку, описывающую номер версии этого поставщика услуг и его реализации. Так как версия может использоваться транс кодерами для идентификации поставщиков услуг, которые они понимают, этот метод не локализуется.

По умолчанию возвращает значение переменной экземпляра version.

Возвращает:: непустую строку, содержащую версию этого поставщика услуг.

getDescription

public abstract String getDescription(Locale locale)

Возвращает краткое, удобочитаемое описание этого поставщика услуг и его реализации. Результирующая строка должна быть локализована для предоставленного Locale, если это возможно.

Параметры:: locale - Locale для локализации.
Возвращает:: строку, содержащую описание этого поставщика услуг.