org.xml.sax
인터페이스 Parser

기존의 구현 클래스의 일람:

XMLReaderAdapter

추천 되고 있지 않습니다. 이 인터페이스는 이름 공간을 서포트하는 SAX2 의 XMLReader 인터페이스로 옮겨놓을 수 있고 있습니다.

public interface Parser

SAX (Simple API for XML) 파서의 기본 인터페이스입니다.

이 모듈은 원시 코드, 문서 모두 공개 도메인에 놓여져 있습니다. 따라서, 내용에 관한프로텍션은 일절 제공되지 않습니다.

SAX1 의 메인의 이벤트 제공 인터페이스였지만, SAX2 로, 이름 공간 기능과 고도의 구성 및 확장 기능을 서포트하는 XMLReader 로 옮겨졌습니다.

모든 SAX1 파서는 이 기본 인터페이스를 구현할 필요가 있습니다. 어플리케이션은 다양한 형태의 이벤트 핸들러를 등록할 때나, URI 또는 캐릭터 스트림으로부터 구문 분석을 개시할 때에 이 인터페이스를 사용합니다.

모든 SAX1 파서는 인수 없음의 constructor 도 구현하지 않으면 안됩니다 (그 외의 constructor 도 사용 가능).

SAX1 파서는 재이용 가능합니다만, 재입 불가능합니다. 즉 최초의 구문 분석이 종료하면(자), 어플리케이션은 파서 오브젝트를 재이용할 수 있습니다만 (다른 입력 소스에서의 재이용도 가능), 1 회의 구문 분석으로 parse() 메소드를 반복해 호출할 수 없습니다.

도입된 버젼:

SAX 1.0

관련 항목:

EntityResolver , DTDHandler , DocumentHandler , ErrorHandler , HandlerBase , InputSource

메소드의 개요

void	parse (InputSource source) 추천 되고 있지 않습니다. XML 문서를 구문 분석 합니다.
void	parse (String systemId) 추천 되고 있지 않습니다. 시스템 식별자 (URI)로부터 XML 문서를 구문 분석 합니다.
void	setDocumentHandler (DocumentHandler handler) 추천 되고 있지 않습니다. 어플리케이션에 문서 이벤트 핸들러의 등록을 허가합니다.
void	setDTDHandler (DTDHandler handler) 추천 되고 있지 않습니다. 어플리케이션에 DTD 이벤트 핸들러의 등록을 허가합니다.
void	setEntityResolver (EntityResolver resolver) 추천 되고 있지 않습니다. 어플리케이션에 카스탐엔티티리조르바의 등록을 허가합니다.
void	setErrorHandler (ErrorHandler handler) 추천 되고 있지 않습니다. 어플리케이션에 에러 이벤트 핸들러의 등록을 허가합니다.
void	setLocale (Locale locale) 추천 되고 있지 않습니다. 어플리케이션에 에러나 경고의 로케일의 요구를 허가합니다.

메소드의 상세

setLocale

public void setLocale(Locale  locale)
               throws SAXException 

추천 되고 있지 않습니다.

어플리케이션에 에러나 경고의 로케일의 요구를 허가합니다.

SAX 파서는 에러 및 경고의 지역 대응을 의무지워지고 있지 않습니다. 그러나, 요구된 로케일을 서포트하고 있지 않는 경우는 SAX 예외를 슬로우 할 필요가 있습니다. 구문 분석중은 어플리케이션으로부터 로케일의 변경을 요구할 수 없습니다.

파라미터:

locale - Java Locale 오브젝트

예외:

SAXException - 요구된 로케일이 서포트되어 있지 않은 경우, 이전의 (디폴트의) 로케일을 사용해 예외를 슬로우

관련 항목:

SAXException , SAXParseException

setEntityResolver

public void setEntityResolver(EntityResolver  resolver)

추천 되고 있지 않습니다.

어플리케이션에 카스탐엔티티리조르바의 등록을 허가합니다.

어플리케이션이 엔티티리조르바를 등록하지 않으면 SAX 파서는 시스템 식별자를 해결해, 엔티티 자체에의 접속을 개시합니다 (HandlerBase 의 디폴트의 동작 구현).

어플리케이션은 구문 분석중도 새로운 엔티티리조르바를 등록할 수 있습니다. 새로운 resolver가 등록되면(자), SAX 파서는 즉시 이 resolver의 사용을 개시하지 않으면 안됩니다.

파라미터:

resolver - 해결하는 엔티티의 오브젝트

관련 항목:

EntityResolver , HandlerBase

setDTDHandler

public void setDTDHandler(DTDHandler  handler)

추천 되고 있지 않습니다.

어플리케이션에 DTD 이벤트 핸들러의 등록을 허가합니다.

