Класс 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. Конструкторы должны установить это значение на не-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.

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

getVersion

public String getVersion()

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

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

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

getDescription

public abstract String getDescription(Locale locale)

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

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

© 1993, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/imageio/spi/IIOServiceProvider.html