Класс 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`	`String`, возвращаемое методом `getVendorName`; изначально `null`.
`protected String`	`version`	`String`, возвращаемое методом `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`.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Показывает, равен ли этот объект какому-либо другому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Финализация объявлена устаревшей и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Переводит текущий поток в состояние ожидания до его пробуждения, обычно вследствие вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Переводит текущий поток в состояние ожидания до его пробуждения, обычно вследствие вызова notify или interrupt, либо до истечения заданного времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Переводит текущий поток в состояние ожидания до его пробуждения, обычно вследствие вызова notify или interrupt, либо до истечения заданного времени.

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

vendorName

protected String vendorName

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

version

protected String version

String, возвращаемое методом 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.