Spec-Zone.ru › OpenJDK 21

Класс ImageReaderWriterSpi

java.lang.Object
javax.imageio.spi.IIOServiceProvider
javax.imageio.spi.ImageReaderWriterSpi
Все реализованные интерфейсы:
RegisterableService
Прямые известные подклассы:
ImageReaderSpi, ImageWriterSpi 
public abstract class ImageReaderWriterSpi extends IIOServiceProvider
Базовый класс, содержащий переменные экземпляров и методы, общие для ImageReaderSpi и ImageWriterSpi.
См. также:
  • IIORegistry
  • ImageReaderSpi
  • ImageWriterSpi

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

Модификатор и тип Поле Описание
protected String[] extraImageMetadataFormatClassNames
Массив String содержащий имена классов дополнительных форматов метаданных изображений, поддерживаемых этим плагином, изначально null.
protected String[] extraImageMetadataFormatNames
Массив String содержащий имена дополнительных форматов метаданных изображений, поддерживаемых этим плагином, изначально null.
protected String[] extraStreamMetadataFormatClassNames
Массив String содержащий имена классов дополнительных форматов метаданных потоков, поддерживаемых этим плагином, изначально null.
protected String[] extraStreamMetadataFormatNames
Массив String содержащий имена дополнительных форматов метаданных потоков, поддерживаемых этим плагином, изначально null.
protected String[] MIMETypes
Массив строк, возвращаемых из getMIMETypes, изначально null.
protected String[] names
Массив строк, возвращаемых из getFormatNames, изначально null.
protected String nativeImageMetadataFormatClassName
String содержащий имя класса родного формата метаданных потока, поддерживаемого этим плагином, изначально null.
protected String nativeImageMetadataFormatName
String содержащий имя родного формата метаданных потока, поддерживаемого этим плагином, изначально null.
protected String nativeStreamMetadataFormatClassName
String содержащий имя класса родного формата метаданных потока, поддерживаемого этим плагином, изначально null.
protected String nativeStreamMetadataFormatName
String содержащий имя родного формата метаданных потока, поддерживаемого этим плагином, изначально null.
protected String pluginClassName
String содержащий имя связанного класса плагина, изначально null.
protected String[] suffixes
Массив строк, возвращаемых из getFileSuffixes, изначально null.
protected boolean supportsStandardImageMetadataFormat
Логическое значение, указывающее, поддерживает ли этот плагин стандартный формат метаданных для метаданных изображения, изначально false.
protected boolean supportsStandardStreamMetadataFormat
Логическое значение, указывающее, поддерживает ли этот плагин стандартный формат метаданных для метаданных потока, изначально false.

Поля, объявленные в классе javax.imageio.spi.IIOServiceProvider

vendorName, version

Краткое описание конструкторов

Конструктор Описание
ImageReaderWriterSpi()
Создаёт пустой ImageReaderWriterSpi.
ImageReaderWriterSpi(String vendorName, String version, String[] names, String[] suffixes, String[] MIMETypes, String pluginClassName, boolean supportsStandardStreamMetadataFormat, String nativeStreamMetadataFormatName, String nativeStreamMetadataFormatClassName, String[] extraStreamMetadataFormatNames, String[] extraStreamMetadataFormatClassNames, boolean supportsStandardImageMetadataFormat, String nativeImageMetadataFormatName, String nativeImageMetadataFormatClassName, String[] extraImageMetadataFormatNames, String[] extraImageMetadataFormatClassNames)
Создаёт ImageReaderWriterSpi с заданными значениями.

Краткое описание методов

