패키지 javax.xml.transform.dom

이 패키지는 DOM 고유의 변환 API 를 구현합니다.

참조:
설명

인터페이스의 개요

DOMLocator

소스 DOM 내의 노드의 위치를 나타내, 주로 에러 리포트를 목적으로 하고 있습니다.

클래스의 개요

DOMResult	DOM (Document Object Model) 트리의 형식에서, 변환 결과 트리의 홀더로서 동작합니다.
DOMSource	DOM (Document Object Model) 트리의 형식에서, 변환 Source 트리의 홀더로서 동작합니다.

패키지 javax.xml.transform.dom 의 설명

이 패키지는 DOM 고유의 변환 API 를 구현합니다.

DOMSource 클래스에 의해, 이 API 의 구현의 클라이언트는 입력 트리의 소스로서 DOM Node 를 지정할 수가 있습니다. 「XSLT 데이터 모델」이나 그 외의 데이터 모델과의 불일치에 관해서 Transformer 가 DOM 트리를 처리하는 방법의 모델에 대해서는 이 문서의 범위외입니다. Node 로부터 파생한 노드는 모두 유효한 입력입니다.

DOMResult 클래스에 의해,Node 를 결과의 DOM 노드의 추가처로서 지정할 수 있습니다. 출력 노드가 지정되어 있지 않은 경우, Transformer 는 DocumentBuilder.newDocument() 를 사용해 출력 Document 노드를 작성합니다. 노드가 지정되고 있는 경우는 Document ,Element , 또는 DocumentFragment 의 어떤 것인가 나오지 않으면 안됩니다. 다른 노드 타입의 지정은 구현에 의존해, 이 API 에서는 정의되지 않습니다. 결과가 Document 인 경우, 변환의 출력에는 문서 요소로서 설정하는 단일의 요소 루트가 필요합니다.

DOMLocator 노드는 TransformerException 오브젝트에 건네줄 수가 있어TransformerException.getLocator() 메소드의 결과의 캐스트를 시도하는 것으로 취득할 수 있습니다. 구현에는 SourceLocator 대신에 DOMLocator 를 사용할 책임은 없습니다 (다만, 행 번호 등은 DOM 에 있어서는 그다지 의미가 없습니다). 따라서, getLocator 의 결과는 항상 instanceof 로 판정할 필요가 있습니다.