javax.imageio.spi

Класс ImageReaderWriterSpi

java.lang. Объект

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 Массив Strings содержащий имена классов любых дополнительных форматов метаданных изображения, поддерживаемых этим плагином, первоначально null.
protected String[]	extraImageMetadataFormatNames Массив Strings содержащий имена любых дополнительных форматов метаданных изображения, поддерживаемых этим плагином, первоначально null.
protected String[]	extraStreamMetadataFormatClassNames Массив Strings содержащий имена классов любых дополнительных потоковых форматов метаданных, поддерживаемых этим плагином, первоначально null.
protected String[]	extraStreamMetadataFormatNames Массив Strings содержащий имена любых дополнительных потоковых форматов метаданных, поддерживаемых этим плагином, первоначально null.
protected String[]	MIMETypes Массив строк, которые будут возвращены из getMIMETypes, первоначально null.
protected String[]	имена Массив строк, которые будут возвращены из getFormatNames, первоначально null.
protected String	nativeImageMetadataFormatClassName A String содержа имя класса собственного потокового формата метаданных, поддерживаемого этим плагином, первоначально null.
protected String	nativeImageMetadataFormatName A String содержа имя собственного потокового формата метаданных, поддерживаемого этим плагином, первоначально null.
protected String	nativeStreamMetadataFormatClassName A String содержа имя класса собственного потокового формата метаданных, поддерживаемого этим плагином, первоначально null.
protected String	nativeStreamMetadataFormatName A String содержа имя собственного потокового формата метаданных, поддерживаемого этим плагином, первоначально null.
protected String	pluginClassName A String содержа имя связанного сменного класса, первоначально null.
protected String[]	суффиксы Массив строк, которые будут возвращены из 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 с данным набором значений.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
Строка[]	getExtraImageMetadataFormatNames() Возвращает массив Strings содержащий имена дополнительных форматов документа, кроме собственных и стандартных форматов, распознанных getAsTree и setFromTree методы на объектах метаданных изображения, произведенных или использованных этим плагином.
Строка[]	getExtraStreamMetadataFormatNames() Возвращает массив Strings содержащий имена дополнительных форматов документа, кроме собственных и стандартных форматов, распознанных getAsTree и setFromTree методы на потоковых объектах метаданных, произведенных или использованных этим плагином.
Строка[]	getFileSuffixes() Возвращает массив Strings содержащий список суффиксов файла, связанных с форматами, которые обычно применимы ImageReader или ImageWriter реализация связалась с этим поставщиком услуг.
Строка[]	getFormatNames() Возвращает массив Strings содержащий удобочитаемые имена для форматов, которые обычно применимы ImageReader или ImageWriter реализация связалась с этим поставщиком услуг.
IIOMetadataFormat	getImageMetadataFormat(String formatName) Возвраты IIOMetadataFormat объект, описывающий данный формат метаданных изображения, или null если никакое описание не доступно.
Строка[]	getMIMETypes() Возвращает массив Strings содержащий список типов MIME, связанных с форматами, которые обычно применимы ImageReader или ImageWriter реализация связалась с этим поставщиком услуг.
Строка	getNativeImageMetadataFormatName() Возвращает имя "собственного" формата метаданных изображения для этого плагина, который обычно учитывает кодирование без потерь и передачу метаданных изображения, сохраненных в формате, обработанном этим плагином.
Строка	getNativeStreamMetadataFormatName() Возвращает имя "собственного" потокового формата метаданных для этого плагина, который обычно учитывает кодирование без потерь и передачу потоковых метаданных, сохраненных в формате, обработанном этим плагином.
Строка	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 унаследованный от класса. Объект

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

Полевая Деталь

имена

protected String[] names

Массив строк, которые будут возвращены из getFormatNames, первоначально null. Конструкторы должны установить это в не -null значение.

суффиксы

protected String[] suffixes

Массив строк, которые будут возвращены из getFileSuffixes, первоначально null.

MIMETypes

protected String[] MIMETypes

Массив строк, которые будут возвращены из getMIMETypes, первоначально null.

pluginClassName

protected String pluginClassName

A String содержа имя связанного сменного класса, первоначально null.

supportsStandardStreamMetadataFormat

protected boolean supportsStandardStreamMetadataFormat

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

nativeStreamMetadataFormatName

protected String nativeStreamMetadataFormatName

A String содержа имя собственного потокового формата метаданных, поддерживаемого этим плагином, первоначально null.

nativeStreamMetadataFormatClassName

protected String nativeStreamMetadataFormatClassName

A String содержа имя класса собственного потокового формата метаданных, поддерживаемого этим плагином, первоначально null.

