DocumentBuilderFactory (Java 2 플랫폼 SE v1. 4.0)

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2
Platform
Std. Ed. v1. 4.0

전의 클래스 다음의 클래스

프레임 있어 프레임 없음

개요: 상자 | 필드 | constructor | 메소드

상세: 필드 | constructor | 메소드

javax.xml.parsers
클래스 DocumentBuilderFactory

java.lang.Object 
  |
  +--javax.xml.parsers.DocumentBuilderFactory

public abstract class DocumentBuilderFactory
extends Object

XML 문서로부터 DOM 오브젝트 트리를 작성하는 파서를 어플리케이션을 취득할 수 있게 하는 팩토리 API 를 정의합니다. DocumentBuilderFactory 클래스의 구현은 thread 세이프인 것은 프로텍션 「되지 않습니다」. 복수의 thread로부터 DocumentBuilderFactory 가 사용될지 어떨지의 확인은 유저 어플리케이션으로 실시합니다. 다른 방법으로서 어플리케이션은 thread 당 DocumentBuilderFactory 의 1 개의 인스턴스를 가질 수가 있습니다. 팩토리의 인스턴스가 복수의 thread로 동시에 사용되지 않으면, 어플리케이션은 팩토리의 같은 인스턴스를 사용해 DocumentBuilder 의 1 개 이상의 인스턴스를 취득할 수가 있습니다.

도입된 버젼:: JAXP 1.0

생성자의 개요

protected DocumentBuilderFactory ()


메소드의 개요

abstract Object getAttribute (String name)
          유저가 기본이 되는 구현의 특정의 속성을 꺼낼 수가 있게 합니다.

boolean isCoalescing ()
          CDATA 노드를 Text 노드로 변환해, 그것을 인접 (존재하는 경우) Text 노드에 추가하는 파서를 작성하도록(듯이) 팩토리가 설정되어 있는지 어떤지를 나타냅니다.

boolean isExpandEntityReferences ()
          엔티티 참조 노드를 전개하는 파서를 작성하도록(듯이) 팩토리가 설정되어 있는지 어떤지를 나타냅니다.

boolean isIgnoringComments ()
          코멘트를 무시하는 파서를 작성하도록(듯이) 팩토리가 설정되어 있는지 어떤지를 나타냅니다.

boolean isIgnoringElementContentWhitespace ()
          요소 컨텐츠내의 무시할 수 있는 공백을 무시하는 파서를 작성하도록(듯이) 팩토리가 설정되어 있는지 어떤지를 나타냅니다.

boolean isNamespaceAware ()
          팩토리가 이름 공간을 인식하는 파서를 작성하도록(듯이) 설정되어 있는지 어떤지를 나타냅니다.

boolean isValidating ()
          구문 분석시에 XML 컨텐츠를 검증하는 파서를 작성하도록(듯이) 팩토리가 설정되어 있는지 어떤지를 나타냅니다.

abstract DocumentBuilder newDocumentBuilder ()
          현재 설정되어 있는 파라미터를 사용해 DocumentBuilder 의 새로운 인스턴스를 작성합니다.

static DocumentBuilderFactory newInstance ()
          DocumentBuilderFactory 의 새로운 인스턴스를 취득합니다.

abstract void setAttribute (String name, Object value)
          유저가 기본이 되는 구현에 특정의 속성을 설정할 수 있게 합니다.

void setCoalescing (boolean coalescing)
          이 팩토리로 작성된 파서가 CDATA 노드를 Text 노드로 변환해, 그것을 인접 (존재하는 경우) Text 노드에 추가하도록(듯이) 지정합니다.

void setExpandEntityReferences (boolean expandEntityRef)
          이 팩토리로 작성된 파서가 엔티티 참조 노드를 전개하도록(듯이) 지정합니다.

void setIgnoringComments (boolean ignoreComments)
          이 팩토리로 작성된 파서가 코멘트를 무시하도록(듯이) 지정합니다.

void setIgnoringElementContentWhitespace (boolean whitespace)
          이 팩토리로 작성된 파서가, XML 문서의 구문 분석시에 요소 컨텐츠의 공백 (대략적으로 「무시할 수 있는 공백」이라고 불리는 일이 있다)을 배제하도록(듯이) 지정합니다 (XML Rec 2.10 을 참조).

