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