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 를 사용해 어플리케이션과 통신할 필요가 있을 뿐입니다.

DocumentBuilder 의 구현은 2 kr 이상의 thread로 동시에 사용되었을 경우, 사양대로 동작하는 것은 프로텍션 「되지 않습니다」. thread 당 DocumentBuilder 의 1 개의 인스턴스로 하는 것을 추천합니다. 복수의 thread로부터 DocumentBuilder 가 사용될지 어떨지의 확인은 어플리케이션으로 실시합니다.

도입된 버젼:

JAXP 1.0

생성자의 개요

protected

DocumentBuilder ()

메소드의 개요

abstract DOMImplementation	getDOMImplementation () DOMImplementation 오브젝트의 인스턴스를 취득합니다.
abstract boolean	isNamespaceAware () 이 파서가 이름 공간을 인식하도록(듯이) 설정되어 있는지 어떤지를 나타냅니다.
abstract boolean	isValidating () 이 파서가 XML 문서를 검증하도록(듯이) 설정되어 있는지 어떤지를 나타냅니다.
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 오브젝트를 돌려줍니다.
abstract void	setEntityResolver (EntityResolver er) 구문 분석 하는 XML 문서에 존재하는 엔티티를 해결하는데 사용되는 EntityResolver 를 지정합니다.
abstract void	setErrorHandler (ErrorHandler eh) 구문 분석 하는 XML 문서에 존재하는 에러의 리포트에 사용되는 ErrorHandler 를 지정합니다.

클래스 java.lang. Object 에서 상속받은 메소드

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

생성자의 상세

DocumentBuilder

protected DocumentBuilder()

메소드의 상세

parse

public Document  parse(InputStream  is)
               throws SAXException ,
                      IOException 

지정된 InputStream 의 컨텐츠를 XML 문서로서 구문 분석 해, 새로운 DOM Document 오브젝트를 돌려줍니다.

파라미터:

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

예외:

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

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

IllegalArgumentException - InputStream 이 null 의 경우

관련 항목:

DocumentHandler

parse

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

지정된 InputStream 의 컨텐츠를 XML 문서로서 구문 분석 해, 새로운 DOM Document 오브젝트를 돌려줍니다.

파라미터:

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

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

반환값:

새로운 DOM Document 오브젝트

예외:

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

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

IllegalArgumentException - InputStream 이 null 의 경우

관련 항목:

DocumentHandler

parse

public Document  parse(String  uri)
               throws SAXException ,
                      IOException 

지정된 URI 의 컨텐츠를 XML 문서로서 구문 분석 해, 새로운 DOM Document 오브젝트를 돌려줍니다.

파라미터:

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

반환값:

새로운 DOM Document 오브젝트

예외:

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

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

IllegalArgumentException - URI 가 null 의 경우

관련 항목:

DocumentHandler

parse

public Document  parse(File  f)
               throws SAXException ,
                      IOException 

지정된 파일의 컨텐츠를 XML 문서로서 구문 분석 해, 새로운 DOM Document 오브젝트를 돌려줍니다.

파라미터:

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

반환값:

새로운 DOM Document 오브젝트

예외:

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

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

IllegalArgumentException - 파일이 null 의 경우

관련 항목:

DocumentHandler

parse

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

지정된 입력 소스의 컨텐츠를 XML 문서로서 구문 분석 해, 새로운 DOM Document 오브젝트를 돌려줍니다.

파라미터:

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

반환값:

새로운 DOM Document 오브젝트

예외:

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

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

IllegalArgumentException - InputSource 이 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)

구문 분석 하는 XML 문서에 존재하는 에러의 리포트에 사용되는 ErrorHandler 를 지정합니다. 이것을 null 로 설정하면(자), 디폴트의 구현이 사용됩니다.

파라미터:

eh - 구문 분석 하는 XML 문서에 존재하는 에러의 리포트에 사용되는 ErrorHandler

newDocument

public abstract Document  newDocument()

DOM 트리의 구축에 사용하는 DOM Document 오브젝트의 새로운 인스턴스를 취득합니다. DOM Document 오브젝트를 작성하는 다른 방법으로서getDOMImplementation 메소드를 사용해 DOM Level2 DOMImplementation 오브젝트를 취득해, 다음에 그 오브젝트의 DOM Level2 메소드를 사용해 작성하는 방법이 있습니다.

반환값:

DOM Document 오브젝트의 새로운 인스턴스

getDOMImplementation

public abstract DOMImplementation  getDOMImplementation()

DOMImplementation 오브젝트의 인스턴스를 취득합니다.

반환값:

DOMImplementation 의 새로운 인스턴스