void setNamespaceAware (boolean awareness)
          이 팩토리로 작성된 파서가 XML 이름 공간을 서포트하도록(듯이) 지정합니다.

void setValidating (boolean validating)
          이 팩토리로 작성된 파서가 구문 분석시에 문서의 타당성을 검증하도록(듯이) 지정합니다.

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

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

생성자의 상세

DocumentBuilderFactory

protected DocumentBuilderFactory()

메소드의 상세

newInstance

public static DocumentBuilderFactory  newInstance()
                                          throws FactoryConfigurationError

DocumentBuilderFactory 의 새로운 인스턴스를 취득합니다. 이 static 메소드는 새로운 팩토리 인스턴스를 작성합니다. 이 메소드는 다음의 순서의 look 업 순서로, 로드하는 DocumentBuilderFactory 구현 클래스를 판정합니다.

javax.xml.parsers.DocumentBuilderFactory 시스템 프로퍼티를 사용한다
JRE 디렉토리내의 프로퍼티 파일 lib/jaxp.properties 를 사용한다. 이 구성 파일은 표준의 java.util.Properties 형식이며, 상기와 같이 정의된 시스템 프로퍼티인 키를 가지는 구현 클래스의 완전 지정의 이름을 포함한다
가능하면, JAR 사양으로 상세하게 설명되고 있는 서비스 API 를 사용해, 클래스명을 판정한다. 서비스 API 는 실행시에 사용할 수 있는 jar 내의 META-INF/services/javax.xml.parsers.DocumentBuilderFactory 파일로부터 클래스명을 검색한다
플랫폼의 디폴트의 DocumentBuilderFactory 인스턴스

어플리케이션이 DocumentBuilderFactory 에의 참조를 취득하면(자), 팩토리를 사용해 파서의 인스턴스를 설정 및 취득할 수가 있습니다.

예외:: FactoryConfigurationError - 구현을 사용할 수 없는가 인스턴스화할 수 없는 경우

newDocumentBuilder

public abstract DocumentBuilder  newDocumentBuilder()
                                            throws ParserConfigurationException

현재 설정되어 있는 파라미터를 사용해 DocumentBuilder 의 새로운 인스턴스를 작성합니다.

반환값:: DocumentBuilder 의 새로운 인스턴스
예외:: ParserConfigurationException - 요구된 구성을 채우는 DocumentBuilder 를 생성할 수 없는 경우

setNamespaceAware

public void setNamespaceAware(boolean awareness)

이 팩토리로 작성된 파서가 XML 이름 공간을 서포트하도록(듯이) 지정합니다. 디폴트에서는 이 값은 false 로 설정됩니다.

파라미터:: awareness - 작성된 파서가 XML 이름 공간을 서포트하는 경우는 true, 그렇지 않은 경우는 false

setValidating

public void setValidating(boolean validating)

이 팩토리로 작성된 파서가 구문 분석시에 문서의 타당성을 검증하도록(듯이) 지정합니다. 디폴트에서는 이 값은 false 로 설정됩니다.

파라미터:: validating - 작성된 파서가 구문 분석시에 문서의 타당성을 검증하는 경우는 true, 그렇지 않은 경우는 false

setIgnoringElementContentWhitespace

public void setIgnoringElementContentWhitespace(boolean whitespace)

이 팩토리로 작성된 파서가, XML 문서의 구문 분석시에 요소 컨텐츠의 공백 (대략적으로 「무시할 수 있는 공백」이라고 불리는 일이 있다)을 배제하도록(듯이) 지정합니다 (XML Rec 2.10 을 참조). 요소만의 컨텐츠 모델 (XML Rec 3.2. 1 을 참조)를 가지는 요소 컨텐츠내에 직접 포함되는 공백만이 배제됩니다. 컨텐츠 모델에 의존하고 있기 위해서(때문에), 이 설정에서는 파서가 검증 모드인 것이 필요합니다. 디폴트에서는 이 값은 false 로 설정됩니다.

파라미터:: whitespace - 작성된 파서가 XML 문서의 구문 분석시에 요소 컨텐츠내의 공백을 배제할 필요가 있는 경우는 true, 그렇지 않은 경우는 false

setExpandEntityReferences

public void setExpandEntityReferences(boolean expandEntityRef)

이 팩토리로 작성된 파서가 엔티티 참조 노드를 전개하도록(듯이) 지정합니다. 디폴트에서는 이 값은 true 로 설정됩니다.

