javax.xml.parsers
클래스 SAXParser

java.lang.Object 
  javax.xml.parsers.SAXParser

public abstract class SAXParser
extends Object 

XMLReader 구현 클래스를감싸는 API를 정의합니다. JAXP 1.0 에서는 이 클래스는 Parser 인터페이스를 랩 했습니다만, 이 인터페이스는 XMLReader 로 옮겨졌습니다. 이행을 간단하게 하기 위해서 이 클래스는 새로운 메서드의 지원와 같이, 같은 이름과 인터페이스의 지원 도 계속합니다.이 클래스의 인스턴스는 SAXParserFactory.newSAXParser() 메서드에 의해 취득할 수 있습니다. 이 클래스의 인스턴스를 취득하면, 다양한 입력 소스로부터 XML 문서를 구문 분석 할 수 있습니다. 이러한 입력 소스에는 InputStream, File, URL 및 SAX InputSource가 있습니다.

이 static 메서드는 시스템 프로퍼티 설정에 근거해 새로운 팩토리 인스턴스를 작성하는지, 또는 프로퍼티가 정의되어 있지 않은 경우에 플랫폼의 디폴트를 사용합니다.

어느 팩토리 구현을 작성할까를 결정하는 시스템 프로퍼티의 이름은 "javax.xml.parsers.SAXParserFactory" 입니다. 이 프로퍼티는 이 추상 클래스의 구상 서브 클래스를 명명합니다. 프로퍼티가 정의되어 있지 않은 경우는 플랫폼의 디폴트가 사용됩니다.

컨텐츠는 기본이 되는 파서로 구문 분석 되기 때문에 지정된 HandlerBase 또는 DefaultHandler 메서드가 호출됩니다.

기본이 되는 구현을감싸는 이 클래스의 구현측에서는 ParserAdapter 클래스를 사용해, 그 SAX1 구현을 이 개정된 클래스아래에서 동작하도록, 최초로 적합시키는 것을 고려할 수 있습니다.

생성자 개요

protected

SAXParser () 인스톨을 방해하는 protected 생성자 입니다.

메서드 개요

abstract Parser	getParser () 이 클래스의 구현에 의해 캡슐화되는 SAX 파서를 리턴합니다.
abstract Object	getProperty (String name) XMLReader 기본이 되는 구현으로 요구된 특정의 프로퍼티를 리턴합니다.
Schema	getSchema () XML 프로세서에 의해 사용되는 Schema 에의 참조를 취득합니다.
abstract XMLReader	getXMLReader () 이 클래스의 구현에 의해 캡슐화되는 XMLReader를 리턴합니다.
abstract boolean	isNamespaceAware () 이 파서가 이름 공간을 인식하도록 설정되어 있는지를 나타냅니다.
abstract boolean	isValidating () 이 파서가 XML 문서를 검증하도록 설정되어 있는지를 나타냅니다.
boolean	isXIncludeAware () 이 파서의 XInclude 처리 모드를 취득합니다.
void	parse (File f, DefaultHandler dh) 지정된 파일의 컨텐츠를, 지정된 DefaultHandler를 사용해 XML 로서 구문 분석 합니다.
void	parse (File f, HandlerBase hb) 지정된 파일의 컨텐츠를, 지정된 HandlerBase를 사용해 XML 로서 구문 분석 합니다.
void	parse (InputSource is, DefaultHandler dh) 지정된 InputSource 컨텐츠를, 지정된 DefaultHandler를 사용해 XML 로서 구문 분석 합니다.
void	parse (InputSource is, HandlerBase hb) 지정된 InputSource 컨텐츠를, 지정된 HandlerBase를 사용해 XML 로서 구문 분석 합니다.
void	parse (InputStream is, DefaultHandler dh) 지정된 InputStream 인스턴스의 컨텐츠를, 지정된 DefaultHandler를 사용해 XML 로서 구문 분석 합니다.
void	parse (InputStream is, DefaultHandler dh, String systemId) 지정된 InputStream 인스턴스의 컨텐츠를, 지정된 DefaultHandler를 사용해 XML 로서 구문 분석 합니다.
void	parse (InputStream is, HandlerBase hb) 지정된 InputStream 인스턴스의 컨텐츠를, 지정된 HandlerBase를 사용해 XML 로서 구문 분석 합니다.
void	parse (InputStream is, HandlerBase hb, String systemId) 지정된 InputStream 인스턴스의 컨텐츠를, 지정된 HandlerBase를 사용해 XML 로서 구문 분석 합니다.
void	parse (String uri, DefaultHandler dh) 지정된 URI (Uniform Resource Identifier)로 표현된 컨텐츠를, 지정된 DefaultHandler를 사용해 XML 로서 구문 분석 합니다.
void	parse (String uri, HandlerBase hb) 지정된 URI (Uniform Resource Identifier)로 표현된 컨텐츠를, 지정된 HandlerBase를 사용해 XML 로서 구문 분석 합니다.
void	reset () 이 SAXParser를 원의 설정에 리셋 합니다.
abstract void	setProperty (String name, Object value) XMLReader 기본이 되는 구현에 특정의 프로퍼티를 설정합니다.

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

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