Модификатор и тип Метод Описание
String[] getExtraImageMetadataFormatNames()
Возвращает массив String содержащий имена дополнительных форматов документов, отличных от родных и стандартных, распознаваемых методами getAsTree и setFromTree на объектах метаданных изображений, созданных или используемых этим плагином.
String[] getExtraStreamMetadataFormatNames()
Возвращает массив String содержащий имена дополнительных форматов документов, отличных от родных и стандартных, распознаваемых методами getAsTree и setFromTree на объектах метаданных потока, созданных или используемых этим плагином.
String[] getFileSuffixes()
Возвращает массив String содержащий список расширений файлов, связанных с форматами, обычно используемыми реализацией ImageReader или ImageWriter, связанной с этим поставщиком услуг.
String[] getFormatNames()
Возвращает массив String содержащий удобочитаемые имена форматов, обычно используемые реализацией ImageReader или ImageWriter, связанной с этим поставщиком услуг.
IIOMetadataFormat getImageMetadataFormat(String formatName)
Возвращает объект IIOMetadataFormat, описывающий заданный формат метаданных изображения, или null если описание недоступно.
String[] getMIMETypes()
Возвращает массив String содержащий список MIME-типов, связанных с форматами, обычно используемыми реализацией ImageReader или ImageWriter, связанной с этим поставщиком услуг.
String getNativeImageMetadataFormatName()
Возвращает имя "родного" формата метаданных изображения для этого плагина, который обычно позволяет осуществлять беструбый кодирование и передачу метаданных изображения, хранящихся в формате, обрабатываемом этим плагином.
String getNativeStreamMetadataFormatName()
Возвращает имя "родного" формата метаданных потока для этого плагина, который обычно позволяет осуществлять беструбый кодирование и передачу метаданных потока, хранящихся в формате, обрабатываемом этим плагином.
String getPluginClassName()
Возвращает полное имя класса ImageReader или ImageWriter плагина, связанного с этим поставщиком услуг.
IIOMetadataFormat getStreamMetadataFormat(String formatName)
Возвращает объект IIOMetadataFormat, описывающий заданный формат метаданных потока, или null если описание недоступно.
boolean isStandardImageMetadataFormatSupported()
Возвращает true если стандартный формат метаданных входит в список форматов документов, распознаваемых методами getAsTree и setFromTree на объектах метаданных изображений, созданных или используемых этим плагином.
boolean isStandardStreamMetadataFormatSupported()
Возвращает true если стандартный формат метаданных входит в список форматов документов, распознаваемых методами getAsTree и setFromTree на объектах метаданных потока, созданных или используемых этим плагином.

Методы, объявленные в классе javax.imageio.spi.IIOServiceProvider

getDescription, getVendorName, getVersion, onDeregistration, onRegistration

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

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

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

names

protected String[] names
Массив строк, возвращаемых из getFormatNames, по умолчанию null. Конструкторы должны устанавливать его на отличное от null значение.

suffixes

protected String[] suffixes
Массив строк, возвращаемых из getFileSuffixes, по умолчанию null.

MIMETypes

protected String[] MIMETypes
Массив строк, возвращаемых из getMIMETypes, по умолчанию null.

pluginClassName

protected String pluginClassName
Строка, содержащая имя связанного класса плагина, по умолчанию null.

supportsStandardStreamMetadataFormat

protected boolean supportsStandardStreamMetadataFormat
Логическое значение, указывающее, поддерживает ли этот плагин стандартный формат метаданных для потоковых данных, по умолчанию false.

nativeStreamMetadataFormatName

protected String nativeStreamMetadataFormatName
Строка, содержащая имя нативного формата метаданных потока, поддерживаемого этим плагином, по умолчанию null.

nativeStreamMetadataFormatClassName

protected String nativeStreamMetadataFormatClassName
Строка, содержащая имя класса нативного формата метаданных потока, поддерживаемого этим плагином, по умолчанию null.

extraStreamMetadataFormatNames

protected String[] extraStreamMetadataFormatNames
Массив строк, содержащих имена дополнительных форматов метаданных потока, поддерживаемых этим плагином, по умолчанию null.

extraStreamMetadataFormatClassNames

