JavaTM Platform
Standard Ed. 6

javax.imageio.spi
클래스 ImageReaderWriterSpi

java.lang.Object 
  상위를 확장 javax.imageio.spi.IIOServiceProvider 
      상위를 확장 javax.imageio.spi.ImageReaderWriterSpi
모든 구현된 인터페이스:
RegisterableService
직계의 기존의 서브 클래스:
ImageReaderSpi , ImageWriterSpi


public abstract class ImageReaderWriterSpi
extends IIOServiceProvider

ImageReaderSpiImageWriterSpi 에 공통의 인스턴스 변수 및 메소드를 포함한 슈퍼 클래스입니다.

관련 항목:
IIORegistry , ImageReaderSpi , ImageWriterSpi

필드의 개요
protected  String [] extraImageMetadataFormatClassNames
          이 플러그 인이 지원하는 모든 추가 이메이지메타데이타 형식의 클래스명을 포함한 String 배열로, 처음은 null 입니다.
protected  String [] extraImageMetadataFormatNames
          이 플러그 인이 지원하는 모든 추가 이메이지메타데이타 형식의 이름을 포함한 String 배열로, 처음은 null 입니다.
protected  String [] extraStreamMetadataFormatClassNames
          이 플러그 인이 지원하는 모든 추가 스트림메타데이타 형식의 클래스명을 포함한 String 배열로, 처음은 null 입니다.
protected  String [] extraStreamMetadataFormatNames
          이 플러그 인이 지원하는 모든 추가 스트림메타데이타 형식의 이름을 포함한 String 배열로, 처음은 null 입니다.
protected  String [] MIMETypes
          getMIMETypes 로부터 반환되는 캐릭터 라인의 배열로, 처음은 null 입니다.
protected  String [] names
          getFormatNames 로부터 반환되는 캐릭터 라인의 배열로, 처음은 null 입니다.
protected  String nativeImageMetadataFormatClassName
          이 플러그 인으로 지원되는 네이티브의 스트림메타데이타 형식의 클래스명을 포함한 String 로, 처음은 null 입니다.
protected  String nativeImageMetadataFormatName
          이 플러그 인으로 지원되는 네이티브의 스트림메타데이타 형식의 이름을 포함한 String 로, 처음은 null 입니다.
protected  String nativeStreamMetadataFormatClassName
          이 플러그 인으로 지원되는 네이티브의 스트림메타데이타 형식의 클래스명을 포함한 String 로, 처음은 null 입니다.
protected  String nativeStreamMetadataFormatName
          이 플러그 인으로 지원되는 네이티브의 스트림메타데이타 형식의 이름을 포함한 String 로, 처음은 null 입니다.
protected  String pluginClassName
          관련하는 플러그 인 클래스의 이름을 포함한 String 로, 처음은 null 입니다.
protected  String [] suffixes
          getFileSuffixes 로부터 반환되는 캐릭터 라인의 배열로, 처음은 null 입니다.
protected  boolean supportsStandardImageMetadataFormat
          이 플러그 인이 이메이지메타데이타에 표준의 메타데이타 형식을 지원할지 어떨지를 나타내는 boolean 로, 처음은 false 입니다.
protected  boolean supportsStandardStreamMetadataFormat
          이 플러그 인이 스트림메타데이타에 표준의 메타데이타 형식을 지원할지 어떨지를 나타내는 boolean 로, 처음은 false 입니다.
 
클래스 javax.imageio.spi. IIOServiceProvider 로부터 상속된 필드
vendorName , version
 
생성자 의 개요
ImageReaderWriterSpi ()
          공백의 ImageReaderWriterSpi 를 구축합니다.
ImageReaderWriterSpi (String  vendorName, String  version, String [] names, String [] suffixes, String [] MIMETypes, String  pluginClassName, boolean supportsStandardStreamMetadataFormat, String  nativeStreamMetadataFormatName, String  nativeStreamMetadataFormatClassName, String [] extraStreamMetadataFormatNames, String [] extraStreamMetadataFormatClassNames, boolean supportsStandardImageMetadataFormat, String  nativeImageMetadataFormatName, String  nativeImageMetadataFormatClassName, String [] extraImageMetadataFormatNames, String [] extraImageMetadataFormatClassNames)
          지정된 값세트를 사용해 ImageReaderWriterSpi 를 구축합니다.
 
