IIOMetadata (Java 2 Platform SE 5.0)

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 다음 클래스

프레임으로 프레임 없이

개요: NESTED | 필드 | constructor | 메서드

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

javax.imageio.metadata
클래스 IIOMetadata

java.lang.Object 
  javax.imageio.metadata.IIOMetadata

public abstract class IIOMetadata
extends Object
extends Object

이미지와 스트림에 관련한 메타데이타 (이미지 이외의 데이터)를 나타내는 객체에 의해 확장되는 추상 클래스입니다. 플러그 인은 불투명한, 플러그 인 고유의 객체를 사용하는 메타데이타를 나타냅니다. 다만, 이러한 객체는 XML DOM 인터페이스를 지원하는 IIOMetadataNode 객체의 트리로서 내부 정보에 액세스 하는 기능과 텍스트 이외의 데이터를 포함해, 정당한 데이터에 관한 정보를 꺼내기 위한 추가의 인터페이스를 제공합니다. 이러한 트리의 형식은 플러그 인에 의존합니다만, 플러그 인은 아래와 같은 플러그 인에 존하지 않는 형식을 지원 할 수 있습니다. 1개의 플러그 인으로 복수의 메타데이타 형식을 지원 할 수가 있어 그 이름은 getMetadataFormatNames를 호출하는 것으로 판정할 수 있습니다. 그 플러그 인은 메타데이타를 손실없이 encode 하도록 설계된 「네이티브」형식으로 불리는 1개의 특수한 형식도 지원 합니다. 보통, 이 형식은 특정의 파일 형식과 함께 동작하도록 특별히 설계되어 메타데이타의 손실이 없는 같은 형식에서 이미지를 로드 및 포함할 수 있습니다 만, 이미지 형식이 다른 ImageReader와 ImageWriter 사이에 메타데이타를 전송 하기에는 불편한 경우가 있습니다. 2개의 네이티브 형식의 사이에 이미지의 파일 형식의 경우와 같은 정도로 손실없이 변환하려면, ImageTranscoder 객체를 사용할 필요가 있습니다.

관련 항목:: ImageReader.getImageMetadata(int), ImageReader.getStreamMetadata(), ImageReader.readAll(int, javax.imageio.ImageReadParam), ImageWriter.getDefaultStreamMetadata(javax.imageio.ImageWriteParam), ImageWriter.getDefaultImageMetadata(javax.imageio.ImageTypeSpecifier, javax.imageio.ImageWriteParam), ImageWriter.write(javax.imageio.metadata.IIOMetadata, javax.imageio.IIOImage, javax.imageio.ImageWriteParam), ImageWriter.convertImageMetadata(javax.imageio.metadata.IIOMetadata, javax.imageio.ImageTypeSpecifier, javax.imageio.ImageWriteParam), ImageWriter.convertStreamMetadata(javax.imageio.metadata.IIOMetadata, javax.imageio.ImageWriteParam), IIOImage, ImageTranscoder

필드 개요
`protected IIOMetadataController`	`controller` `activateController` 메서드를 호출할 때, 이 `IIOMetadata` 객체의 설정을 제공하는데 사용하는 `IIOMetadataController` 입니다.
`protected IIOMetadataController`	`defaultController` 이 `IIOMetadata` 객체의 콘트롤러로서 사용하도록 추천 되고 있는 `IIOMetadataController` 입니다.
`protected String []`	`extraMetadataFormatClassNames` `null`에 초기화되어 생성자를 개입시켜 설정된, `IIOMetadataFormat`를 구현해, 이 플러그 인으로 지원 되는 표준 및 네이티브 형식 이외의 메타데이타 형식을 나타내는 클래스의 이름의 배열입니다.
`protected String []`	`extraMetadataFormatNames` `null`에 초기화되어 생성자를 개입시켜 설정된, 이 플러그 인으로 지원 되는 표준 및 네이티브 형식 이외의 형식의 이름의 배열입니다.
`protected String`	`nativeMetadataFormatClassName` `null`에 초기화되어 생성자를 개입시켜 설정된, `IIOMetadataFormat`를 구현해, 네이티브메타데이타 형식을 나타내는 클래스의 이름입니다.
`protected String`	`nativeMetadataFormatName` `null`에 초기화되어 생성자를 개입시켜 설정된, 이 객체의 네이티브메타데이타 형식의 이름입니다.
`protected boolean`	`standardFormatSupported` 구상 서브 클래스가 생성자를 개입시켜 설정된 표준의 메타데이타 형식을 지원 할지 어떨지를 나타내는 boolean 치입니다.

