Класс 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 равно null.; IllegalArgumentException - если version равно null.

IIOServiceProvider

public IIOServiceProvider()

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

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

onRegistration

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

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

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

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

Задано в:

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

Параметры:

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

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

См. также:

onDeregistration

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

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

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

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

Задано в:

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

Параметры:

registry - ServiceRegistry , из которого этот объект (полностью или частично) удаляется из реестра.

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

См. также:

getVendorName

public String getVendorName()

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

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

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

getVersion

public String getVersion()

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

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

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

getDescription

public abstract String getDescription(Locale locale)

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

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

© 1993, 2023, 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/21/docs/api/java.desktop/javax/imageio/spi/IIOServiceProvider.html