javax.xml.parsers
클래스 DocumentBuilder

java.lang.Object 
  javax.xml.parsers.DocumentBuilder

public abstract class DocumentBuilder
extends Object 

XML 문서로부터 DOM Document 인스턴스를 얻는 API를 정의합니다. 이 클래스를 사용하면, 어플리케이션 프로그래머는 XML Document를 취득할 수 있습니다.

이 클래스의 인스턴스는 DocumentBuilderFactory.newDocumentBuilder() 메서드에 의해 취득할 수 있습니다. 이 클래스의 인스턴스를 취득하면, 다양한 입력 소스로부터 XML 문서를 구문 분석 할 수 있습니다. 이러한 입력 소스에는 InputStream, File, URL 및 SAX InputSource가 있습니다.

이 클래스는 SAX API 몇개의 클래스를 재이용합니다. 이 경우 기본이 되는 DOM 구현의 구현측이 SAX 파서를 사용해 XML 문서를 Document에 구문 분석 할 필요는 없습니다. 구현이 이러한 기존의 API를 사용해 어플리케이션과 통신할 필요가 있을 뿐입니다.

생성자 개요

protected

DocumentBuilder () protected 생성자 입니다.

메서드 개요

abstract DOMImplementation	getDOMImplementation () DOMImplementation 객체의 인스턴스를 취득합니다.
Schema	getSchema () XML 프로세서에 의해 사용되는 Schema 에의 참조를 취득합니다.
abstract boolean	isNamespaceAware () 이 파서가 이름 공간을 인식하도록 설정되어 있는지를 나타냅니다.
abstract boolean	isValidating () 이 파서가 XML 문서를 검증하도록 설정되어 있는지를 나타냅니다.
boolean	isXIncludeAware () 이 파서의 XInclude 처리 모드를 취득합니다.
abstract Document	newDocument () DOM 트리의 구축에 사용하는 DOM Document 객체의 새로운 인스턴스를 취득합니다.
Document	parse (File f) 지정된 파일의 내용을 XML 문서로서 구문 분석 해, 새로운 DOM Document 객체를 리턴합니다.
abstract Document	parse (InputSource is) 지정된 입력 소스의 내용을 XML 문서로서 구문 분석 해, 새로운 DOM Document 객체를 리턴합니다.
Document	parse (InputStream is) 지정된 InputStream 내용을 XML 문서로서 구문 분석 해, 새로운 DOM Document 객체를 리턴합니다.
Document	parse (InputStream is, String systemId) 지정된 InputStream 내용을 XML 문서로서 구문 분석 해, 새로운 DOM Document 객체를 리턴합니다.
Document	parse (String uri) 지정된 URI 내용을 XML 문서로서 해석해, 새로운 DOM Document 객체를 리턴합니다.
void	reset () 이 DocumentBuilder을 원의 설정에 리셋 합니다.
abstract void	setEntityResolver (EntityResolver er) 구문 분석 하는 XML 문서에 존재하는 엔티티를 해결하는데 사용되는 EntityResolver를 지정합니다.
abstract void	setErrorHandler (ErrorHandler eh) 파서에 의해 사용되는 ErrorHandler를 지정합니다.

클래스 java.lang. Object 로부터 상속된 메서드

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

생성자 상세

DocumentBuilder

protected DocumentBuilder()

protected 생성자 입니다.

메서드의 상세

reset

public void reset()

이 DocumentBuilder를 원의 설정에 리셋 합니다.

DocumentBuilder는 DocumentBuilderFactory.newDocumentBuilder() 로 작성된 시점 상태에 리셋 됩니다. reset()는 기존의 DocumentBuilder 재사용을 허가하도록 설정되어 있기 때문에 새로운 DocumentBuilder의 작성에 관련된 자원을 절약할 수 있습니다.

DocumentBuilder를 리셋 했을 경우, 같은 EntityResolver 또는 ErrorHandler Object를 가지는 것은 보증되지 않습니다. 예를 들어, Object.equals(Object obj) 등입니다. 기능적으로 같은 EntityResolver 나 ErrorHandler를 가지는 것은 보증됩니다.

도입된 버전 :

1.5

parse

public Document  parse(InputStream  is)
               throws SAXException,

                      IOException 

지정된 InputStream 내용을 XML 문서로서 구문 분석 해, 새로운 DOM Document 객체를 리턴합니다. InputStream가 null인 경우는 IllegalArgumentException가 발생 됩니다.

파라미터:

is - 구문 분석 되는 컨텐츠를 포함한 InputStream

반환값:

InputStream 구문 분석 결과의 Document

예외:

IOException - 입출력 에러가 발생했을 경우

SAXException - 구문 분석 에러가 발생했을 경우

관련 항목:

DocumentHandler

parse

public Document  parse(InputStream  is,
                      String  systemId)
               throws SAXException,

                      IOException 

지정된 InputStream 내용을 XML 문서로서 구문 분석 해, 새로운 DOM Document 객체를 리턴합니다. InputStream가 null인 경우는 IllegalArgumentException가 발생 됩니다.