생성자 개요
`protected`	`IIOMetadata ()` 비어있는 `IIOMetadata` 객체를 구축합니다.
`protected`	`IIOMetadata (boolean standardMetadataFormatSupported, String nativeMetadataFormatName, String nativeMetadataFormatClassName, String [] extraMetadataFormatNames, String [] extraMetadataFormatClassNames)` 지정된 형식명과 형식의 클래스명 및 표준의 형식을 지원 할지 어떨지를 나타내는 boolean 치를 사용해, `IIOMetadata` 객체를 구축합니다.

메서드 개요
`boolean`	`activateController ()` 이 `IIOMetadata` 객체에 대해서 인스톨 되고 있는 `IIOMetadataController`를 활성화 해, 결과의 값을 리턴합니다.
`abstract Node`	`getAsTree (String formatName)` 지정된 메타데이타 형식에서 정의되는 규칙에 따라 이 객체내에 포함되는 메타데이타의 트리의 루트를 나타내는 XML DOM `Node` 객체를 리턴합니다.
`IIOMetadataController`	`getController ()` 현재 인스톨 되고 있는 `IIOMetadataController`를 리턴합니다.
`IIOMetadataController`	`getDefaultController ()` 디폴트가 존재하는 경우는 현재 인스톨 되고 있는 콘트롤러에 관계없이, 디폴트의 `IIOMetadataController`를 리턴합니다.
`String []`	`getExtraMetadataFormatNames ()` 이 플러그 인의 `getAsTree`, `setFromTree` 및 `mergeTree` 메서드로 인식되는 네이티브와 표준의 형식 이외의, 추가의 메타데이타 형식의 이름이 포함된 `String` 배열을 리턴합니다.
`IIOMetadataFormat`	`getMetadataFormat (String formatName)` 지정된 메타데이타 형식을 기술하는 `IIOMetadataFormat` 객체를 리턴합니다.
`String []`	`getMetadataFormatNames ()` 이 플러그 인의 `getAsTree`, `setFromTree` 및 `mergeTree` 메서드로 인식되는 네이티브와 표준의 형식을 포함한, 모든 메타데이타 형식의 이름이 포함된 `String` 배열을 리턴합니다.
`String`	`getNativeMetadataFormatName ()` 이 플러그 인의 「네이티브」메타데이타 형식의 이름을 리턴합니다.
`protected IIOMetadataNode`	`getStandardChromaNode ()` 표준의 `javax_imageio_1. 0` 메타데이타 형식의 채도 정보를 나타내는 `IIOMetadataNode`를 리턴합니다.
`protected IIOMetadataNode`	`getStandardCompressionNode ()` 표준의 `javax_imageio_1. 0` 메타데이타 형식의 압축 정보를 나타내는 `IIOMetadataNode`를 리턴합니다.
`protected IIOMetadataNode`	`getStandardDataNode ()` 표준의 `javax_imageio_1. 0` 메타데이타 형식의 데이터 형식 정보를 나타내는 `IIOMetadataNode`를 리턴합니다.
`protected IIOMetadataNode`	`getStandardDimensionNode ()` 표준의 `javax_imageio_1. 0` 메타데이타 형식의 크기 정보를 나타내는 `IIOMetadataNode`를 리턴합니다.
`protected IIOMetadataNode`	`getStandardDocumentNode ()` 표준의 `javax_imageio_1. 0` 메타데이타 형식의 문서 정보를 나타내는 `IIOMetadataNode`를 리턴합니다.
`protected IIOMetadataNode`	`getStandardTextNode ()` 표준의 `javax_imageio_1. 0` 메타데이타 형식의 텍스트 정보를 나타내는 `IIOMetadataNode`를 리턴합니다.
`protected IIOMetadataNode`	`getStandardTileNode ()` 표준의 `javax_imageio_1. 0` 메타데이타 형식의 타일링 정보를 나타내는 `IIOMetadataNode`를 리턴합니다.
`protected IIOMetadataNode`	`getStandardTransparencyNode ()` 표준의 `javax_imageio_1. 0` 메타데이타 형식의 투과성 정보를 나타내는 `IIOMetadataNode`를 리턴합니다.
`protected IIOMetadataNode`	`getStandardTree ()` 표준의 `javax_imageio_1. 0` 메타데이타 형식의 규칙에 따라 이 객체내에 포함되는 메타데이타를 나타내는 `IIOMetadataNode` 트리를 돌려주는 유틸리티 메서드입니다.
`boolean`	`hasController ()` 이 `IIOMetadata` 객체에 대해서 콘트롤러가 인스톨 되고 있는 경우는 `true`를 리턴합니다.
`abstract boolean`	`isReadOnly ()` 이 객체가 `mergeTree`, `setFromTree` 및 `reset` 메서드를 지원 하지 않는 경우는 `true`를 리턴합니다.
`boolean`	`isStandardMetadataFormatSupported ()` 표준의 메타데이타 형식이 `getMetadataFormat`, `getAsTree`, `setFromTree` 및 `mergeTree`로 지원 되는 경우는 `true`를 리턴합니다.
`abstract void`	`mergeTree (String formatName, Node root)` 지정된 메타데이타 형식에서 구문이 정의되는 XML DOM `Node` 트리로부터, 이 `IIOMetadata` 객체의 내부 상태를 변경합니다.
`abstract void`	`reset ()` 이 객체에 포함 떠날 수 있어 모든 데이터를 기본값에 리셋 합니다.
`void`	`setController (IIOMetadataController controller)` `activateController` 메서드를 호출해, 모든 디폴트 콘트롤러를 오버라이드(override) 할 경우에 이 `IIOMetadata` 객체의 설정치를 지정하는데 사용하는 `IIOMetadataController`를 설정합니다.
`void`	`setFromTree (String formatName, Node root)` 지정된 메타데이타 형식에서 구문이 정의되는 XML DOM `Node` 트리로부터, 이 `IIOMetadata` 객체의 내부 상태를 설정합니다.

