javax.xml.parsers
클래스 SAXParserFactory

java.lang.Object 
  javax.xml.parsers.SAXParserFactory

public abstract class SAXParserFactory
extends Object 

어플리케이션이 SAX 베이스의 파서를 구성 및 취득해 XML 문서를 구문 분석 할 수 있도록 하는 팩토리 API를 정의합니다.

생성자 개요

protected

SAXParserFactory () newInstance()를 강제적으로 사용하는 protected 생성자 입니다.

메서드 개요

abstract boolean	getFeature (String name) org.xml.sax.XMLReader 기본이 되는 구현으로 요구된 특정의 프로퍼티를 리턴합니다.
Schema	getSchema () setSchema(Schema schema) 메서드에 의해 지정된 Schema 객체를 취득합니다.
boolean	isNamespaceAware () 팩토리가 이름 공간을 인식하는 파서를 작성하도록 설정되어 있는지를 나타냅니다.
boolean	isValidating () 구문 분석시에 XML 컨텐츠를 검증하는 파서를 작성하도록 팩토리가 설정되어 있는지를 나타냅니다.
boolean	isXIncludeAware () XInclude 처리 상태를 취득합니다.
static SAXParserFactory	newInstance () SAXParserFactory 새로운 인스턴스를 취득합니다.
abstract SAXParser	newSAXParser () 현재 설정되어 있는 팩토리 파라미터를 사용해 SAXParser 새로운 인스턴스를 작성합니다.
abstract void	setFeature (String name, boolean value) org.xml.sax.XMLReader 기본이 되는 구현에 특정의 기능을 설정합니다.
void	setNamespaceAware (boolean awareness) 이 팩토리로 작성된 파서가 XML 이름 공간을 지원 하도록 지정합니다.
void	setSchema (Schema schema) 이 팩토리로부터 작성된 파서에 의해 사용되는 Schema를 설정합니다.
void	setValidating (boolean validating) 이 팩토리로 작성된 파서가 구문 분석시에 문서의 타당성을 검증하도록 지정합니다.
void	setXIncludeAware (boolean state) XInclude 처리 상태를 설정합니다.

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

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

생성자 상세

SAXParserFactory

protected SAXParserFactory()

newInstance()를 강제적으로 사용하는 protected 생성자 입니다.

메서드의 상세

newInstance

public static SAXParserFactory  newInstance()

SAXParserFactory 새로운 인스턴스를 취득합니다. 이 static 메서드는 새로운 팩토리 인스턴스를 작성합니다. 이 메서드는 다음의 순서의 검색 순서로 로드하는 SAXParserFactory 구현 클래스를 결정합니다.

• javax.xml.parsers.SAXParserFactory 시스템 프로퍼티를 사용한다
• JRE 디렉토리내의 프로퍼티 파일 lib/jaxp.properties를 사용한다. 이 구성 파일은 표준의 java.util.Properties 형식이며, 상기와 같이 정의된 시스템 프로퍼티인 키를 가지는 구현 클래스의 완전 지정의 이름을 포함한다. jaxp.properties 파일은 JAXP 구현에 의해 1회 만 읽혀 그 값이 그 후의 사용을 위해 캐쉬된다. 최초의 read시에 파일이 존재하지 않으면 그 후에 그 존재가 체크될 것은 없다. 최초로 읽힌뒤 jaxp.properties 프로퍼티의 값을 변경할 수 없다.
• 가능하면, JAR 사양으로 상세하게 설명되고 있는 Services API를 사용해, 클래스명을 판정한다. Services API는 실행시에 사용할 수 있는 jar 내의 META-INF/services/javax.xml.parsers.SAXParserFactory 파일로부터 클래스명을 검색한다
• 플랫폼의 디폴트의 SAXParserFactory인스턴스

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

트러블 슈팅의 힌트

