javax.imageio.spi
클래스 ImageInputStreamSpi

java.lang.Object 
  |
  +--javax.imageio.spi.IIOServiceProvider 
        |
        +--javax.imageio.spi.ImageInputStreamSpi

모든 구현 인터페이스:

RegisterableService

public abstract class ImageInputStreamSpi

extends IIOServiceProvider

ImageInputStream 의 서비스 프로바이더 인터페이스 (SPI)입니다. 서비스 프로바이더 인터페이스의 자세한 것은 IIORegistry 클래스의 클래스 코멘트를 참조해 주세요.

이 인터페이스에 의해, 임의의 오브젝트를 ImageInputStream 의 인스턴스로 「랩」할 수 있습니다. 예를 들어, 어느 ImageInputStreamSpi 는 범용의 InputStream 를 입력 소스로서 사용할 수 있어 다른 ImageInputStreamSpi 는 URL 로부터의 입력이 가능합니다.

ImageInputStream 의 작성을 플러그 인 가능한 서비스로서 취급하는 것으로, API 를 변경하지 않고 장래의 입력 소스에 대처하는 것이 가능하게 됩니다. 또, 특정 플랫폼용의 네이티브 구현등의 퍼포먼스가 뛰어난 ImageInputStream 구현을 인스톨 해, 어플리케이션으로 투과적으로 사용할 수 있습니다.

관련 항목:

IIORegistry , ImageInputStream

필드의 개요

protected Class

inputClass createInputStreamInstance 메소드로 사용되는 정당한 오브젝트형을 나타내는 Class 오브젝트입니다.

클래스 javax.imageio.spi. IIOServiceProvider 에서 상속받은 필드

vendorName , version

생성자의 개요

protected	ImageInputStreamSpi () 공백의 ImageInputStreamSpi 를 구축합니다.
	ImageInputStreamSpi (String vendorName, String version, Class inputClass) 지정된 값세트를 사용해 ImageInputStreamSpi 를 구축합니다.

메소드의 개요

boolean	canUseCacheFile () 이 서비스 프로바이더에 관련하는 ImageInputStream 구현이, 퍼포먼스나 메모리 소비를 개선하기 위해서 캐쉬 파일을 필요에 따라서 사용할 수 있는 경우,true 를 돌려줍니다.
ImageInputStream	createInputStreamInstance (Object input) 이 서비스 프로바이더에 관련하는 ImageInputStream 구현의 인스턴스를 돌려줍니다.
abstract ImageInputStream	createInputStreamInstance (Object input, boolean useCache, File cacheDir) 이 서비스 프로바이더에 관련하는 ImageInputStream 구현의 인스턴스를 돌려줍니다.
Class	getInputClass () createInputStreamInstance 메소드를 사용해ImageInputStream 내에 「랩」하기 위한(해), 입력 소스가 구현할 필요가 있는 클래스 또는 인터페이스의 형태를 나타내는 Class 오브젝트를 돌려줍니다.
boolean	needsCacheFile () 이 서비스 프로바이더에 관련하는 ImageInputStream 구현이 캐쉬 File 를 사용할 필요가 있는 경우는 true 를 돌려줍니다.

클래스 javax.imageio.spi. IIOServiceProvider 에서 상속받은 메소드

getDescription , getVendorName , getVersion , onDeregistration , onRegistration

클래스 java.lang. Object 에서 상속받은 메소드

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

필드의 상세

inputClass

protected Class  inputClass

createInputStreamInstance 메소드로 사용되는 정당한 오브젝트형을 나타내는 Class 오브젝트입니다.

생성자의 상세

ImageInputStreamSpi

protected ImageInputStreamSpi()

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

ImageInputStreamSpi

public ImageInputStreamSpi(String  vendorName,
                           String  version,
                           Class  inputClass)

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

파라미터:

vendorName - 벤더명

version - 버젼 식별자

inputClass - createInputStreamInstance 메소드로 사용되는 정당한 오브젝트형을 나타내는 Class 오브젝트입니다.