파라미터:: expandEntityRef - 작성된 파서가 엔티티 참조 노드를 전개하는 경우는 true, 그렇지 않은 경우는 false

setIgnoringComments

public void setIgnoringComments(boolean ignoreComments)

이 팩토리로 작성된 파서가 코멘트를 무시하도록(듯이) 지정합니다. 디폴트에서는 이 값은 false 로 설정됩니다.

setCoalescing

public void setCoalescing(boolean coalescing)

이 팩토리로 작성된 파서가 CDATA 노드를 Text 노드로 변환해, 그것을 인접 (존재하는 경우) Text 노드에 추가하도록(듯이) 지정합니다. 디폴트에서는 이 값은 false 로 설정됩니다.

파라미터:: coalescing - 작성된 파서가 CDATA 노드를 Text 노드로 변환해, 그것을 인접 (존재하는 경우) Text 노드에 추가하는 경우는 true, 그렇지 않은 경우는 false

isNamespaceAware

public boolean isNamespaceAware()

팩토리가 이름 공간을 인식하는 파서를 작성하도록(듯이) 설정되어 있는지 어떤지를 나타냅니다.

반환값:: 팩토리가 이름 공간을 인식하는 파서를 작성하도록(듯이) 설정되어 있는 경우는 true, 그렇지 않은 경우는 false

isValidating

public boolean isValidating()

구문 분석시에 XML 컨텐츠를 검증하는 파서를 작성하도록(듯이) 팩토리가 설정되어 있는지 어떤지를 나타냅니다.

반환값:: 구문 분석시에 XML 컨텐츠를 검증하는 파서를 작성하도록(듯이) 팩토리가 설정되어 있는 경우는 true, 그렇지 않은 경우는 false

isIgnoringElementContentWhitespace

public boolean isIgnoringElementContentWhitespace()

요소 컨텐츠내의 무시할 수 있는 공백을 무시하는 파서를 작성하도록(듯이) 팩토리가 설정되어 있는지 어떤지를 나타냅니다.

반환값:: 요소 컨텐츠내의 무시할 수 있는 공백을 무시하는 파서를 작성하도록(듯이) 팩토리가 설정되어 있는 경우는 true, 그렇지 않은 경우는 false

isExpandEntityReferences

public boolean isExpandEntityReferences()

엔티티 참조 노드를 전개하는 파서를 작성하도록(듯이) 팩토리가 설정되어 있는지 어떤지를 나타냅니다.

반환값:: 엔티티 참조 노드를 전개하는 파서를 작성하도록(듯이) 팩토리가 설정되어 있는 경우는 true, 그렇지 않은 경우는 false

isIgnoringComments

public boolean isIgnoringComments()

코멘트를 무시하는 파서를 작성하도록(듯이) 팩토리가 설정되어 있는지 어떤지를 나타냅니다.

반환값:: 코멘트를 무시하는 파서를 작성하도록(듯이) 팩토리가 설정되어 있는 경우는 true, 그렇지 않은 경우는 false

isCoalescing

public boolean isCoalescing()

CDATA 노드를 Text 노드로 변환해, 그것을 인접 (존재하는 경우) Text 노드에 추가하는 파서를 작성하도록(듯이) 팩토리가 설정되어 있는지 어떤지를 나타냅니다.

반환값:: CDATA 노드를 Text 노드로 변환해, 그것을 인접 (존재하는 경우) Text 노드에 추가하는 파서를 작성하도록(듯이) 팩토리가 설정되어 있는 경우는 true, 그렇지 않은 경우는 false

setAttribute

public abstract void setAttribute(String  name,
                                  Object  value)
                           throws IllegalArgumentException

유저가 기본이 되는 구현에 특정의 속성을 설정할 수 있게 합니다.

파라미터:: name - 속성의 이름; value - 속성의 값
예외:: IllegalArgumentException - 기본이 되는 구현이 속성을 인식하지 않는 경우에 슬로우 된다

getAttribute

public abstract Object  getAttribute(String  name)
                             throws IllegalArgumentException

유저가 기본이 되는 구현의 특정의 속성을 꺼낼 수가 있게 합니다.

파라미터:: name - 속성의 이름
반환값:: 속성의 값
예외:: IllegalArgumentException - 기본이 되는 구현이 속성을 인식하지 않는 경우에 슬로우 된다

개요