메소드의 개요
 String [] getExtraImageMetadataFormatNames ()
          이 플러그 인이 작성 또는 사용하는 이메이지메타데이타객체로,getAsTreesetFromTree 메소드가 인식하는, 네이티브 및 표준 형식 이외의 추가 문서 형식의 이름을 포함한 String 배열을 돌려줍니다.
 String [] getExtraStreamMetadataFormatNames ()
          이 플러그 인이 작성 또는 사용하는 스트림메타데이타객체로,getAsTreesetFromTree 메소드가 인식하는 네이티브 및 표준 형식 이외의, 추가 문서 형식의 이름을 포함한 String 배열을 돌려줍니다.
 String [] getFileSuffixes ()
          이 서비스 프로바이더에 관련하는 ImageReader 또는 ImageWriter 구현으로 일반적으로 사용 가능한 형식에 관련지을 수 있었던 파일접미사(suffix)의 리스트를 포함한 String 배열을 돌려줍니다.
 String [] getFormatNames ()
          이 서비스 프로바이더에 관련하는 ImageReader 또는 ImageWriter 구현으로 일반적으로 사용할 수 있는 형식의 판독 가능한 이름을 포함한 String 배열을 돌려줍니다.
 IIOMetadataFormat getImageMetadataFormat (String  formatName)
          지정된 이메이지메타데이타 형식을 설명하는 IIOMetadataFormat 객체, 또는 설명이 없는 경우는 null 를 돌려줍니다.
 String [] getMIMETypes ()
          이 서비스 프로바이더에 관련하는 ImageReader 또는 ImageWriter 구현으로 일반적으로 사용 가능한 형식에 관련지을 수 있었던 MIME 타입의 리스트를 포함한 String 배열을 돌려줍니다.
 String getNativeImageMetadataFormatName ()
          이 플러그 인의 「네이티브」이메이지메타데이타 형식의 이름을 돌려줍니다.
 String getNativeStreamMetadataFormatName ()
          이 플러그 인의 「네이티브」스트림메타데이타 형식의 이름을 돌려줍니다.
 String getPluginClassName ()
          이 서비스 프로바이더에 관련하는 ImageReader 또는 ImageWriter 플러그 인의 완전 지정 클래스명을 돌려줍니다.
 IIOMetadataFormat getStreamMetadataFormat (String  formatName)
          지정된 스트림메타데이타 형식을 설명하는 IIOMetadataFormat 객체, 또는 설명이 없는 경우는 null 를 돌려줍니다.
 boolean isStandardImageMetadataFormatSupported ()
          이 플러그 인이 작성 또는 사용하는 이메이지메타데이타객체로,getAsTreesetFromTree 메소드가 인식하는 문서 형식에 표준의 메타데이타 형식이 포함되는 경우는,true 를 돌려줍니다.
 boolean isStandardStreamMetadataFormatSupported ()
          이 플러그 인이 작성 또는 사용하는 스트림메타데이타객체로 getAsTreesetFromTree 메소드가 인식하는 문서 형식에 표준의 메타데이타 형식이 포함되는 경우는,true 를 돌려줍니다.
 
클래스 javax.imageio.spi. IIOServiceProvider 로부터 상속된 메소드
getDescription , getVendorName , getVersion , onDeregistration , onRegistration
 
클래스 java.lang. Object 로부터 상속된 메소드
clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait
 

필드의 상세

names

protected String [] names
getFormatNames 로부터 반환되는 캐릭터 라인의 배열로, 처음은 null 입니다. 생성자 으로 이것을 null 이외의 값으로 설정할 필요가 있습니다.


suffixes

protected String [] suffixes
getFileSuffixes 로부터 반환되는 캐릭터 라인의 배열로, 처음은 null 입니다.


MIMETypes