생성자 상세

SAXParser

protected SAXParser()

인스톨을 방해하는 protected 생성자 입니다. SAXParserFactory.newSAXParser()를 사용합니다.

메서드의 상세

reset

public void reset()

이 SAXParser를 원의 설정에 리셋 합니다.

SAXParser는 SAXParserFactory.newSAXParser() 로 작성된 시점 상태에 리셋 됩니다. reset()는 기존의 SAXParser 재사용을 허가하도록 설정되어 있기 때문에 새로운 SAXParser 작성에 관련된 자원을 절약할 수 있습니다.

SAXParser를 리셋 했을 경우, Object.equals(Object obj) 등의 같은 Schema Object를 가지는 것은 보증되지 않습니다. 기능적으로 같은 Schema를 가지는 것은 보증됩니다.

도입된 버전 :

1.5

parse

public void parse(InputStream  is,
                  HandlerBase  hb)
           throws SAXException,

                  IOException 

지정된 InputStream 인스턴스의 컨텐츠를, 지정된 HandlerBase를 사용해 XML 로서 구문 분석 합니다. HandlerBase 클래스는 SAX 2.0 에서는 추천 되지 않기 때문에 이 메서드의 DefaultHandler 버전을 사용하는 것을 추천합니다.

파라미터:

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

hb - 사용하는 SAX HandlerBase

예외:

IllegalArgumentException - 지정된 InputStream가 null인 경우

SAXException - 구문 분석으로 SAX 에러가 생성되었을 경우

IOException - InputStream와 의 교환으로 입출력 에러가 발생했을 경우

관련 항목:

DocumentHandler

parse

public void parse(InputStream  is,
                  HandlerBase  hb,
                  String  systemId)
           throws SAXException,

                  IOException 

지정된 InputStream 인스턴스의 컨텐츠를, 지정된 HandlerBase를 사용해 XML 로서 구문 분석 합니다. HandlerBase 클래스는 SAX 2.0 에서는 추천 되지 않기 때문에 이 메서드의 DefaultHandler 버전을 사용하는 것을 추천합니다.

파라미터:

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

hb - 사용하는 SAX HandlerBase

systemId - 상대 URI를 해결하는데 필요한 시스템 식별자

예외:

IllegalArgumentException - 지정된 InputStream가 null인 경우

IOException - InputStream와 의 교환으로 입출력 에러가 발생했을 경우

SAXException - 처리중에 SAX 에러가 발생했을 경우

관련 항목:

version of this method instead.

parse

public void parse(InputStream  is,
                  DefaultHandler  dh)
           throws SAXException,

                  IOException 

지정된 InputStream 인스턴스의 컨텐츠를, 지정된 DefaultHandler를 사용해 XML 로서 구문 분석 합니다.

파라미터:

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

dh - 사용하는 SAX DefaultHandler

예외:

IllegalArgumentException - 지정된 InputStream가 null인 경우

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

SAXException - 처리중에 SAX 에러가 발생했을 경우

관련 항목:

DocumentHandler

parse

public void parse(InputStream  is,
                  DefaultHandler  dh,
                  String  systemId)
           throws SAXException,

                  IOException 

지정된 InputStream 인스턴스의 컨텐츠를, 지정된 DefaultHandler를 사용해 XML 로서 구문 분석 합니다.

파라미터:

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

dh - 사용하는 SAX DefaultHandler

systemId - 상대 URI를 해결하는데 필요한 시스템 식별자

예외:

IllegalArgumentException - 지정된 InputStream가 null인 경우

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

SAXException - 처리중에 SAX 에러가 발생했을 경우

관련 항목:

version of this method instead.

parse

public void parse(String  uri,
                  HandlerBase  hb)
           throws SAXException,

                  IOException 

지정된 URI (Uniform Resource Identifier)로 표현된 컨텐츠를, 지정된 HandlerBase를 사용해 XML 로서 구문 분석 합니다. HandlerBase 클래스는 SAX 2.0 에서는 추천 되지 않기 때문에 이 메서드의 DefaultHandler 버전을 사용하는 것을 추천합니다.

파라미터:

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

hb - 사용하는 SAX HandlerBase

예외:

IllegalArgumentException - uri가 null인 경우

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

SAXException - 처리중에 SAX 에러가 발생했을 경우

관련 항목:

DocumentHandler

parse

public void parse(String  uri,
                  DefaultHandler  dh)
           throws SAXException,

                  IOException 

지정된 URI (Uniform Resource Identifier)로 표현된 컨텐츠를, 지정된 DefaultHandler를 사용해 XML 로서 구문 분석 합니다.

파라미터:

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

dh - 사용하는 SAX DefaultHandler

예외:

IllegalArgumentException - uri가 null인 경우

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

SAXException - 처리중에 SAX 에러가 발생했을 경우

관련 항목:

DocumentHandler

parse

public void parse(File  f,
                  HandlerBase  hb)
           throws SAXException,

                  IOException 

지정된 파일의 컨텐츠를, 지정된 HandlerBase를 사용해 XML 로서 구문 분석 합니다. HandlerBase 클래스는 SAX 2.0 에서는 추천 되지 않기 때문에 이 메서드의 DefaultHandler 버전을 사용하는 것을 추천합니다.

파라미터:

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

hb - 사용하는 SAX HandlerBase

예외:

IllegalArgumentException - File 객체가 null인 경우

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

SAXException - 처리중에 SAX 에러가 발생했을 경우

관련 항목:

DocumentHandler

parse

public void parse(File  f,
                  DefaultHandler  dh)
           throws SAXException,

                  IOException 

지정된 파일의 컨텐츠를, 지정된 DefaultHandler를 사용해 XML 로서 구문 분석 합니다.

파라미터:

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

dh - 사용하는 SAX DefaultHandler

예외:

IllegalArgumentException - File 객체가 null인 경우

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

SAXException - 처리중에 SAX 에러가 발생했을 경우

관련 항목:

DocumentHandler

parse

public void parse(InputSource  is,
                  HandlerBase  hb)
           throws SAXException,

                  IOException 

지정된 InputSource 컨텐츠를, 지정된 HandlerBase를 사용해 XML 로서 구문 분석 합니다. HandlerBase 클래스는 SAX 2.0 에서는 추천 되지 않기 때문에 이 메서드의 DefaultHandler 버전을 사용하는 것을 추천합니다.

파라미터:

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

hb - 사용하는 SAX HandlerBase

예외:

IllegalArgumentException - InputSource 객체가 null인 경우

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

SAXException - 처리중에 SAX 에러가 발생했을 경우

관련 항목:

DocumentHandler

parse

public void parse(InputSource  is,
                  DefaultHandler  dh)
           throws SAXException,

                  IOException 

지정된 InputSource 컨텐츠를, 지정된 DefaultHandler를 사용해 XML 로서 구문 분석 합니다.

파라미터:

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

dh - 사용하는 SAX DefaultHandler

예외:

IllegalArgumentException - InputSource 객체가 null인 경우

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

SAXException - 처리중에 SAX 에러가 발생했을 경우

관련 항목:

DocumentHandler

getParser

public abstract Parser  getParser()
                          throws SAXException 

이 클래스의 구현에 의해 캡슐화되는 SAX 파서를 리턴합니다.

반환값:

이 클래스의 구현에 의해 캡슐화되는 SAX 파서

예외:

SAXException - 처리중에 SAX 에러가 발생했을 경우

getXMLReader

public abstract XMLReader  getXMLReader()
                                throws SAXException 

이 클래스의 구현에 의해 캡슐화되는 XMLReader를 리턴합니다.

반환값:

이 클래스의 구현에 의해 캡슐화되는 XMLReader

예외:

SAXException - 처리중에 SAX 에러가 발생했을 경우

isNamespaceAware

public abstract boolean isNamespaceAware()

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

반환값:

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

isValidating

public abstract boolean isValidating()

이 파서가 XML 문서를 검증하도록 설정되어 있는지를 나타냅니다.

반환값:

이 파서가 XML 문서를 검증하도록 설정되어 있는 경우는 true, 그렇지 않은 경우는 false

setProperty

public abstract void setProperty(String  name,
                                 Object  value)
                          throws SAXNotRecognizedException,

                                 SAXNotSupportedException 

XMLReader 기본이 되는 구현에 특정의 프로퍼티를 설정합니다. 코어 기능과 코어 프로퍼티의 리스트에 대해서는 http://sax.sourceforge.net/? selected=get-set 사이트를 참조하십시오.

파라미터:

name - 설정되는 프로퍼티의 이름

value - 설정되는 프로퍼티의 값

예외:

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

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

관련 항목:

XMLReader.setProperty(java.lang.String, java.lang.Object)

getProperty

public abstract Object  getProperty(String  name)
                            throws SAXNotRecognizedException,

                                   SAXNotSupportedException 

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

파라미터:

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

반환값:

요구된 프로퍼티의 값

예외:

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

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

관련 항목:

XMLReader.getProperty(java.lang.String)

getSchema

public Schema  getSchema()

XML 프로세서에 의해 사용되는 Schema 에의 참조를 취득합니다.

schema를 사용하고 있지 않는 경우는 null이 리턴됩니다 .

반환값:

사용되고 있는 Schema 또는 아무것도 사용하고 있지 않는 경우는 null

예외:

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

도입된 버전 :

1.5

isXIncludeAware

public boolean isXIncludeAware()

이 파서의 XInclude 처리 모드를 취득합니다.

반환값:

이 파서가 팩토리로부터 작성되었을 경우에 SAXParserFactory.isXIncludeAware() 반환값

예외:

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

도입된 버전 :

1.5

관련 항목:

SAXParserFactory.setXIncludeAware(boolean)