예외:

IllegalArgumentException - vendorName 가 null 의 경우

IllegalArgumentException - version 가 null 의 경우

메소드의 상세

getInputClass

public Class  getInputClass()

createInputStreamInstance 메소드를 사용해ImageInputStream 내에 「랩」하기 위한(해), 입력 소스가 구현할 필요가 있는 클래스 또는 인터페이스의 형태를 나타내는 Class 오브젝트를 돌려줍니다.

반환값에는 통상 InputStream.class 나 URL.class 가 포함됩니다만, 임의의 클래스를 사용할 수 있습니다.

반환값:

Class 변수

관련 항목:

createInputStreamInstance(Object, boolean, File)

canUseCacheFile

public boolean canUseCacheFile()

이 서비스 프로바이더에 관련하는 ImageInputStream 구현이, 퍼포먼스나 메모리 소비를 개선하기 위해서 캐쉬 파일을 필요에 따라서 사용할 수 있는 경우,true 를 돌려줍니다. false 의 경우,createInputStreamInstance 의 인수 useCache 의 값은 무시됩니다.

디폴트 구현에서는 false 를 돌려줍니다.

반환값:

이 서비스 프로바이더로 작성되는 입력 스트림으로 캐쉬 파일을 사용 가능한 경우는 true

needsCacheFile

public boolean needsCacheFile()

이 서비스 프로바이더에 관련하는 ImageInputStream 구현이 캐쉬 File 를 사용할 필요가 있는 경우는 true 를 돌려줍니다. true 의 경우,createInputStreamInstance 의 인수 useCache 의 값은 무시됩니다.

디폴트 구현에서는 false 를 돌려줍니다.

반환값:

이 서비스 프로바이더에 의해 작성되는 입력 스트림이 캐쉬 파일을 필요로 하는 경우는 true

createInputStreamInstance

public abstract ImageInputStream  createInputStreamInstance(Object  input,
                                                           boolean useCache,
                                                           File  cacheDir)
                                                    throws IOException 

이 서비스 프로바이더에 관련하는 ImageInputStream 구현의 인스턴스를 돌려줍니다. 캐쉬 파일의 사용이 임의의 경우,useCache 파라미터가 참조됩니다. 캐쉬가 필수, 또는 적용할 수 없는 경우는 useCache 의 값은 무시됩니다.

파라미터:

input - getInputClass 로부터 돌려주어지는 클래스형의 오브젝트

useCache - 캐쉬 파일의 사용이 임의의 경우에, 사용할지 어떨지를 나타내는 boolean

cacheDir - 캐쉬 파일이 작성되는 장소를 나타내는 File. 시스템 디렉토리를 사용하는 경우는 null

반환값:

ImageInputStream 인스턴스

예외:

IllegalArgumentException - input 가 적정한 클래스의 인스턴스가 아닌지 null 의 경우

IllegalArgumentException - 캐쉬 파일이 필요하지만,cacheDir 가 null 는 아니고, 디렉토리도 아닌 경우

IOException - 캐쉬 파일이 필요하지만 작성할 수 없는 경우

관련 항목:

getInputClass() , canUseCacheFile() , needsCacheFile()

createInputStreamInstance

public ImageInputStream  createInputStreamInstance(Object  input)
                                           throws IOException 

이 서비스 프로바이더에 관련하는 ImageInputStream 구현의 인스턴스를 돌려줍니다. 필요에 따라서, 캐쉬 파일이 시스템 고유의 디폴트 일시파일 디렉토리에 작성됩니다.

파라미터:

input - getInputClass 로부터 돌려주어지는 클래스형의 오브젝트

반환값:

ImageInputStream 인스턴스

예외:

IllegalArgumentException - input 가 적정한 클래스의 인스턴스가 아닌지 null 의 경우

IOException - 캐쉬 파일이 필요하지만 작성할 수 없는 경우

관련 항목:

getInputClass()