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, 파일, URL, 및 SAX InputSource 가 있습니다.

기본이 되는 파서로 컨텐츠를 구문 분석 하는 경우는 지정된 HandlerBase 또는 DefaultHandler 의 메소드가 불려 갑니다.

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

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

도입된 버젼:

JAXP 1.0

생성자의 개요

protected

SAXParser ()

메소드의 개요

abstract Parser	getParser () 이 클래스의 구현에 의해 캡슐화되는 SAX 파서를 돌려줍니다.
abstract Object	getProperty (String name) XMLReader 의 기본이 되는 구현으로 요구된 특정의 프로퍼티를 돌려줍니다.
abstract XMLReader	getXMLReader () 이 클래스의 구현에 의해 캡슐화되는 XMLReader 를 돌려줍니다.
abstract boolean	isNamespaceAware () 이 파서가 이름 공간을 인식하도록(듯이) 설정되어 있는지 어떤지를 나타냅니다.
abstract boolean	isValidating () 이 파서가 XML 문서를 검증하도록(듯이) 설정되어 있는지 어떤지를 나타냅니다.
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 로서 구문 분석 합니다.
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()

메소드의 상세

parse

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

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

파라미터:

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

hb - 사용하는 SAX HandlerBase

예외:

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

IllegalArgumentException - 지정된 InputStream 가 null 의 경우

SAXException - 구문 분석시에 기본이 되는 파서가 SAXException 를 슬로우 했을 경우

관련 항목:

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 를 해결하는데 필요한 시스템 ID

예외:

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

IllegalArgumentException - 지정된 InputStream 가 null 의 경우

SAXException - 구문 분석시에 기본이 되는 파서가 SAXException 를 슬로우 했을 경우

관련 항목:

version of this method instead.

parse

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

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

파라미터:

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

dh - 사용하는 SAX DefaultHandler

예외:

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

IllegalArgumentException - 지정된 InputStream 가 null 의 경우

SAXException - 구문 분석시에 기본이 되는 파서가 SAXException 를 슬로우 했을 경우

관련 항목:

DocumentHandler

parse

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

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

파라미터:

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

dh - 사용하는 SAX DefaultHandler

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

예외:

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

IllegalArgumentException - 지정된 InputStream 가 null 의 경우

SAXException - 구문 분석시에 기본이 되는 파서가 SAXException 를 슬로우 했을 경우

관련 항목:

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

예외:

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

IllegalArgumentException - uri 가 null 의 경우

SAXException - 구문 분석시에 기본이 되는 파서가 SAXException 를 슬로우 했을 경우

관련 항목:

DocumentHandler

parse

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

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

파라미터:

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

dh - 사용하는 SAX DefaultHandler

예외:

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

IllegalArgumentException - uri 가 null 의 경우

SAXException - 구문 분석시에 기본이 되는 파서가 SAXException 를 슬로우 했을 경우

관련 항목:

DocumentHandler

parse

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

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

파라미터:

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

hb - 사용하는 SAX HandlerBase

예외:

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

IllegalArgumentException - File 오브젝트가 null 의 경우

SAXException - 구문 분석시에 기본이 되는 파서가 SAXException 를 슬로우 했을 경우

관련 항목:

DocumentHandler

parse

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

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

파라미터:

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

dh - 사용하는 SAX DefaultHandler

예외:

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

IllegalArgumentException - File 오브젝트가 null 의 경우

SAXException - 구문 분석시에 기본이 되는 파서가 SAXException 를 슬로우 했을 경우

관련 항목:

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

예외:

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

IllegalArgumentException - InputSource 가 null 의 경우

SAXException - 구문 분석시에 기본이 되는 파서가 SAXException 를 슬로우 했을 경우

관련 항목:

DocumentHandler

parse

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

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

파라미터:

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

dh - 사용하는 SAX DefaultHandler

예외:

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

IllegalArgumentException - InputSource 가 null 의 경우

SAXException - 구문 분석시에 기본이 되는 파서가 SAXException 를 슬로우 했을 경우

관련 항목:

DocumentHandler

getParser

public abstract Parser  getParser()
                          throws SAXException 

이 클래스의 구현에 의해 캡슐화되는 SAX 파서를 돌려줍니다.

반환값:

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

SAXException

getXMLReader

public abstract XMLReader  getXMLReader()
                                throws SAXException 

이 클래스의 구현에 의해 캡슐화되는 XMLReader 를 돌려줍니다.

반환값:

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

SAXException

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

파라미터:

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)