javax.imageio.spi
클래스 ImageOutputStreamSpi

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

모든 구현 인터페이스:

RegisterableService

public abstract class ImageOutputStreamSpi

extends IIOServiceProvider

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

이 인터페이스를 사용하면(자), 임의의 오브젝트를 ImageOutputStream 의 인스턴스로 「랩」할 수 있게 됩니다. 예를 들어, 어느 ImageOutputStreamSpi 는 범용 OutputStream 를 행선지로서 사용 가능하고, 다른 ImageOutputStreamSpi 는 File 또는 시리얼 포트등의 디바이스에의 출력이 가능합니다.

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

관련 항목:

IIORegistry , ImageOutputStream

필드의 개요

protected Class

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

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

vendorName , version

생성자의 개요

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

메소드의 개요

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

필드의 상세

outputClass

protected Class  outputClass

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

생성자의 상세

ImageOutputStreamSpi

protected ImageOutputStreamSpi()

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

ImageOutputStreamSpi

public ImageOutputStreamSpi(String  vendorName,
                            String  version,
                            Class  outputClass)

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

파라미터:

vendorName - 벤더명

version - 버젼 식별자

outputClass - createOutputStreamInstance 메소드로 사용되는 정당한 오브젝트형을 나타내는 Class 오브젝트

예외:

IllegalArgumentException - vendorName 가 null 의 경우

IllegalArgumentException - version 가 null 의 경우

메소드의 상세

getOutputClass

public Class  getOutputClass()

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

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

반환값:

Class 변수

관련 항목:

createOutputStreamInstance(Object, boolean, File)

canUseCacheFile

public boolean canUseCacheFile()

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

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

반환값:

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

needsCacheFile

public boolean needsCacheFile()

이 서비스 프로바이더에 관련하는 ImageOutputStream 구현이, 캐쉬 File 를 사용할 필요가 있는 경우,true 를 돌려줍니다.

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

반환값:

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

createOutputStreamInstance

public abstract ImageOutputStream  createOutputStreamInstance(Object  output,
                                                             boolean useCache,
                                                             File  cacheDir)
                                                      throws IOException 

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

파라미터:

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

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

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

반환값:

ImageOutputStream 인스턴스

예외:

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

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

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

관련 항목:

getOutputClass()

createOutputStreamInstance

public ImageOutputStream  createOutputStreamInstance(Object  output)
                                             throws IOException 

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

파라미터:

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

반환값:

ImageOutputStream 인스턴스

예외:

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

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

관련 항목:

getOutputClass()