protected String [] MIMETypes
getMIMETypes 로부터 반환되는 캐릭터 라인의 배열로, 처음은 null 입니다.


pluginClassName

protected String  pluginClassName
관련하는 플러그 인 클래스의 이름을 포함한 String 로, 처음은 null 입니다.


supportsStandardStreamMetadataFormat

protected boolean supportsStandardStreamMetadataFormat
이 플러그 인이 스트림메타데이타에 표준의 메타데이타 형식을 지원할지 어떨지를 나타내는 boolean 로, 처음은 false 입니다.


nativeStreamMetadataFormatName

protected String  nativeStreamMetadataFormatName
이 플러그 인으로 지원되는 네이티브의 스트림메타데이타 형식의 이름을 포함한 String 로, 처음은 null 입니다.


nativeStreamMetadataFormatClassName

protected String  nativeStreamMetadataFormatClassName
이 플러그 인으로 지원되는 네이티브의 스트림메타데이타 형식의 클래스명을 포함한 String 로, 처음은 null 입니다.


extraStreamMetadataFormatNames

protected String [] extraStreamMetadataFormatNames
이 플러그 인이 지원하는 모든 추가 스트림메타데이타 형식의 이름을 포함한 String 배열로, 처음은 null 입니다.


extraStreamMetadataFormatClassNames

protected String [] extraStreamMetadataFormatClassNames
이 플러그 인이 지원하는 모든 추가 스트림메타데이타 형식의 클래스명을 포함한 String 배열로, 처음은 null 입니다.


supportsStandardImageMetadataFormat

protected boolean supportsStandardImageMetadataFormat
이 플러그 인이 이메이지메타데이타에 표준의 메타데이타 형식을 지원할지 어떨지를 나타내는 boolean 로, 처음은 false 입니다.


nativeImageMetadataFormatName

protected String  nativeImageMetadataFormatName
이 플러그 인으로 지원되는 네이티브의 스트림메타데이타 형식의 이름을 포함한 String 로, 처음은 null 입니다.


nativeImageMetadataFormatClassName

protected String  nativeImageMetadataFormatClassName
이 플러그 인으로 지원되는 네이티브의 스트림메타데이타 형식의 클래스명을 포함한 String 로, 처음은 null 입니다.


extraImageMetadataFormatNames

protected String [] extraImageMetadataFormatNames
이 플러그 인이 지원하는 모든 추가 이메이지메타데이타 형식의 이름을 포함한 String 배열로, 처음은 null 입니다.


extraImageMetadataFormatClassNames

protected String [] extraImageMetadataFormatClassNames
이 플러그 인이 지원하는 모든 추가 이메이지메타데이타 형식의 클래스명을 포함한 String 배열로, 처음은 null 입니다.

생성자 의 상세

ImageReaderWriterSpi

public ImageReaderWriterSpi(String  vendorName,
                            String  version,
                            String [] names,
                            String [] suffixes,
                            String [] MIMETypes,
                            String  pluginClassName,
                            boolean supportsStandardStreamMetadataFormat,
                            String  nativeStreamMetadataFormatName,
                            String  nativeStreamMetadataFormatClassName,
                            String [] extraStreamMetadataFormatNames,
                            String [] extraStreamMetadataFormatClassNames,
                            boolean supportsStandardImageMetadataFormat,
                            String  nativeImageMetadataFormatName,
                            String  nativeImageMetadataFormatClassName,
                            String [] extraImageMetadataFormatNames,
                            String [] extraImageMetadataFormatClassNames)
지정된 값세트를 사용해 ImageReaderWriterSpi 를 구축합니다.