protected String[] extraStreamMetadataFormatClassNames
Массив строк, содержащих имена классов дополнительных форматов метаданных потока, поддерживаемых этим плагином, по умолчанию null.

supportsStandardImageMetadataFormat

protected boolean supportsStandardImageMetadataFormat
Логическое значение, указывающее, поддерживает ли этот плагин стандартный формат метаданных для изображений, по умолчанию false.

nativeImageMetadataFormatName

protected String nativeImageMetadataFormatName
Строка, содержащая имя нативного формата метаданных изображения, поддерживаемого этим плагином, по умолчанию null.

nativeImageMetadataFormatClassName

protected String nativeImageMetadataFormatClassName
Строка, содержащая имя класса нативного формата метаданных изображения, поддерживаемого этим плагином, по умолчанию null.

extraImageMetadataFormatNames

protected String[] extraImageMetadataFormatNames
Массив строк, содержащих имена дополнительных форматов метаданных изображения, поддерживаемых этим плагином, по умолчанию null.

extraImageMetadataFormatClassNames

protected String[] extraImageMetadataFormatClassNames
Массив строк, содержащих имена классов дополнительных форматов метаданных изображения, поддерживаемых этим плагином, по умолчанию null.

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

ImageReaderWriterSpi

public ImageReaderWriterSpi(String vendorName, String version, String[] names, String[] suffixes, String[] MIMETypes, String pluginClassName, boolean supportsStandardStreamMetadataFormat, String nativeStreamMetadataFormatName, String nativeStreamMetadataFormatClassName, String[] extraStreamMetadataFormatNames, String[] extraStreamMetadataFormatClassNames, boolean supportsStandardImageMetadataFormat, String nativeImageMetadataFormatName, String nativeImageMetadataFormatClassName, String[] extraImageMetadataFormatNames, String[] extraImageMetadataFormatClassNames)
Конструирует ImageReaderWriterSpi с заданными значениями.
Параметры:
vendorName - имя поставщика, как не-null String.
version - идентификатор версии, как не-null String.
names - не-null массив Strings, указывающий имена форматов. Должно быть по крайней мере одно значение.
suffixes - массив Strings, указывающий общие расширения файлов. Если расширения не определены, следует использовать null. Массив длиной 0 будет нормализован к null.
MIMETypes - массив Strings, указывающий MIME-типы формата. Если MIME-типы не определены, следует использовать null. Массив длиной 0 будет нормализован к null.
pluginClassName - полное имя связанного класса ImageReader или ImageWriter, как не-null String.
supportsStandardStreamMetadataFormat - логическое значение, указывающее, может ли объект метаданных потока использовать деревья, описанные стандартным форматом метаданных.
nativeStreamMetadataFormatName - строка, или null, возвращаемая из getNativeStreamMetadataFormatName.
nativeStreamMetadataFormatClassName - строка, или null, используемая для создания объекта формата метаданных, возвращаемого из getNativeStreamMetadataFormat.
extraStreamMetadataFormatNames - массив Strings, или null, возвращаемых из getExtraStreamMetadataFormatNames. Массив длиной 0 нормализуется до null.
extraStreamMetadataFormatClassNames - массив Strings, или null, используемый для создания объекта формата метаданных, возвращаемого из getStreamMetadataFormat. Массив длиной 0 нормализуется до null.
supportsStandardImageMetadataFormat - логическое значение, указывающее, может ли объект метаданных изображения использовать деревья, описанные стандартным форматом метаданных.
nativeImageMetadataFormatName - строка, или null, возвращаемая из getNativeImageMetadataFormatName.
nativeImageMetadataFormatClassName - строка, или null, используемая для создания объекта формата метаданных, возвращаемого из getNativeImageMetadataFormat.
extraImageMetadataFormatNames - массив строк, возвращаемый из getExtraImageMetadataFormatNames. Массив длиной 0 нормализуется до null.
extraImageMetadataFormatClassNames - массив Strings, или null, используемый для создания объекта формата метаданных, возвращаемого из getImageMetadataFormat. Массив длиной 0 нормализуется до null.
Исключения:
IllegalArgumentException - если vendorName является null.
IllegalArgumentException - если version является null.
IllegalArgumentException - если names является null или имеет длину 0.
IllegalArgumentException - если pluginClassName является null.