extraStreamMetadataFormatNames

protected String[] extraStreamMetadataFormatNames

Массив Strings содержащий имена любых дополнительных потоковых форматов метаданных, поддерживаемых этим плагином, первоначально null.

extraStreamMetadataFormatClassNames

protected String[] extraStreamMetadataFormatClassNames

Массив Strings содержащий имена классов любых дополнительных потоковых форматов метаданных, поддерживаемых этим плагином, первоначально null.

supportsStandardImageMetadataFormat

protected boolean supportsStandardImageMetadataFormat

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

nativeImageMetadataFormatName

protected String nativeImageMetadataFormatName

A String содержа имя собственного потокового формата метаданных, поддерживаемого этим плагином, первоначально null.

nativeImageMetadataFormatClassName

protected String nativeImageMetadataFormatClassName

A String содержа имя класса собственного потокового формата метаданных, поддерживаемого этим плагином, первоначально null.

extraImageMetadataFormatNames

protected String[] extraImageMetadataFormatNames

Массив Strings содержащий имена любых дополнительных форматов метаданных изображения, поддерживаемых этим плагином, первоначально null.

extraImageMetadataFormatClassNames

protected String[] extraImageMetadataFormatClassNames

Массив Strings содержащий имена классов любых дополнительных форматов метаданных изображения, поддерживаемых этим плагином, первоначально 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 - a boolean это указывает, может ли потоковый объект метаданных использовать деревья, описанные стандартным форматом метаданных.

nativeStreamMetadataFormatName - a String, или null, быть возвращенным из getNativeStreamMetadataFormatName.

nativeStreamMetadataFormatClassName - a String, или null, чтобы использоваться, чтобы инстанцировать метаданных форматируют объект, который будет возвращен из getNativeStreamMetadataFormat.

extraStreamMetadataFormatNames - массив Strings, или null, быть возвращенным из getExtraStreamMetadataFormatNames. Массив длины 0 нормализуется к null.

extraStreamMetadataFormatClassNames - массив Strings, или null, чтобы использоваться, чтобы инстанцировать метаданных форматируют объект, который будет возвращен из getStreamMetadataFormat. Массив длины 0 нормализуется к null.

supportsStandardImageMetadataFormat - a boolean это указывает, может ли объект метаданных изображения использовать деревья, описанные стандартным форматом метаданных.

nativeImageMetadataFormatName - a String, или null, быть возвращенным из getNativeImageMetadataFormatName.

nativeImageMetadataFormatClassName - a String, или null, чтобы использоваться, чтобы инстанцировать метаданных форматируют объект, который будет возвращен из getNativeImageMetadataFormat.

extraImageMetadataFormatNames - массив Strings, чтобы быть возвращенным из 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()

Возвращает массив Strings содержащий список типов 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 не гарантирует, что файлы, утверждающие иметь тот тип, могут быть обработаны; это просто указывает, что может быть стоящая попытка декодировать или закодировать такие файлы, используя этого поставщика услуг.

Возвраты:

массив Strings или длина по крайней мере 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()

Возвращает массив Strings содержащий имена дополнительных форматов документа, кроме собственных и стандартных форматов, распознанных getAsTree и setFromTree методы на потоковых объектах метаданных, произведенных или использованных этим плагином.

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

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

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

Возвраты:

массив Strings, или нуль.

См. Также:

IIOMetadata.getMetadataFormatNames(), getExtraImageMetadataFormatNames(), getNativeStreamMetadataFormatName()

isStandardImageMetadataFormatSupported

public boolean isStandardImageMetadataFormatSupported()

Возвраты true если стандартный формат метаданных среди форматов документа, распознанных getAsTree и setFromTree методы на объектах метаданных изображения, произведенных или использованных этим плагином.

Возвраты:

true если стандартный формат поддерживается для метаданных изображения.

getNativeImageMetadataFormatName

public String getNativeImageMetadataFormatName()

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

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

Возвраты:

имя собственного формата метаданных изображения, или null.

См. Также:

getExtraImageMetadataFormatNames()

getExtraImageMetadataFormatNames

public String[] getExtraImageMetadataFormatNames()

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

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

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

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

Возвраты:

массив Strings, или нуль.

См. Также:

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 если никакое описание не доступно. Предоставленное имя должно быть собственным iamge именем формата метаданных, стандартным именем формата метаданных, или одним из возвращенных getExtraImageMetadataFormatNames.

Параметры:

formatName - требуемый формат метаданных изображения.

Возвраты:

IIOMetadataFormat объект.

Броски:

IllegalArgumentException - если formatName null или не поддерживаемое имя.