jaxp.debug 시스템 프로퍼티를 설정하면, 이 메서드는 실행중의 처리나 검색하고 있는 장소에 관한 대량의 디버그 메세지를 System.err에 출력합니다.

DocumentBuilder 로드에 문제가 있는 경우, 다음과 같이 합니다.

 java -Djaxp.debug=1 YourProgram ....
 

반환값:

SAXParserFactory 새로운 인스턴스

예외:

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

newSAXParser

public abstract SAXParser  newSAXParser()
                                throws ParserConfigurationException,

                                       SAXException 

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

반환값:

SAXParser 새로운 인스턴스

예외:

ParserConfigurationException - 요구된 구성을 채우는 파서를 생성할 수 없는 경우

SAXException - SAX 에러의 경우

setNamespaceAware

public void setNamespaceAware(boolean awareness)

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

파라미터:

awareness - 이 팩토리로 작성된 파서가 XML 이름 공간을 지원하는인 경우는 true, 그렇지 않은 경우는 false

setValidating

public void setValidating(boolean validating)

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

여기서 말하는 「검증」이란 XML 권고로 정의되고 있는타당성을 검증하는 파서라고 하는 미입니다. 즉, 실질적으로는 DTD 검증을 제어할 뿐이라고 하는 것입니다. 다만, JAXP 1.2에 정의되고 있는 종래의 2개의 프로퍼티를 제외합니다. 상세하게 무심코는 여기를 참조하십시오.

DTD는 아니고, W3C XML Schema 또는 RELAX NG 등이 새로운 schema 언어를 사용하는 경우는 setValidating(boolean) 메서드를 false로 의해 파서를 타당성을 검증하지 않는 설정으로 하고 나서, setSchema(Schema) 메서드로 schema를 파서에 관련짓습니다.

파라미터:

validating - 이 팩토리로 작성된 파서가 구문 분석시에 문서의 타당성을 검증하는 경우는 true, 그렇지 않은 경우는 false

isNamespaceAware

public boolean isNamespaceAware()

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

반환값:

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

isValidating

public boolean isValidating()

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

반환값:

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

setFeature

public abstract void setFeature(String  name,
                                boolean value)
                         throws ParserConfigurationException,

                                SAXNotRecognizedException,

                                SAXNotSupportedException 

org.xml.sax.XMLReader 기본이 되는 구현에 특정의 기능을 설정합니다. 코어 기능과 코어 프로퍼티의 리스트에 대해서는 http://www.saxproject.org/ 사이트를 참조하십시오.

구현은 모두 XMLConstants.FEATURE_SECURE_PROCESSING 기능을 지원 할 필요가 있습니다.

• 기능이 true인 경우, 구현은 구현 한계에 준거하는 XML 처리를 제한한다. 예는 엔티티 확장 제한이나 대용량의 자원을 소비하는 XML schema 등. 보안상의 이유로부터 XML 처리가 제한되는 경우는 등록을 마친 ErrorHandler.fatalError(SAXParseException exception)에 호출을 개입시켜 보고된다. 핸들러 사양에 대해서는 SAXParser parse 메서드를 참조
• 기능이 false인 경우, 구현은 구현 한계에 상관하지 않고, XML 사양에 따라 XML를 처리한다

파라미터:

name - 설정되는 기능의 이름

value - 설정되는 기능의 값

예외:

ParserConfigurationException - 요구된 구성을 채우는 파서를 생성할 수 없는 경우

SAXNotRecognizedException - 기본이 되는 XMLReader가 프로퍼티명을 인식하지 않는 경우

SAXNotSupportedException - 기본이 되는 XMLReader는 프로퍼티명을 인식하지만, 그 프로퍼티를 지원 하지 않는 경우

NullPointerException - name 파라미터가 null인 경우

관련 항목:

XMLReader.setFeature(java.lang.String, boolean)

getFeature

public abstract boolean getFeature(String  name)
                            throws ParserConfigurationException,

                                   SAXNotRecognizedException,

                                   SAXNotSupportedException 