ImageReaderWriterSpi

public ImageReaderWriterSpi()
Конструирует пустой ImageReaderWriterSpi. Подклассу необходимо инициализировать переменные экземпляра и/или переопределить реализации методов, чтобы предоставить рабочие версии всех методов.

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

getFormatNames

public String[] getFormatNames()
Возвращает массив Strings, содержащий удобочитаемые имена форматов, которые могут быть использованы реализацией ImageReader или ImageWriter , связанной с этим поставщиком сервиса. Например, один ImageReader может обрабатывать файлы PBM и PNM.
Возвращает:
не-null массив Strings длиной не менее 1, содержащий неофициальные имена форматов, связанные с этим чтецом или записывателем.

getFileSuffixes

public String[] getFileSuffixes()
Возвращает массив Strings, содержащий список расширений файлов, связанных с форматами, которые могут быть использованы реализацией ImageReader или ImageWriter , связанной с этим поставщиком сервиса. Например, один ImageReader может обрабатывать файлы с расширениями '.pbm' и '.pnm' или '.jpg' и '.jpeg'. Если известные расширения файлов отсутствуют, возвращается null.

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

Возвращает:
массив Strings длиной не менее 1, содержащий общие расширения файлов, связанные с этим чтецом или записывателем, или null.

getMIMETypes

public String[] getMIMETypes()
Возвращает массив String содержащий список типов MIME, связанных с форматами, которые обычно поддерживаются реализацией ImageReader или ImageWriter , связанной с этим поставщиком услуг.

В идеале, для описания конкретного формата потребовался бы только один тип MIME. Однако по нескольким причинам необходимо связать список типов с каждым поставщиком услуг. Во-первых, у многих распространённых форматов изображений нет стандартных типов MIME, поэтому потребуется список обычно используемых неофициальных названий, таких как image/x-pbm и image/x-portable-bitmap. Некоторые форматы файлов имеют официальные типы MIME, но иногда могут упоминаться по своим предыдущим неофициальным обозначениям, таким как image/x-png вместо официального image/png. Наконец, один поставщик услуг может быть способен обрабатывать несколько различных типов с точки зрения MIME, например, image/x-xbitmap и image/x-xpixmap.

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

Возвращает:
массив String или длиной не менее 1, содержащий типы MIME, связанные с этим читателем или писателем, или null.

getPluginClassName

public String getPluginClassName()
Возвращает полное имя класса плагина ImageReader или ImageWriter , связанного с этим поставщиком услуг.
Возвращает:
имя класса в виде не-null String.

isStandardStreamMetadataFormatSupported

public boolean isStandardStreamMetadataFormatSupported()
Возвращает true , если стандартный формат метаданных входит в число форматов документов, распознаваемых методами getAsTree и setFromTree на объектах метаданных потока, созданных или потребляемых этим плагином.
Возвращает:
true , если стандартный формат поддерживается для метаданных потока.

getNativeStreamMetadataFormatName

public String getNativeStreamMetadataFormatName()
Возвращает имя "родного" формата метаданных потока для этого плагина, который обычно позволяет бес потерь кодировать и передавать метаданные потока, хранящиеся в формате, обрабатываемом этим плагином. Если такой формат не поддерживается, возвращается null.

Реализация по умолчанию возвращает переменную nativeStreamMetadataFormatName , которая обычно устанавливается конструктором.

Возвращает:
имя родного формата метаданных потока или null.

getExtraStreamMetadataFormatNames

