Класс IIOServiceProvider

java.lang.Object

javax.imageio.spi.IIOServiceProvider

Все реализуемые интерфейсы:: RegisterableService

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

public abstract class IIOServiceProvider extends Object implements RegisterableService

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

См. также:

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

Модификатор и тип	Поле	Описание
`protected String`	`vendorName`	`getVendorName` возвращает `String`, изначально `null`.
`protected String`	`version`	`getVersion` возвращает `String`, изначально 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`.

Методы, объявленные в классе Object

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

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

vendorName

protected String vendorName

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

version

protected String version

getVersion возвращает String, изначально 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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/imageio/spi/IIOServiceProvider.html