클래스 java.lang. Object 로부터 상속된 메서드
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

필드의 상세

standardFormatSupported

protected boolean standardFormatSupported

구상 서브 클래스가 생성자를 개입시켜 설정된 표준의 메타데이타 형식을 지원 할지 어떨지를 나타내는 boolean 치입니다.

nativeMetadataFormatName

protected String  nativeMetadataFormatName

null에 초기화되어 생성자를 개입시켜 설정된, 이 객체의 네이티브메타데이타 형식의 이름입니다.

nativeMetadataFormatClassName

protected String  nativeMetadataFormatClassName

null에 초기화되어 생성자를 개입시켜 설정된, IIOMetadataFormat를 구현해, 네이티브메타데이타 형식을 나타내는 클래스의 이름입니다.

extraMetadataFormatNames

protected String [] extraMetadataFormatNames

null에 초기화되어 생성자를 개입시켜 설정된, 이 플러그 인으로 지원 되는 표준 및 네이티브 형식 이외의 형식의 이름의 배열입니다.

extraMetadataFormatClassNames

protected String [] extraMetadataFormatClassNames

null에 초기화되어 생성자를 개입시켜 설정된, IIOMetadataFormat를 구현해, 이 플러그 인으로 지원 되는 표준 및 네이티브 형식 이외의 메타데이타 형식을 나타내는 클래스의 이름의 배열입니다.

defaultController

protected IIOMetadataController  defaultController

이 IIOMetadata 객체의 콘트롤러로서 사용하도록 추천 되고 있는 IIOMetadataController 입니다. getDefaultController를 사용해 꺼낼 수가 있습니다. 디폴트의 콘트롤러를 인스톨 하려면, setController(getDefaultController())를 호출합니다. 이 인스턴스 변수는 파라미터를 설정하기 위해서 독자적인 디폴트 콘트롤러 (일반적으로 GUI)를 제공하는 서브 클래스에서 설정할 필요가 있습니다.

관련 항목:: IIOMetadataController, getDefaultController()

controller

protected IIOMetadataController  controller

activateController 메서드를 호출할 때, 이 IIOMetadata 객체의 설정을 제공하는데 사용하는 IIOMetadataController 입니다. 이 값은, null인 경우에서도, 디폴트의 콘트롤러를 모두 오버라이드(override) 합니다.

관련 항목:: IIOMetadataController, setController(IIOMetadataController), hasController(), activateController()

생성자 상세

IIOMetadata

protected IIOMetadata()

비어있는 IIOMetadata 객체를 구축합니다. 서브 클래스는 오버라이드(override) 되지 않는 디폴트의 메서드 구현이 그 규약을 채우도록 하는 모든 보호된 인스턴스 변수의 값을 지정합니다. 예를 들어, extraMetadataFormatNames 길이는 0 이어 되지 않습니다.

IIOMetadata

protected IIOMetadata(boolean standardMetadataFormatSupported,
                      String  nativeMetadataFormatName,
                      String  nativeMetadataFormatClassName,
                      String [] extraMetadataFormatNames,
                      String [] extraMetadataFormatClassNames)

지정된 형식명과 형식의 클래스명 및 표준의 형식을 지원 할지 어떨지를 나타내는 boolean 치를 사용해, IIOMetadata 객체를 구축합니다.