파라미터:
vendorName - 벤더명 (null 이외의 String)
version - 버젼 식별자 (null 이외의 String)
names - 형식명을 나타내는 null 이외의 String 배열. 1 개(살) 이상의 엔트리가 존재할 필요가 있는
suffixes - 공통의 파일접미사(suffix)을 나타낸다 String 배열. 접미사(suffix)이 정의되어 있지 않은 경우는, null 를 지정한다. 길이 0 의 배열은 null 에 정규화되는
MIMETypes - 형식의 MIME 타입을 나타낸다 String 배열. MIME 타입이 정의되어 있지 않은 경우는, null 를 지정한다. 길이 0 의 배열은 null 에 정규화되는
pluginClassName - 관련한다 ImageReader 또는 ImageWriter 클래스의 완전 지정명 (null 이외의 String)
supportsStandardStreamMetadataFormat - 스트림메타데이타객체가 표준 메타데이타 형식에서 기술된 트리를 사용 가능한가 어떤가를 나타내는 boolean
nativeStreamMetadataFormatName - getNativeStreamMetadataFormatName 로부터 반환되는 String, 또는null
nativeStreamMetadataFormatClassName - getNativeStreamMetadataFormat 로부터 반환되는 메타데이타 형식 객체의 인스턴스화로 사용하는 String, 또는 null
extraStreamMetadataFormatNames - getExtraStreamMetadataFormatNames 로부터 반환되는 String 배열, 또는 null. 길이 0 의 배열은 null 에 정규화되는
extraStreamMetadataFormatClassNames - getStreamMetadataFormat 로부터 반환되는 메타데이타 형식 객체의 인스턴스화로 사용하는 String, 또는 null. 길이 0 의 배열은 null 에 정규화되는
supportsStandardImageMetadataFormat - 이메이지메타데이타객체가, 표준의 메타데이타 형식에서 기술된 트리를 사용할 수 있을지 어떨지를 나타내는 boolean
nativeImageMetadataFormatName - getNativeImageMetadataFormatName 로부터 반환되는 String, 또는 null
nativeImageMetadataFormatClassName - getNativeImageMetadataFormat 로부터 반환되는 메타데이타 형식 객체의 인스턴스화로 사용하는 String, 또는 null
extraImageMetadataFormatNames - getExtraImageMetadataFormatNames 로부터 반환된다 String 배열. 길이 0 의 배열은 null 에 정규화되는
extraImageMetadataFormatClassNames - getImageMetadataFormat 로부터 반환되는 메타데이타 형식 객체의 인스턴스화로 사용하는 String, 또는 null. 길이 0 의 배열은 null 에 정규화된다
예외:
IllegalArgumentException - vendorNamenull 의 경우
IllegalArgumentException - versionnull 의 경우
IllegalArgumentException - namesnull 또는 길이 0 의 경우
IllegalArgumentException - pluginClassNamenull 의 경우

ImageReaderWriterSpi

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

메소드의 상세

getFormatNames

public String [] getFormatNames()
이 서비스 프로바이더에 관련하는 ImageReader 또는 ImageWriter 구현으로 일반적으로 사용할 수 있는 형식의 판독 가능한 이름을 포함한 String 배열을 돌려줍니다. 예를 들어, 1 개의 ImageReader 로 PBM 파일과 PNM 파일의 양쪽 모두를 처리할 수 있는 경우가 있습니다.

반환값:
이 리더 또는 라이터에 관련하는 비공식의 형식명을 포함한, 길이 1 이상의 String 배열 (null 이외)

getFileSuffixes

public String [] getFileSuffixes()
이 서비스 프로바이더에 관련하는 ImageReader 또는 ImageWriter 구현으로 일반적으로 사용 가능한 형식에 관련지을 수 있었던 파일접미사(suffix)의 리스트를 포함한 String 배열을 돌려줍니다. 예를 들어, 1 개의 ImageReader 로 . pbm 나 . pnm, 또는 . jpg 나 . jpeg 의 접미사(suffix)을 가지는 파일을 처리할 수가 있는 경우가 있습니다. 기존의 파일접미사(suffix)이 존재하지 않는 경우는,null 를 돌려줍니다.

특정의 접미사(suffix)이 돌려주어져도, 그 접미사(suffix)을 가지는 파일의 처리는 보증되지 않습니다. 이 서비스 프로바이더를 사용해, 이런 종류의 파일의 encode 또는 디코드를 시도하는 가치가 있는 것을 나타내고 있는에 지나지 않습니다.

반환값:
이 리더 또는 라이터에 관련하는 공통의 파일접미사(suffix)을 포함한, 길이 1 이상의 String 배열, 또는 null

