ImageOutputStreamSpi (Java Platform SE 6) - xrath.com 에서 번역됨

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스

프레임 있어 프레임 없음

개요: 상자 | 필드 | 생성자 | 메소드

상세 : 필드 | 생성자 | 메소드

javax.imageio.spi
클래스 ImageOutputStreamSpi

java.lang.Object 
  javax.imageio.spi.IIOServiceProvider 
      javax.imageio.spi.ImageOutputStreamSpi

모든 구현된 인터페이스:: RegisterableService

public abstract class ImageOutputStreamSpi
extends IIOServiceProvider
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` 구현이, 퍼포먼스나 메모리 소비를 개선하기 위해서 필요에 따라서 캐쉬 `File` 를 사용할 수 있는 경우,`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 구현이, 퍼포먼스나 메모리 소비를 개선하기 위해서 필요에 따라서 캐쉬 File 를 사용할 수 있는 경우,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()