javax.imageio.spi
클래스 ImageReaderSpi

java.lang.Object 
  javax.imageio.spi.IIOServiceProvider 
      javax.imageio.spi.ImageReaderWriterSpi 
          javax.imageio.spi.ImageReaderSpi

모든 구현된 인터페이스:

RegisterableService

public abstract class ImageReaderSpi
extends ImageReaderWriterSpi 

ImageReader 서비스 프로바이더 인터페이스 (SPI)입니다. 서비스 프로바이더 클래스의자세한 내용은 IIORegistry 클래스의 클래스 코멘트를 참조하십시오.

각 ImageReaderSpi는 관련된 ImageReader 클래스에 관한 복수의 정보 타입을 제공합니다.

SPI 클래스를 정의한 vender명으로 클래스의 간결한 설명은, getVendorName, getDescription 및 getVersion 메서드로 취득할 수 있습니다. 이러한 메서드는 국제화의해 로케일 고유의 출력을 실시하는 것이 가능합니다. 이러한 메서드의 주된 목적은 pop-up menu등의 리스트 편성에 사용 가능해, 간결하고 판독 가능한 정보를 제공하는 것입니다.

서비스에 관련된 형식명, 파일접미말 및 MIME 타입의 리스트는 각각 getFormatNames, getFileSuffixes 및 getMIMETypes 메서드로 취득할 수 있습니다. 이러한 메서드는 수동의 형식 선택, 파일의 명명, 또는 MIME 관련짓고 (예를 들어 HTTP 경유 또는 전자 메일 첨부의 파일 액세스)에 근거해 특정의 파일 또는 스트림을 디코드할 때, 후보가 되는 ImageReader 식별로 사용할 수 있습니다.

특정의 데이터 스트림을 구문 분석 할 수 있을 가능성의 높은 ImageReader를 판정하기 위한, 보다 신뢰성의 높은 수단이 canDecodeInput 메서드에 준비되어 있습니다. 서비스 프로바이더는 이 메서드를 사용해 실제의 스트림 내용을 검증할 수 있습니다.

이 서비스 프로바이더에 관련된 ImageReader 클래스의 인스턴스는 createReaderInstance 메서드를 호출하는 것으로 취득할 수 있습니다. 네이티브 라이브러리의 로드나 대규모 테이블 작성등의 부하의 높은 초기화는 적어도 이 메서드가 최초로 불려 갈 때까지 연기할 필요가 있습니다.

관련 항목:

IIORegistry, ImageReader

필드 개요

protected Class []	inputTypes getInputTypes로 부터 리턴된 Class 객체의 배열로 처음은 null 입니다.
static Class []	STANDARD_INPUT_TYPE getInputTypes로 부터 리턴된 단일 요소의 배열로 처음은 ImageInputStream.class가 포함되어 있습니다.
protected String []	writerSpiNames getImageWriterSpiNames 로부터 리턴된 캐릭터 라인의 배열로 처음은 null 입니다.

클래스 javax.imageio.spi. ImageReaderWriterSpi 로부터 상속된 필드

extraImageMetadataFormatClassNames, extraImageMetadataFormatNames, extraStreamMetadataFormatClassNames, extraStreamMetadataFormatNames, MIMETypes, names, nativeImageMetadataFormatClassName, nativeImageMetadataFormatName, nativeStreamMetadataFormatClassName, nativeStreamMetadataFormatName, pluginClassName, suffixes, supportsStandardImageMetadataFormat, supportsStandardStreamMetadataFormat

클래스 javax.imageio.spi. IIOServiceProvider 로부터 상속된 필드

vendorName, version

생성자 개요

protected

ImageReaderSpi () 공백의 ImageReaderSpi를 구축합니다.

ImageReaderSpi (String vendorName, String version, String [] names, String [] suffixes, String [] MIMETypes, String readerClassName, Class [] inputTypes, String [] writerSpiNames, boolean supportsStandardStreamMetadataFormat, String nativeStreamMetadataFormatName, String nativeStreamMetadataFormatClassName, String [] extraStreamMetadataFormatNames, String [] extraStreamMetadataFormatClassNames, boolean supportsStandardImageMetadataFormat, String nativeImageMetadataFormatName, String nativeImageMetadataFormatClassName, String [] extraImageMetadataFormatNames, String [] extraImageMetadataFormatClassNames) 지정된 값세트를 사용해 ImageReaderSpi를 구축합니다.