org.xml.sax.XMLReader 기본이 되는 구현으로 요구된 특정의 프로퍼티를 리턴합니다.

파라미터:

name - 꺼내지는 프로퍼티의 이름

반환값:

요구된 프로퍼티의 값

예외:

ParserConfigurationException - 요구된 구성을 채우는 파서를 생성할 수 없는 경우

SAXNotRecognizedException - 기본이 되는 XMLReader가 프로퍼티명을 인식하지 않는 경우

SAXNotSupportedException - 기본이 되는 XMLReader는 프로퍼티명을 인식하지만, 그 프로퍼티를 지원 하지 않는 경우

관련 항목:

XMLReader.getProperty(java.lang.String)

getSchema

public Schema  getSchema()

setSchema(Schema schema) 메서드에 의해 지정된 Schema 객체를 취득합니다.

반환값:

setSchema(Schema) 메서드에의해 마지막에 설정된 Schema 객체, 또는 SAXParserFactory 가 작성되고 나서, 메서드가 불려가 지 않은 경우는 null

예외:

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

도입된 버전 :

1.5

setSchema

public void setSchema(Schema  schema)

이 팩토리로부터 작성된 파서에 의해 사용되는 Schema를 설정합니다.

Schema 가 null 이외의 경우, 파서는 지금부터 작성된 발리 데이터를 사용해, 어플리케이션에 정보를 건네주기 전에 문서를 검증합니다.

발리 데이터에 의해 경고, 에러, 중대한 에러가 검출되면, 파서는 자신이 이러한 에러를 검출했을 경우와 같게 이것들을 처리할 필요가 있습니다. 즉, 사용자 지정 ErrorHandler 가 설정되어 있는 경우는 이러한 에러를 받아, 그렇지 않은 경우는 구현 고유의 디폴트의 에러 처리 규칙에 따라 처리될 필요가 있습니다.

발리 데이터는 SAX 이벤트 스트림을 변경하는 일이 있어 (예를 들어 문서로부터 없어지고 있던 기본값을 추가하는 등), 파서는 이러한 변경된 이벤트 스트림을 어플리케이션이 확실히 받도록 하는 역할을 가집니다.

최초로Schema 로서 null이 설정됩니다.

이 처리는 isValidating() 메서드가 false를 돌려주었을 경우에서도 유효합니다.

http://java.sun.com/xml/jaxp/properties/schemaSource 프로퍼티 또는 http://java.sun.com/xml/jaxp/properties/schemaLanguage 프로퍼티를 null 이외 Schema 객체와 함께 사용하면 에러가 됩니다. 이러한 설정에서는 이러한 프로퍼티가 SAXParser 로 설정되어 있으면 SAXException 예외가 발생합니다.

구현시의 주의

파서는 모든 Schema 구현으로 동작할 필요가 있습니다. 다만, 파서 및 schema가 사양에 기재되어 있는 결과를 내는 한, 구현 고유의 커스텀 도구를 사용할 수 있습니다.

파라미터:

schema - 사용하는 Schema 또는 schema를 삭제하는 경우는 null

예외:

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

도입된 버전 :

1.5

setXIncludeAware

public void setXIncludeAware(boolean state)

XInclude 처리 상태를 설정합니다.

문서 인스턴스에 XInclude 마크 업이 발견되었을 경우, 「XML Inclusions (XInclude) Version 1.0」으로 가리키는 대로 처리할 필요가 있습니다.

XInclude 처리의 디폴트는 false로 설정됩니다.

파라미터:

state - XInclude 처리를 true 또는 false로 설정한다

예외:

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

도입된 버전 :

1.5

isXIncludeAware

public boolean isXIncludeAware()

XInclude 처리 상태를 취득합니다.

반환값:

XInclude 처리의 현재 상태

예외:

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

도입된 버전 :

1.5