이 생성자는 클래스명의 유효성은 판정하지 않습니다. 클래스명이 무효인 경우는 getMetadataFormat 그 후의 호출로 예외가 발생하는 경우가 있습니다.

파라미터:: standardMetadataFormatSupported - 이 객체가 표준의 메타데이타 형식을 사용해 DOM 트리를 돌려줄까 받을 수 있는인 경우는 true; nativeMetadataFormatName - 네이티브의 메타데이타 형식의 String 명. 네이티브의 형식이 없는 경우는 null; nativeMetadataFormatClassName - 네이티브메타데이타 형식의 클래스의 이름. 네이티브의 형식이 없는 경우는 null; extraMetadataFormatNames - 이 객체로 지원 되는 추가의 형식을 나타내는 String 배열. 존재하지 않는 경우는 null; extraMetadataFormatClassNames - 이 객체로 지원 되는 모든 추가 형식의 클래스명을 나타내는 String 배열. 존재하지 않는 경우는 null
예외:: IllegalArgumentException - extraMetadataFormatNames 길이가 0인 경우; IllegalArgumentException - extraMetadataFormatNames 및 extraMetadataFormatClassNames가 null에 서도 같은 길이도 아닌 경우

메서드의 상세

isStandardMetadataFormatSupported

public boolean isStandardMetadataFormatSupported()

표준의 메타데이타 형식이 getMetadataFormat, getAsTree, setFromTree 및 mergeTree로 지원 되는 경우는 true를 리턴합니다.

디폴트의 구현은 standardFormatSupported인스턴스 변수의 값을 리턴합니다.

반환값:: 표준의 메타데이타 형식이 지원 되고 있는 경우는 true
관련 항목:: getAsTree(java.lang.String), setFromTree(java.lang.String, org.w3c.dom.Node), mergeTree(java.lang.String, org.w3c.dom.Node), getMetadataFormat(java.lang.String)

isReadOnly

public abstract boolean isReadOnly()

이 객체가 mergeTree, setFromTree 및 reset 메서드를 지원 하지 않는 경우는 true를 리턴합니다.

반환값:: 이 IIOMetadata 객체를 변경할 수 없는 경우는 true

getNativeMetadataFormatName

public String  getNativeMetadataFormatName()

이 플러그 인의 「네이티브」메타데이타 형식의 이름을 리턴합니다. 보통, 이 형식을 사용하면, 이 플러그 인으로 처리되는 형식에서 포함되고 있는 메타데이타를 손실없이 encode 및 전송 할 수 있습니다. 그러한 형식이 지원 되어 있지 않은 경우는 null이 리턴됩니다 .

「네이티브」메타데이타 형식의 구조와 내용은 이 IIOMetadata 객체를 작성한 플러그 인으로 정의됩니다. 보통, 단순한 형식의 플러그 인은 루트에 더미 노드를 작성하고 나서, 개개의 태그, 체크, 또는 키워드와 값의 페어를 나타내는 일련의자식 노드를 작성합니다. 플러그 인은 네이티브 형식을 문서화할지 어떨지를 선택할 수 있습니다 .

디폴트의 구현은 nativeMetadataFormatName인스턴스 변수의 값을 리턴합니다.

반환값:: 네이티브 형식의 이름, 또는 null
관련 항목:: getExtraMetadataFormatNames(), getMetadataFormatNames()

getExtraMetadataFormatNames

public String [] getExtraMetadataFormatNames()

이 플러그 인의 getAsTree, setFromTree 및 mergeTree 메서드로 인식되는 네이티브와 표준의 형식 이외의, 추가의 메타데이타 형식의 이름이 포함된 String 배열을 리턴합니다. 그러한 추가의 형식이 없는 경우는 null이 리턴됩니다 .

디폴트의 구현은 extraMetadataFormatNames인스턴스 변수의 복제를 리턴합니다.

반환값:: 적어도 길이 1 String 배열, 또는 null
관련 항목:: getAsTree(java.lang.String), setFromTree(java.lang.String, org.w3c.dom.Node), mergeTree(java.lang.String, org.w3c.dom.Node), getNativeMetadataFormatName(), getMetadataFormatNames()

getMetadataFormatNames

public String [] getMetadataFormatNames()

이 플러그 인의 getAsTree, setFromTree 및 mergeTree 메서드로 인식되는 네이티브와 표준의 형식을 포함한, 모든 메타데이타 형식의 이름이 포함된 String 배열을 리턴합니다. 그러한 형식이 없는 경우는 null이 리턴됩니다 .