어플리케이션이 DTD 핸들러를 등록하지 않으면 SAX 파서가 보고하는 모든 DTD 이벤트는 아무 통지도 없게 무시됩니다 (HandlerBase 의 디폴트의 동작 구현).

어플리케이션은 구문 분석중도 새로운 핸들러를 등록할 수 있습니다. 새로운 핸들러가 등록되면(자), SAX 파서는 즉시 이 핸들러의 사용을 개시하지 않으면 안됩니다.

파라미터:

handler - DTD 핸들러

관련 항목:

DTDHandler , HandlerBase

setDocumentHandler

public void setDocumentHandler(DocumentHandler  handler)

추천 되고 있지 않습니다.

어플리케이션에 문서 이벤트 핸들러의 등록을 허가합니다.

어플리케이션이 문서 핸들러를 등록하지 않으면 SAX 파서가 보고하는 모든 문서 이벤트는 아무 통지도 없게 무시됩니다 (HandlerBase 의 디폴트의 동작 구현).

어플리케이션은 구문 분석중도 새로운 핸들러를 등록할 수 있습니다. 새로운 핸들러가 등록되면(자), SAX 파서는 즉시 이 핸들러의 사용을 개시하지 않으면 안됩니다.

파라미터:

handler - 문서 핸들러

관련 항목:

DocumentHandler , HandlerBase

setErrorHandler

public void setErrorHandler(ErrorHandler  handler)

추천 되고 있지 않습니다.

어플리케이션에 에러 이벤트 핸들러의 등록을 허가합니다.

어플리케이션이 에러 이벤트 핸들러를 등록하지 않으면 SAX 파서가 보고하는 에러 이벤트는 아무 통지도 없게 무시됩니다. 다만, fatalError 만일 수 있는은 예외입니다. 이 에러 이벤트는 SAXException 를 슬로우 합니다 (HandlerBase 의 디폴트의 동작 구현).

어플리케이션은 구문 분석중도 새로운 핸들러를 등록할 수 있습니다. 새로운 핸들러가 등록되면(자), SAX 파서는 즉시 이 핸들러의 사용을 개시하지 않으면 안됩니다.

파라미터:

handler - 에러 핸들러

관련 항목:

ErrorHandler , SAXException , HandlerBase

parse

public void parse(InputSource  source)
           throws SAXException ,
                  IOException 

추천 되고 있지 않습니다.

XML 문서를 구문 분석 합니다.

어플리케이션은 이 메소드를 사용해, 유효한 임의의 입력 소스 (캐릭터 스트림, 바이트 스트림, 또는 URI)로부터 XML 문서의 구문 분석을 개시하도록(듯이) SAX 파서에 지시를 보냅니다.

구문 분석중은 어플리케이션으로부터 이 메소드를 호출할 수 없습니다. 추가하는 XML 문서가 있는 경우는 그 1 kr 1 kr에 새로운 Parser 를 작성할 필요가 있습니다. 구문 분석이 완료하면(자), 같은 Parser 오브젝트를 재이용할 수 있습니다. 다른 입력 소스에서의 재이용도 가능합니다.

파라미터:

source - XML 문서의 톱 레벨의 입력 소스입니다.

예외:

SAXException - SAX 예외. 다른 예외를 랩 하고 있을 가능성이 있다

IOException - 파서로부터의 IO 예외. 통상, 어플리케이션이 제공하는 바이트 스트림 또는 캐릭터 스트림으로부터 의 예외

관련 항목:

InputSource , parse(java.lang.String) , setEntityResolver(org.xml.sax.EntityResolver) , setDTDHandler(org.xml.sax.DTDHandler) , setDocumentHandler(org.xml.sax.DocumentHandler) , setErrorHandler(org.xml.sax.ErrorHandler)

parse

public void parse(String  systemId)
           throws SAXException ,
                  IOException 

추천 되고 있지 않습니다.

시스템 식별자 (URI)로부터 XML 문서를 구문 분석 합니다.

이 메소드를 사용하면, 시스템 식별자로부터 간단하게 문서를 읽어낼 수가 있습니다. 이하의 지정에서도 같은 것이 생깁니다.

 parse(new InputSource(systemId));
 

시스템 식별자가 URL 의 경우, 어플리케이션은 이것을 파서에 건네주기 전에 완전하게 해결할 필요가 있습니다.

파라미터:

systemId - 시스템 식별자 (URI)

예외:

SAXException - SAX 예외. 다른 예외를 랩 하고 있을 가능성이 있다

IOException - 파서로부터의 IO 예외. 통상, 어플리케이션이 제공하는 바이트 스트림 또는 캐릭터 스트림으로부터 의 예외

관련 항목:

parse(org.xml.sax.InputSource)