메서드 개요

abstract boolean	canDecodeInput (Object source) 지정된 소스 객체가 이 리더로 지원 되는 형식이다고 보여지는 경우에 true를 리턴합니다.
ImageReader	createReaderInstance () 이 서비스 프로바이더에 관련된 ImageReader 구현의 인스턴스를 리턴합니다.
abstract ImageReader	createReaderInstance (Object extension) 이 서비스 프로바이더에 관련된 ImageReader 구현의 인스턴스를 리턴합니다.
String []	getImageWriterSpiNames () 이 서비스 프로바이더에 관련된 ImageReader가 사용하는 내부 메타데이타 표현을 인식 가능한 ImageWriterSpi 클래스 모든 완전 지정명을 포함한 String 배열, 이런 종류의 ImageWriter가 지정되어 있지 않은 경우는 null을 리턴합니다.
Class []	getInputTypes () 리더의 setInput 메서드의 인수에 사용 가능한 객체의 형태를 나타내는 Class 객체의 배열을 리턴합니다.
boolean	isOwnReader (ImageReader reader) 건네받은 ImageReader 객체가 이 서비스 프로바이더에 관련된 ImageReader 인스턴스의 경우는 true를 리턴합니다.

클래스 javax.imageio.spi. ImageReaderWriterSpi 로부터 상속된 메서드

getExtraImageMetadataFormatNames, getExtraStreamMetadataFormatNames, getFileSuffixes, getFormatNames, getImageMetadataFormat, getMIMETypes, getNativeImageMetadataFormatName, getNativeStreamMetadataFormatName, getPluginClassName, getStreamMetadataFormat, isStandardImageMetadataFormatSupported, isStandardStreamMetadataFormatSupported

클래스 javax.imageio.spi. IIOServiceProvider 로부터 상속된 메서드

getDescription, getVendorName, getVersion, onDeregistration, onRegistration

클래스 java.lang. Object 로부터 상속된 메서드

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

필드의 상세

STANDARD_INPUT_TYPE

public static final Class [] STANDARD_INPUT_TYPE

getInputTypes로 부터 리턴된 단일 요소의 배열로 처음은 ImageInputStream.class가 포함되어 있습니다.

inputTypes

protected Class [] inputTypes

getInputTypes로 부터 리턴된 Class 객체의 배열로 처음은 null 입니다.

writerSpiNames

protected String [] writerSpiNames

getImageWriterSpiNames 로부터 리턴된 캐릭터 라인의 배열로 처음은 null 입니다.

생성자 상세

ImageReaderSpi

protected ImageReaderSpi()

공백의 ImageReaderSpi를 구축합니다. 모든 메서드의 작업 버전을 제공하기 위한, 인스턴스 변수의 초기화나 메서드 구현의 오버라이드(override)는 서브 클래스에서 실시할 필요가 있습니다.

ImageReaderSpi

public ImageReaderSpi(String  vendorName,
                      String  version,
                      String [] names,
                      String [] suffixes,
                      String [] MIMETypes,
                      String  readerClassName,
                      Class [] inputTypes,
                      String [] writerSpiNames,
                      boolean supportsStandardStreamMetadataFormat,
                      String  nativeStreamMetadataFormatName,
                      String  nativeStreamMetadataFormatClassName,
                      String [] extraStreamMetadataFormatNames,
                      String [] extraStreamMetadataFormatClassNames,
                      boolean supportsStandardImageMetadataFormat,
                      String  nativeImageMetadataFormatName,
                      String  nativeImageMetadataFormatClassName,
                      String [] extraImageMetadataFormatNames,
                      String [] extraImageMetadataFormatClassNames)

지정된 값세트를 사용해 ImageReaderSpi를 구축합니다.

파라미터:

vendorName - 벤더명 (null 이외의 String)

version - 버전 식별자 (null 이외의 String)

names - 형식명을 나타내는 null 이외의 String 배열. 엔트리가 적어도 1개 존재할 필요가 있는

suffixes - 공통의 파일접미말을 나타내는 String 배열. 접미말이 정의되어 있지 않은 경우는 null을 지정한다. 길이 0 배열은 null에 정규화되는