getMIMETypes

public String [] getMIMETypes()
이 서비스 프로바이더에 관련하는 ImageReader 또는 ImageWriter 구현으로 일반적으로 사용 가능한 형식에 관련지을 수 있었던 MIME 타입의 리스트를 포함한 String 배열을 돌려줍니다.

특정의 형식을 기술하는데 필요한 MIME 타입은 1 개 뿐인 것이 이상적입니다. 그러나, 몇개의 이유로부터, 각 서비스 프로바이더에 복수의 타입을 관련지을 필요가 있습니다. 제일에, 많은 공통 이미지 파일 형식에는 표준의 MIME 타입이 없기 때문에,image/x-pbmimage/x-portable-bitmap 등의 공통에 사용되는 비공식의 이름 리스트가 필요합니다. 일부의 파일 형식에는 정식의 MIME 타입이 있습니다만, 정식의 image/png 는 아니고,image/x-png 와 같은 이전의 비공식인 지정을 이용해 참조되는 것이 있습니다. 마지막으로, 1 개의 서비스 프로바이더가, MIME 의 관점으로부터 복수의 별개의 형식 (image/x-xbitmap 이나 image/x-xpixmap 등)을 해석할 수 있는 경우가 있습니다.

특정의 MIME 타입이 돌려주어져도, 그 타입의 파일의 처리가 보증되는 것은 아닙니다. 이 서비스 프로바이더를 사용해, 이런 종류의 파일의 encode 또는 디코드를 시도하는 가치가 있는 것을 나타내고 있는에 지나지 않습니다.

반환값:
이 리더 또는 라이터에 관련하는 MIME 타입을 포함한, 길이 1 이상의 String 배열, 또는 null

getPluginClassName

public String  getPluginClassName()
이 서비스 프로바이더에 관련하는 ImageReader 또는 ImageWriter 플러그 인의 완전 지정 클래스명을 돌려줍니다.

반환값:
클래스명 (null 이외의 String)

isStandardStreamMetadataFormatSupported

public boolean isStandardStreamMetadataFormatSupported()
이 플러그 인이 작성 또는 사용하는 스트림메타데이타객체로 getAsTreesetFromTree 메소드가 인식하는 문서 형식에 표준의 메타데이타 형식이 포함되는 경우는,true 를 돌려줍니다.

반환값:
스트림메타데이타로 표준의 형식이 지원되는 경우는 true

getNativeStreamMetadataFormatName

public String  getNativeStreamMetadataFormatName()
이 플러그 인의 「네이티브」스트림메타데이타 형식의 이름을 돌려줍니다. 일반적으로, 이 형식을 사용하면(자), 이 플러그 인이 처리하는 형식에서 포함되고 있는 스트림메타데이타를 열화 하지 않고 , encode 및 전송 할 수 있습니다. 이런 종류의 형식을 지원하지 않는 경우는,null 를 돌려줍니다.

디폴트의 구현에서는, 일반적으로, 생성자 으로 설정되는 nativeStreamMetadataFormatName 인스턴스 변수를 돌려줍니다.

반환값:
네이티브의 스트림메타데이타 형식의 이름, 또는 null

getExtraStreamMetadataFormatNames

public String [] getExtraStreamMetadataFormatNames()
이 플러그 인이 작성 또는 사용하는 스트림메타데이타객체로,getAsTreesetFromTree 메소드가 인식하는 네이티브 및 표준 형식 이외의, 추가 문서 형식의 이름을 포함한 String 배열을 돌려줍니다.

플러그 인이 메타데이타를 처리하지 않는 경우는, null 를 돌려줍니다.

형식 세트는, 읽어들여 또는 기입이 행해지는 이미지에 의해 다른 경우가 있습니다. 이 메소드는, 어느 상황에서도, 플러그 인이 지원하는 추가 형식을 모두 가리킬 필요가 있습니다.

디폴트의 구현에서는, 일반적으로은 생성자 으로 설정되는 extraStreamMetadataFormatNames 인스턴스 변수의 복제를 돌려줍니다.

