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 kr 존재할 필요가 있는

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 의 constructor 이 IllegalArgumentException 를 슬로우 하는 경우

isOwnReader

public boolean isOwnReader(ImageReader  reader)

건네받은 ImageReader 오브젝트가 이 서비스 프로바이더에 관련하는 ImageReader 의 인스턴스의 경우는 true 를 돌려줍니다.

디폴트의 구현에서는 인수 reader 의 완전 지정 클래스명으로 constructor로 건네진 클래스명을 비교합니다. 한층 더 고도의 체크가 필요한 경우는 이 메소드를 오버라이드(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)