MIMETypes - 형식의 MIME 타입을 나타내는 String 배열. MIME 타입이 정의되어 있지 않은 경우는 null을 지정한다. 길이 0 배열은 null에 정규화되는

readerClassName - 관련된 ImageReader 클래스의 완전 지정명 (null 이외의 String)

inputTypes - 정당한 입력 타입을 나타내는 길이 1 이상의 Class 객체의 배열 (null 이외)

writerSpiNames - 관련된 모든 ImageWriter 클래스를 명명하는 String 배열, 또는 null. 길이 0 배열은 null에 정규화되는

supportsStandardStreamMetadataFormat - 스트림메타데이타오브제크트가 표준의 메타데이타 형식에서 기술된 트리를 사용할 수 있을지 어떨지를 나타내는 boolean

nativeStreamMetadataFormatName - getNativeStreamMetadataFormatName로 부터 리턴된 String, 또는 null

nativeStreamMetadataFormatClassName - getNativeStreamMetadataFormat 으로부터 리턴된 메타데이타 형식 객체의 인스턴스화로 사용하는 String, 또는 null

extraStreamMetadataFormatNames - getExtraStreamMetadataFormatNames로 부터 리턴된 String 배열, 또는 null. 길이 0 배열은 null에 정규화되는

extraStreamMetadataFormatClassNames - getStreamMetadataFormat로 부터 리턴된 메타데이타 형식 객체의 인스턴스화로 사용하는 String배열, 또는 null. 길이 0 배열은 null에 정규화되는

supportsStandardImageMetadataFormat - 이메이지메타데이타오브제크트가 표준의 메타데이타 형식에서 기술된 트리를 사용할 수 있을지 어떨지를 나타내는 boolean

nativeImageMetadataFormatName - getNativeImageMetadataFormatName로 부터 리턴된 String, 또는 null

nativeImageMetadataFormatClassName - getNativeImageMetadataFormat 으로부터 리턴된 메타데이타 형식 객체의 인스턴스화로 사용하는 String, 또는 null

extraImageMetadataFormatNames - getExtraImageMetadataFormatNames 로부터 리턴된 String배열. 길이 0 배열은 null에 정규화되는

extraImageMetadataFormatClassNames - getImageMetadataFormat로 부터 리턴된 메타데이타 형식 객체의 인스턴스화로 사용하는 String배열, 또는 null. 길이 0 배열은 null에 정규화된다

예외:

IllegalArgumentException - vendorName가 null인 경우

IllegalArgumentException - version가 null인 경우

IllegalArgumentException - names가 null 또는 길이 0인 경우

IllegalArgumentException - readerClassName가 null인 경우

IllegalArgumentException - inputTypes가 null 또는 길이 0인 경우

메서드의 상세

getInputTypes

public Class [] getInputTypes()

리더의 setInput 메서드의 인수에 사용 가능한 객체의 형태를 나타내는 Class 객체의 배열을 리턴합니다.

ImageInputStream로 부터의 입력을 받을 뿐의 대부분의 리더의 경우, ImageInputStream.class를 포함한 단일 요소의 배열이 리턴됩니다 .

반환값:

길이 1 이상의 Class 객체의, null 이외의 배열

canDecodeInput

public abstract boolean canDecodeInput(Object  source)
                                throws IOException 

지정된 소스 객체가 이 리더로 지원 되는 형식이다고 보여지는 경우에 true를 리턴합니다. 이 메서드로부터 true가 돌려주고져도 read에 성공하는 것은 보증되지 않고, 스트림 내용의 간결한 검증에 근거해 성공의 가능성이 꽤 높다고 보여지는 것에 지나지 않습니다. 소스가 ImageInputStream인 경우, 구현은 일반적으로 스트림의 최초의 수바이트를 체크해, 이 형식에 관련된 「매직 번호」를 확인합니다. 실제의 read가 시작되어 도, 디코딩이 완료할 때까지 언제라도 리더는 실패할 가능성이 있습니다.

다른 ImageReaderSpi가 객체를 디코드할 수 있을지 어떨지 적절히 판정할 수 있도록, 객체 상태를 방해하지 않는 것이 중요합니다. 특히, 소스가 ImageInputStream인 경우, mark/reset 페어를 사용해 스트림 위치를 보관 유지할 필요가 있습니다.