파라미터:

is - 구문 분석 되는 컨텐츠를 포함한 InputStream

systemId - 상대 URI를 해결하기 위한 베이스를 제공

반환값:

새로운 DOM Document 객체

예외:

IOException - 입출력 에러가 발생했을 경우

SAXException - 구문 분석 에러가 발생했을 경우

관련 항목:

DocumentHandler

parse

public Document  parse(String  uri)
               throws SAXException,

                      IOException 

지정된 URI 내용을 XML 문서로서 해석해, 새로운 DOM Document 객체를 리턴합니다. URI가 null인 경우는 IllegalArgumentException가 발생 됩니다.

파라미터:

uri - 구문 분석 되는 컨텐츠의 장소

반환값:

새로운 DOM Document 객체

예외:

IOException - 입출력 에러가 발생했을 경우

SAXException - 구문 분석 에러가 발생했을 경우

관련 항목:

DocumentHandler

parse

public Document  parse(File  f)
               throws SAXException,

                      IOException 

지정된 파일의 내용을 XML 문서로서 구문 분석 해, 새로운 DOM Document 객체를 리턴합니다. File가 null인 경우는 IllegalArgumentException가 발생 됩니다.

파라미터:

f - 구문 분석 대상의 XML를 포함한 파일

반환값:

새로운 DOM Document 객체

예외:

IOException - 입출력 에러가 발생했을 경우

SAXException - 구문 분석 에러가 발생했을 경우

관련 항목:

DocumentHandler

parse

public abstract Document  parse(InputSource  is)
                        throws SAXException,

                               IOException 

지정된 입력 소스의 내용을 XML 문서로서 구문 분석 해, 새로운 DOM Document 객체를 리턴합니다. InputSource가 null인 경우는 IllegalArgumentException 이 발생 됩니다.

파라미터:

is - 구문 분석 되는 컨텐츠를 포함한 InputSource

반환값:

새로운 DOM Document 객체

예외:

IOException - 입출력 에러가 발생했을 경우

SAXException - 구문 분석 에러가 발생했을 경우

관련 항목:

DocumentHandler

isNamespaceAware

public abstract boolean isNamespaceAware()

이 파서가 이름 공간을 인식하도록 설정되어 있는지를 나타냅니다.

반환값:

이 파서가 이름 공간을 인식하도록 설정되어 있는 경우는 true, 그렇지 않은 경우는 false

isValidating

public abstract boolean isValidating()

이 파서가 XML 문서를 검증하도록 설정되어 있는지를 나타냅니다.

반환값:

이 파서가 XML 문서를 검증하도록 설정되어 있는 경우는 true, 그렇지 않은 경우는 false

setEntityResolver

public abstract void setEntityResolver(EntityResolver  er)

구문 분석 하는 XML 문서에 존재하는 엔티티를 해결하는데 사용되는 EntityResolver를 지정합니다. 이것을 null로 설정하면, 디폴트의 구현이 사용됩니다.

파라미터:

er - 구문 분석 하는 XML 문서에 존재하는 엔티티를 해결하는데 사용되는 EntityResolver

setErrorHandler

public abstract void setErrorHandler(ErrorHandler  eh)

파서에 의해 사용되는 ErrorHandler를 지정합니다. 이것을 null로 설정하면, 디폴트의 구현이 사용됩니다.

파라미터:

eh - 파서에 의해 사용되는 ErrorHandler

newDocument

public abstract Document  newDocument()

DOM 트리의 구축에 사용하는 DOM Document 객체의 새로운 인스턴스를 취득합니다.

반환값:

DOM Document 객체의 새로운 인스턴스

getDOMImplementation

public abstract DOMImplementation  getDOMImplementation()

DOMImplementation 객체의 인스턴스를 취득합니다.

반환값:

DOMImplementation 새로운 인스턴스

getSchema

public Schema  getSchema()

XML 프로세서에 의해 사용되는 Schema 에의 참조를 취득합니다.

schema를 사용하고 있지 않는 경우는 null이 리턴됩니다 .

반환값:

사용되고 있는 Schema 또는 아무것도 사용하고 있지 않는 경우는 null

예외:

UnsupportedOperationException - 하위 호환성이기 때문에 JAXP 이전의 버전을 사용하고 있는 경우에 이 예외가 발생되는

도입된 버전 :

1.5

isXIncludeAware

public boolean isXIncludeAware()

이 파서의 XInclude 처리 모드를 취득합니다.

반환값:

이 파서가 팩토리로부터 작성되었을 경우에 DocumentBuilderFactory.isXIncludeAware() 반환값

예외:

UnsupportedOperationException - 하위 호환성이기 때문에 JAXP 이전의 버전을 사용하고 있는 경우에 이 예외가 발생되는

도입된 버전 :

1.5

관련 항목:

DocumentBuilderFactory.setXIncludeAware(boolean)