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) 비어있는 DocumentType 노드를 작성합니다.
Object	getFeature (String feature, String version) 이 메서드는 지정된 기능과 버전의 특수한 형식의 API가 지정되었던 대로 구현하는 특수한 형식의 객체를 리턴합니다.
boolean	hasFeature (String feature, String version) DOM 구현이 특정의 기능과 버전이 지정되었던 대로 구현하고 있을지 어떨지를 테스트합니다.

메서드의 상세

hasFeature

boolean hasFeature(String  feature,
                   String  version)

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

파라미터:

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

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

반환값:

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

createDocumentType

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

비어있는 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 객체를 작성합니다.
소정의 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는 비어있는 문서 요소는 포함되지 않는다

예외:

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」기능을 지원 하고 있지 않고, Document를 통해서 공개된 언어가 XML 이름 공간 (「HTML 4.01」등)을 지원 하고 있지 않는 경우

도입된 버전 :

DOM Level 2

getFeature

Object  getFeature(String  feature,
                  String  version)

이 메서드는 지정된 기능과 버전의 특수한 형식의 API가 지정되었던 대로 구현하는 특수한 형식의 객체를 리턴합니다. 특수한 형식의 객체는 바인딩 고유의 캐스팅 메서드를 사용해 취득할 수도 있습니다만, 반드시 설명되고 있도록 네 오지 않습니다. 이 메서드를 사용하면, 구현에서는 DOMImplementation인터페이스를 지원 하지 않는 특수한 형식의 객체를 이용할 수 있습니다.

파라미터:

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

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

반환값:

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

도입된 버전 :

DOM Level 3