javax.xml.parsers
클래스 SAXParserFactory

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

public abstract class SAXParserFactory

extends Object

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

SAXParserFactory 클래스의 구현은 thread 세이프인 것은 프로텍션 「되지 않습니다」. 복수의 thread로부터 SAXParserFactory 가 사용될지 어떨지의 확인은 유저 어플리케이션으로 실시합니다. 다른 방법으로서 어플리케이션은 thread 당 SAXParserFactory 의 1 개의 인스턴스를 가질 수가 있습니다. 팩토리의 인스턴스가 복수의 thread로 동시에 사용되지 않으면, 어플리케이션은 팩토리의 같은 인스턴스를 사용해 SAXParser 의 1 개 이상의 인스턴스를 취득할 수가 있습니다.

static newInstance 메소드는 이 클래스의 새로운 고정 구현을 돌려줍니다.

도입된 버젼:

JAXP 1.0

생성자의 개요

protected

SAXParserFactory ()

메소드의 개요

abstract boolean	getFeature (String name) org.xml.sax.XMLReader 의 기본이 되는 구현으로 요구된 특정의 프로퍼티를 돌려줍니다.
boolean	isNamespaceAware () 팩토리가 이름 공간을 인식하는 파서를 작성하도록(듯이) 설정되어 있는지 어떤지를 나타냅니다.
boolean	isValidating () 구문 분석시에 XML 컨텐츠를 검증하는 파서를 작성하도록(듯이) 팩토리가 설정되어 있는지 어떤지를 나타냅니다.
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	setValidating (boolean validating) 이 팩토리로 작성된 파서가 구문 분석시에 문서를 검증하도록(듯이) 지정합니다.

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

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

생성자의 상세

SAXParserFactory

protected SAXParserFactory()

메소드의 상세

newInstance

public static SAXParserFactory  newInstance()
                                    throws FactoryConfigurationError 

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

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

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

반환값:

SAXParserFactory 의 새로운 인스턴스

예외:

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

newSAXParser

public abstract SAXParser  newSAXParser()
                                throws ParserConfigurationException ,
                                       SAXException 

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

반환값:

SAXParser 의 새로운 인스턴스

예외:

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

SAXException

setNamespaceAware

public void setNamespaceAware(boolean awareness)

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

파라미터:

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

setValidating

public void setValidating(boolean validating)

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

파라미터:

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.megginson.com/SAX/Java/features.html 의 사이트를 참조해 주세요.

파라미터:

name - 설정되는 기능의 이름

value - 설정되는 기능의 값

예외:

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

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

ParserConfigurationException

관련 항목:

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

getFeature

public abstract boolean getFeature(String  name)
                            throws ParserConfigurationException ,
                                   SAXNotRecognizedException ,
                                   SAXNotSupportedException 

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

파라미터:

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

반환값:

요구된 프로퍼티의 값

예외:

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

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

ParserConfigurationException

관련 항목:

XMLReader.getProperty(java.lang.String)