public String[] getExtraStreamMetadataFormatNames()
Возвращает массив String содержащий имена дополнительных форматов документов, помимо родных и стандартных, распознаваемых методами getAsTree и setFromTree на объектах метаданных потока, созданных или потребляемых этим плагином.

Если плагин не обрабатывает метаданные, должен быть возвращён null.

Набор форматов может отличаться в зависимости от конкретных изображений, которые считываются или записываются; этот метод должен указывать все дополнительные форматы, поддерживаемые плагином при любых обстоятельствах.

Реализация по умолчанию возвращает копию переменной extraStreamMetadataFormatNames , которая обычно устанавливается конструктором.

Возвращает:
массив String или null.
См. также:
  • IIOMetadata.getMetadataFormatNames()
  • getExtraImageMetadataFormatNames()
  • getNativeStreamMetadataFormatName()

isStandardImageMetadataFormatSupported

public boolean isStandardImageMetadataFormatSupported()
Возвращает true , если стандартный формат метаданных входит в число форматов документов, распознаваемых методами getAsTree и setFromTree на объектах метаданных изображения, созданных или потребляемых этим плагином.
Возвращает:
true , если стандартный формат поддерживается для метаданных изображения.

getNativeImageMetadataFormatName

public String getNativeImageMetadataFormatName()
Возвращает имя "родного" формата метаданных изображения для этого плагина, который обычно позволяет бес потерь кодировать и передавать метаданные изображения, хранящиеся в формате, обрабатываемом этим плагином. Если такой формат не поддерживается, возвращается null.

Реализация по умолчанию возвращает переменную nativeImageMetadataFormatName , которая обычно устанавливается конструктором.

Возвращает:
имя родного формата метаданных изображения или null.
См. также:
  • getExtraImageMetadataFormatNames()

getExtraImageMetadataFormatNames

public String[] getExtraImageMetadataFormatNames()
Возвращает массив String содержащий имена дополнительных форматов документов, помимо родных и стандартных, распознаваемых методами getAsTree и setFromTree на объектах метаданных изображения, созданных или потребляемых этим плагином.

Если плагин не обрабатывает метаданные изображения, должен быть возвращён null.

Набор форматов может отличаться в зависимости от конкретных изображений, которые считываются или записываются; этот метод должен указывать все дополнительные форматы, поддерживаемые плагином при любых обстоятельствах.

Реализация по умолчанию возвращает копию переменной extraImageMetadataFormatNames , которая обычно устанавливается конструктором.

Возвращает:
массив String или null.
См. также:
  • IIOMetadata.getMetadataFormatNames()
  • getExtraStreamMetadataFormatNames()
  • getNativeImageMetadataFormatName()

getStreamMetadataFormat

public IIOMetadataFormat getStreamMetadataFormat(String formatName)
Возвращает объект IIOMetadataFormat , описывающий указанный формат метаданных потока, или null , если описание недоступно. Указанное имя должно быть именем родного формата метаданных потока, именем стандартного формата метаданных или одним из возвращаемых методом getExtraStreamMetadataFormatNames.
Параметры:
formatName - желаемый формат метаданных потока.
Возвращает:
объект IIOMetadataFormat.
Исключения:
IllegalArgumentException - если formatName равен null или это не поддерживаемое имя.

getImageMetadataFormat

public IIOMetadataFormat getImageMetadataFormat(String formatName)
Возвращает объект IIOMetadataFormat , описывающий указанный формат метаданных изображения, или null , если описание недоступно. Указанное имя должно быть именем родного формата метаданных изображения, именем стандартного формата метаданных или одним из возвращаемых методом getExtraImageMetadataFormatNames.
Параметры:
formatName - желаемый формат метаданных изображения.
Возвращает:
объект IIOMetadataFormat.
Исключения:
IllegalArgumentException - если formatName равен null или это не поддерживаемое имя.

© 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/ImageReaderWriterSpi.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API