거의 모든 스트림의 read를 시도할 가능성이 있는 「raw」등의 형식에서는 보다 적절한 것보다 우선해 호출되는 것을 피하기 위해서 false를 돌려줄 필요가 있습니다.

source가 getInputTypes로 부터 리턴된 클래스의 머지않아도 아닌 경우, 이 메서드는 false를 돌려줄 뿐입니다.

파라미터:

source - 디코드되는 객체. 일반적으로 ImageInputStream

반환값:

이 스트림을 디코드 가능한 경우는 true

예외:

IllegalArgumentException - source가 null인 경우

IOException - 스트림의 read중에 입출력 에러가 발생했을 경우

createReaderInstance

public ImageReader  createReaderInstance()
                                 throws IOException 

이 서비스 프로바이더에 관련된 ImageReader 구현의 인스턴스를 리턴합니다. 리턴된 객체의 초기 상태는 reset 메서드의 호출 후와 같은 상태입니다.

디폴트의 구현에서는 createReaderInstance(null)를 돌려줄 뿐입니다.

반환값:

ImageReader인스턴스

예외:

IOException - 리더 클래스의 로드나 초기화, 또는 리더 객체의 인스턴스화나 초기화로 에러가 발생했을 경우

createReaderInstance

public abstract ImageReader  createReaderInstance(Object  extension)
                                          throws IOException 

이 서비스 프로바이더에 관련된 ImageReader 구현의 인스턴스를 리턴합니다. 리턴된 객체의 초기 상태는 reset 메서드의 호출 후와 같은 상태입니다.

구축시에 Object를 플러그 인에 제공할 수 있습니다. 객체의 특성은 플러그 인에 따라서 다릅니다.

보통, 플러그 인은 return new MyImageReader(this) 등의 코드를 사용해 이 메서드를 구현합니다.

파라미터:

extension - 플러그 인 고유의 확장 객체. null도 가능

반환값:

ImageReader인스턴스

예외:

IOException - 리더의 인스턴스화에 실패했을 경우

IllegalArgumentException - 확장 객체가 적절하지 않은 것을 나타내기 위해서 ImageReader 생성자가 IllegalArgumentException을 Throw 하는 경우

isOwnReader

public boolean isOwnReader(ImageReader  reader)

건네받은 ImageReader 객체가 이 서비스 프로바이더에 관련된 ImageReader 인스턴스의 경우는 true를 리턴합니다.

디폴트의 구현에서는 인수 reader 완전 지정 클래스명으로 생성자에게 건네진 클래스명을 비교합니다. 또한 고도의 체크가 필요한 경우는 이 메서드를 오버라이드(override) 할 수 있습니다.

파라미터:

reader - ImageReader인스턴스

반환값:

reader가 인식되는 경우는 true

예외:

IllegalArgumentException - reader가 null인 경우

getImageWriterSpiNames

public String [] getImageWriterSpiNames()

이 서비스 프로바이더에 관련된 ImageReader가 사용하는 내부 메타데이타 표현을 인식 가능한 ImageWriterSpi 클래스 모든 완전 지정명을 포함한 String 배열, 이런 종류의 ImageWriter가 지정되어 있지 않은 경우는 null을 리턴합니다. null 이외의 값이 리턴된인 경우는 0 이외의 길이가 됩니다.

배열의 최초의 항목은, ImageIO.getImageWriter(ImageReader)로 부터 리턴된 ImageWriter 인스턴스화로 사용되기 때문에 「우선된다」라이터의 서비스 프로바이더명이 아니면 안됩니다.

이 도구는 ImageReader로 생성된 픽셀 이외의 메타데이타 (IIOTreeInfo를 참조)의 내부 구조를 인식하는 ImageWriters 취득에 사용할 수 있습니다. ImageReader로 부터 이 데이터를 취득해, 이 메서드로 취득하고 싶은 차이인가의 ImageWriters에 건네주면, 클라이언트 프로그램으로 모든 메타데이타를 보관 유지하면서, 이미지의 read나 변경, 쓰기 반환을 실시할 수가 있어 메타데이타의 내부 구조나 이미지 형식조차 아무것도 식할 필요는 없습니다.

반환값:

ImageWriterSpi 이름을 포함한 길이 1 이상의 String 배열, 또는 null

관련 항목:

ImageIO.getImageWriter(ImageReader)