디폴트의 구현은 getNativeMetadataFormatName, isStandardMetadataFormatSupported 및 getExtraMetadataFormatNames를 호출해, 결합된 결과를 리턴합니다.

반환값:: String 배열
관련 항목:: getNativeMetadataFormatName(), isStandardMetadataFormatSupported(), getExtraMetadataFormatNames()

getMetadataFormat

public IIOMetadataFormat  getMetadataFormat(String  formatName)

지정된 메타데이타 형식을 기술하는 IIOMetadataFormat 객체를 리턴합니다. 기술을 사용할 수 없는 경우는 null을 리턴합니다. 지정하는 이름은, getMetadataFormatNames로 부터 리턴된 이름의 1개가 아니면 안됩니다 (즉, 네이티브의 형식명, 표준의 형식명, 또는 getExtraMetadataFormatNames로 부터 리턴된 이름의 1개).

디폴트의 구현에서는 글로벌 표준 메타데이타 형식명에 대해서 이름을 판정해, 지원 되고 있는 경우는 그 형식을 리턴합니다. 그렇지 않은 경우는 나중에 추가의 형식명이 계속되는 네이티브의 형식명에 대해서 판정합니다. 일값이 발견되었을 경우는 해당하는 nativeMetadataFormatClassName 또는 extraMetadataFormatClassNames로 부터 IIOMetadataFormat 클래스의 이름을 꺼내, getInstance 메서드를 사용해 그 클래스의 인스턴스를 구축합니다.

파라미터:: formatName - 목적의 메타데이타 형식
반환값:: IIOMetadataFormat 객체
예외:: IllegalArgumentException - formatName가 null인지, 플러그 인으로 인식된 이름이 아닌 경우; IllegalStateException - 형식명에 대응하는 클래스를 로드할 수 없는 경우

getAsTree

public abstract Node  getAsTree(String  formatName)

지정된 메타데이타 형식에서 정의되는 규칙에 따라 이 객체내에 포함되는 메타데이타의 트리의 루트를 나타내는 XML DOM Node 객체를 리턴합니다.

사용 가능한 메타데이타 형식의 이름은, getMetadataFormatNames 메서드를 사용해 조회할 수 있습니다 .

파라미터:: formatName - 목적의 메타데이타 형식
반환값:: 트리의 루트를 형성하는 XML DOM Node 객체
예외:: IllegalArgumentException - formatName가 null인지, getMetadataFormatNames로 부터 리턴된 이름이 아닌 경우
관련 항목:: getMetadataFormatNames(), setFromTree(java.lang.String, org.w3c.dom.Node), mergeTree(java.lang.String, org.w3c.dom.Node)

mergeTree

public abstract void mergeTree(String  formatName,
                               Node  root)
                        throws IIOInvalidTreeException

지정된 메타데이타 형식에서 구문이 정의되는 XML DOM Node 트리로부터, 이 IIOMetadata 객체의 내부 상태를 변경합니다. 이전 상태는 지정된 트리에 존재하는 노드에 적합하기 위해서 필요한 경우에만 변경됩니다. 트리의 구조 또는 내용이 무효인 경우는 IIOInvalidTreeException가 발생 됩니다.

트리 또는 서브 트리를 다른 트리와 머지 하는 방법의 시멘틱스는 완전하게 형식 고유해서, 플러그 인의 작성자는 그 형식에 가장 적절한 방법으로 이 메서드를 구현할 수 있습니다 . 기존의 모든 상태가 지정된 트리의 내용에 옮겨놓을 뿐등의 방법이 있습니다.

파라미터:: formatName - 목적의 메타데이타 형식; root - 트리의 루트를 형성하는 XML DOM Node 객체
예외:: IllegalStateException - 이 객체가 읽기 전용의 경우; IllegalArgumentException - formatName가 null인지, getMetadataFormatNames로 부터 리턴된 이름이 아닌 경우; IllegalArgumentException - root이 null인 경우; IIOInvalidTreeException - 지정된 형식의 규칙을 사용해 트리를 정상적으로 구문 분석 할 수 없는 경우
관련 항목:: getMetadataFormatNames(), getAsTree(java.lang.String), setFromTree(java.lang.String, org.w3c.dom.Node)

getStandardChromaNode

protected IIOMetadataNode  getStandardChromaNode()

표준의 javax_imageio_1. 0 메타데이타 형식의 채도 정보를 나타내는 IIOMetadataNode를 리턴합니다. 그러한 정보를 사용할 수 없는 경우는 null을 리턴합니다. 이 메서드는 유틸리티루틴 getStandardTree로 부터 호출하는 것을 상정하고 있습니다.

디폴트 구현은 null을 리턴합니다.