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 를 가지는 것은 보증됩니다.

예외:

UnsupportedOperationException - 구현이 이 메소드를 오버라이드(override) 하지 않는 경우

도입된 버젼:

1.5

parse

public Document  parse(InputStream  is)
               throws SAXException ,
                      IOException 

지정된 InputStream 의 내용을 XML 문서로서 구문 분석 해, 새로운 DOM Document 객체를 돌려줍니다. InputStream 가 null 의 경우는 IllegalArgumentException 가 throw 됩니다.

파라미터:

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

반환값:

InputStream 의 구문 분석 결과의 Document

예외:

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

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

IllegalArgumentException - is 가 null 의 경우

관련 항목:

DocumentHandler

parse

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

지정된 InputStream 의 내용을 XML 문서로서 구문 분석 해, 새로운 DOM Document 객체를 돌려줍니다. InputStream 가 null 의 경우는 IllegalArgumentException 가 throw 됩니다.

파라미터:

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

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

반환값:

새로운 DOM Document 객체

예외:

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

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

IllegalArgumentException - is 가 null 의 경우

관련 항목:

DocumentHandler

parse

public Document  parse(String  uri)
               throws SAXException ,
                      IOException 

지정된 URI 의 내용을 XML 문서로서 해석해, 새로운 DOM Document 객체를 돌려줍니다. URI 가 null 의 경우는 IllegalArgumentException 가 throw 됩니다.

파라미터:

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

반환값:

새로운 DOM Document 객체

예외:

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

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

IllegalArgumentException - uri 가 null 의 경우

관련 항목:

DocumentHandler

parse

public Document  parse(File  f)
               throws SAXException ,
                      IOException 

지정된 파일의 내용을 XML 문서로서 구문 분석 해, 새로운 DOM Document 객체를 돌려줍니다. File 가 null 의 경우는 IllegalArgumentException 가 throw 됩니다.

파라미터:

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

반환값:

새로운 DOM Document 객체

예외:

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

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

IllegalArgumentException - f 가 null 의 경우

관련 항목:

DocumentHandler

parse

public abstract Document  parse(InputSource  is)
                        throws SAXException ,
                               IOException 

지정된 입력 소스의 내용을 XML 문서로서 구문 분석 해, 새로운 DOM Document 객체를 돌려줍니다. InputSource 가 null 의 경우는 IllegalArgumentException 가 throw 됩니다.

파라미터:

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

반환값:

새로운 DOM Document 객체

예외:

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

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

IllegalArgumentException - is 가 null 의 경우

관련 항목:

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 - 구현이 이 메소드를 오버라이드(override) 하지 않는 경우

도입된 버젼:

1.5

isXIncludeAware

public boolean isXIncludeAware()

이 퍼서의 XInclude 처리 모드를 가져옵니다.

반환값:

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

예외:

UnsupportedOperationException - 구현이 이 메소드를 오버라이드(override) 하지 않는 경우

도입된 버젼:

1.5

관련 항목:

DocumentBuilderFactory.setXIncludeAware(boolean)