Класс IIOServiceProvider

java.lang.Object

javax.imageio.spi.IIOServiceProvider

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

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

public abstract class IIOServiceProvider extends Object implements RegisterableService

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

См. также:

Краткое описание полей

Модификатор и тип	Поле	Описание
`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. Конструкторы должны задавать её значение, отличное от null.

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

IIOServiceProvider

public IIOServiceProvider(String vendorName, String version)

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

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

IIOServiceProvider

public IIOServiceProvider()

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

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

onRegistration

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

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

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

Реализация по умолчанию ничего не делает.

Унаследовано от:

onRegistration в интерфейсе RegisterableService

Параметры:

registry - реестр, в котором этот объект был зарегистрирован.

category - объект Class, указывающий категорию реестра, в которой этот объект был зарегистрирован.

См. также:

ServiceRegistry.registerServiceProvider(Object provider)

onDeregistration

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

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

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

Реализация по умолчанию ничего не делает.

Унаследовано от:

onDeregistration в интерфейсе RegisterableService

Параметры:

registry - реестр, из которого этот объект был удалён.

category - объект Class, указывающий категорию реестра, из которой этот объект был удалён.

См. также:

ServiceRegistry.deregisterServiceProvider(Object provider)

getVendorName

public String getVendorName()

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

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

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

getVersion

public String getVersion()

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

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

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

getDescription

public abstract String getDescription(Locale locale)

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

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

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.desktop/javax/imageio/spi/IIOServiceProvider.html