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()