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

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스

프레임 있어 프레임 없음

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

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

javax.imageio.spi
클래스 ImageInputStreamSpi

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

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

public abstract class ImageInputStreamSpi
extends IIOServiceProvider
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()