Класс 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.

См. также:: IIORegistry, ImageReaderSpi, ImageWriterSpi, ImageTranscoderSpi, ImageInputStreamSpi

Поля

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

Конструкторы

IIOServiceProvider

public IIOServiceProvider(String vendorName,
                          String version)

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

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

IIOServiceProvider

public IIOServiceProvider()

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

Методы

onRegistration

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

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

Вызов этого метода должен производиться только реестром.

По умолчанию метод ничего не делает.

Унаследованно от:: onRegistration в интерфейсе RegisterableService
Параметры:: registry - ServiceRegistry реестра, в котором зарегистрирован этот объект.; category - объект Class, указывающий категорию реестра, в которой зарегистрирован этот объект.
См. также:: ServiceRegistry.registerServiceProvider(Object provider)

onDeregistration

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

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

Вызов этого метода должен производиться только реестром.

По умолчанию метод ничего не делает.

Унаследованно от:: onDeregistration в интерфейсе RegisterableService
Параметры:: registry - ServiceRegistry, из которого этот объект отменяется (полностью или частично).; 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, 2020, 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.