org.w3c.dom
인터페이스 DOMImplementation

public interface DOMImplementation

DOMImplementation 인터페이스는, 문서 객체 모델의 특정의 인스턴스에 의존하지 않는 조작을 실행하기 위한 메소드를 다수 제공합니다.

「Document Object Model (DOM) Level 3 Core Specification」를 참조해 주세요.

메소드의 개요

Document	createDocument (String namespaceURI, String qualifiedName, DocumentType doctype) 지정된 형태의 DOM Document 객체와 그 문서 요소를 작성합니다.
DocumentType	createDocumentType (String qualifiedName, String publicId, String systemId) 빈 상태(empty)의 DocumentType 노드를 작성합니다.
Object	getFeature (String feature, String version) 이 메소드는, 지정한 기능과 버젼을 가지는 특수한 형식의 API 를, 「DOM Features 」로 지정되었던 대로 구현하는 특수한 형식의 객체를 돌려줍니다.
boolean	hasFeature (String feature, String version) DOM 구현이 특정의 기능과 버젼을「DOM Features」로 지정되었던 대로 구현하고 있을지 어떨지를 테스트합니다.

메소드의 상세

hasFeature

boolean hasFeature(String  feature,
                   String  version)

DOM 구현이 특정의 기능과 버젼을「DOM Features」로 지정되었던 대로 구현하고 있을지 어떨지를 테스트합니다.

파라미터:

feature - 테스트하는 기능의 이름

version - 테스트하는 기능의 버젼 번호

반환값:

지정된 버젼의 기능이 구현되고 있는 경우는 true, 그렇지 않은 경우는 false

createDocumentType

DocumentType  createDocumentType(String  qualifiedName,
                                String  publicId,
                                String  systemId)
                                throws DOMException 

빈 상태(empty)의 DocumentType 노드를 작성합니다. 엔티티 선언 및 엔티티 지정 (표기법지정)은 사용할 수 없습니다. 엔티티 참조의 확장 및 디폴트 속성의 추가는 행해지지 않습니다.

파라미터:

qualifiedName - 작성하는 문서형의 수식명

publicId - 외부 부분집합의 공개 식별자

systemId - 외부 부분집합의 시스템 식별자

반환값:

Node.ownerDocument 가 null 로 설정되어 있는 새롭다 DocumentType 노드

예외:

DOMException - INVALID_CHARACTER_ERR:지정된 수식명이 「XML 1.0」에 정해져 있는 XML 명이 아닌 경우
NAMESPACE_ERR:qualifiedName 가 부정한 수식명이다 경우
NOT_SUPPORTED_ERR:구현이 「XML」기능을 지원하고 있지 않고, 문서를 통해서 공개된 언어가 XML 이름 공간 ( 「HTML 4.01 」등)(을)를 지원하고 있지 않는 경우

도입된 버젼:

DOM Level 2

createDocument

Document  createDocument(String  namespaceURI,
                        String  qualifiedName,
                        DocumentType  doctype)
                        throws DOMException 

지정된 형태의 DOM Document 객체와 그 문서 요소를 작성합니다. 주어진(given) DocumentType 를 기본으로 문서가 작성되어 구현에서는, 「HTML」의「DOM Level 2 HTML」등의 「코어」보다 한층 더 기능을 지원하는 특수한 형식의 Document 객체를 인스턴스화할 수 있는 것에 주의해 주세요. 한편, 문서가 작성된 뒤에 DocumentType 를 설정하면(자), 이러한 조작은 할 수 없게 됩니다. 대신에,createHTMLDocument「DOM Level 2 HTML」등의 특화된 Document 작성 메소드를 사용해, 특수한 형태의 Document 객체를 취득할 수 있습니다.

파라미터:

namespaceURI - 작성하는 문서 요소의 이름 공간 URI, 혹은,null

qualifiedName - 작성하는 문서 요소의 수식명, 혹은 null

doctype - 작성되는 문서의 형태 또는 null. doctype 가 null 가 아닌 경우, 작성되는 문서에는 그 Node.ownerDocument 속성이 설정된다

반환값:

문서 요소를 포함한 새로운 Document 객체. NamespaceURI,qualifiedName 및 doctype 가 null 인 경우, 반환되는 Document 는 빈 상태(empty)에서 문서 요소는 포함되지 않는다

예외:

DOMException - INVALID_CHARACTER_ERR:지정된 수식명이 「XML 1.0」에 정해져 있는 XML 명이 아닌 경우
NAMESPACE_ERR:qualifiedName 가 부정한 수식명이다 경우. qualifiedName 이 접두사를 가져, namespaceURI 가 null 인 경우. 또는, qualifiedName 가 null 이며, namespaceURI 가 null 가 아닌 경우. 혹은 qualifiedName 가 접두사 「xml」를 가져, namespaceURI 가 「http://www.w3.org/XML/1998/namespace」의 XML 이름 공간과는 다른 경우. 혹은, XML 에 의해 이름 공간이 정의되고 있었기 때문에, DOM 구현이 「XML」기능을 지원하지 않고, null 이외의 이름 공간 URI 가 지정되었을 경우
WRONG_DOCUMENT_ERR:doctype 가 다른 문서로 벌써 사용되고 있었을 경우, 혹은 다른 구현으로부터 작성되었다 경우
NOT_SUPPORTED_ERR:구현이 「XML」기능을 지원하고 있지 않고, 문서를 통해서 공개된 언어가 XML 이름 공간 (「HTML 4.01」등)(을)를 지원하고 있지 않는 경우

도입된 버젼:

DOM Level 2

getFeature

Object  getFeature(String  feature,
                  String  version)

이 메소드는, 지정한 기능과 버젼을 가지는 특수한 형식의 API 를, 「DOM Features 」로 지정되었던 대로 구현하는 특수한 형식의 객체를 돌려줍니다. 특수한 형식의 객체는, 바인딩 고유의 캐스팅 메소드를 사용해 취득할 수도 있습니다만, 반드시 설명되고 있도록(듯이) 네 오지 않습니다. 이 메소드를 사용하면(자), 구현에서는 DOMImplementation 인터페이스를 지원하지 않는 특수한 형식의 객체를 이용할 수 있습니다.

파라미터:

feature - 요구된 기능의 이름. 기능명의 전에 추가되는 플러스 기호 「+」은, 이 메소드의 문맥에서는 의미가 있지 않기 때문에 무시되는

version - 테스트하는 기능의 버젼 번호

반환값:

지정된 기능과 버젼의 특수한 형식의 API 를 구현하는 객체 (존재하는 경우). 지정된 기능에 관련지을 수 있었다 인터페이스를 구현하는 객체가 존재하지 않는 경우는 null. 이 메소드에 의해 반환되는 DOMObject 가 DOMImplementation 인터페이스를 구현하는 경우, 주요 코어 DOMImplementation 에 위양 해, 주요 코어 DOMImplementation 와 정합하지 않는 결과 (hasFeature,getFeature 등)(을)를 돌려주지 않게 한다 필요가 있는

도입된 버젼:

DOM Level 3