반환값:
String 의 배열, 또는 null
관련 항목:
IIOMetadata.getMetadataFormatNames() , getExtraImageMetadataFormatNames() , getNativeStreamMetadataFormatName()

isStandardImageMetadataFormatSupported

public boolean isStandardImageMetadataFormatSupported()
이 플러그 인이 작성 또는 사용하는 이메이지메타데이타객체로,getAsTreesetFromTree 메소드가 인식하는 문서 형식에 표준의 메타데이타 형식이 포함되는 경우는,true 를 돌려줍니다.

반환값:
이메이지메타데이타로 표준의 형식이 지원되는 경우는 true

getNativeImageMetadataFormatName

public String  getNativeImageMetadataFormatName()
이 플러그 인의 「네이티브」이메이지메타데이타 형식의 이름을 돌려줍니다. 일반적으로, 이 형식을 사용하면(자), 이 플러그 인이 처리하는 형식에서 포함되고 있는 이메이지메타데이타를 열화 하지 않고, 에 encode 및 전송 할 수 있습니다. 이런 종류의 형식을 지원하지 않는 경우는,null 를 돌려줍니다.

디폴트의 구현에서는, 일반적으로, 생성자 으로 설정되는 nativeImageMetadataFormatName 인스턴스 변수를 돌려줍니다.

반환값:
네이티브의 이메이지메타데이타 형식의 이름, 또는 null
관련 항목:
getExtraImageMetadataFormatNames()

getExtraImageMetadataFormatNames

public String [] getExtraImageMetadataFormatNames()
이 플러그 인이 작성 또는 사용하는 이메이지메타데이타객체로,getAsTreesetFromTree 메소드가 인식하는, 네이티브 및 표준 형식 이외의 추가 문서 형식의 이름을 포함한 String 배열을 돌려줍니다.

플러그 인이 이메이지메타데이타를 처리하지 않는 경우는, null 를 돌려줍니다.

형식 세트는, 읽어들여 또는 기입이 행해지는 이미지에 의해 다른 경우가 있습니다. 이 메소드는, 어느 상황에서도, 플러그 인이 지원하는 추가 형식을 모두 가리킬 필요가 있습니다.

디폴트의 구현에서는, 일반적으로은 생성자 으로 설정되는 extraImageMetadataFormatNames 인스턴스 변수의 복제를 돌려줍니다.

반환값:
String 의 배열, 또는 null
관련 항목:
IIOMetadata.getMetadataFormatNames() , getExtraStreamMetadataFormatNames() , getNativeImageMetadataFormatName()

getStreamMetadataFormat

public IIOMetadataFormat  getStreamMetadataFormat(String  formatName)
지정된 스트림메타데이타 형식을 설명하는 IIOMetadataFormat 객체, 또는 설명이 없는 경우는 null 를 돌려줍니다. 지정하는 이름은, 네이티브의 스트림메타데이타 형식명, 표준의 메타데이타 형식명, 또는 getExtraStreamMetadataFormatNames 로부터 반환된 이름의 언젠가가 아니면 안됩니다.

파라미터:
formatName - 목적의 스트림메타데이타 형식
반환값:
IIOMetadataFormat 객체
예외:
IllegalArgumentException - formatNamenull, 또는 지원되지 않는 이름의 경우

getImageMetadataFormat

public IIOMetadataFormat  getImageMetadataFormat(String  formatName)
지정된 이메이지메타데이타 형식을 설명하는 IIOMetadataFormat 객체, 또는 설명이 없는 경우는 null 를 돌려줍니다. 지정하는 이름은, 네이티브의 이메이지메타데이타 형식명, 표준의 메타데이타 형식명, 또는 getExtraImageMetadataFormatNames 로부터 반환된 이름의 언젠가가 아니면 안됩니다.

파라미터:
formatName - 목적의 이메이지메타데이타 형식
반환값:
IIOMetadataFormat 객체
예외:
IllegalArgumentException - formatNamenull, 또는 지원되지 않는 이름의 경우

JavaTM Platform
Standard Ed. 6

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.