Parser (Java 2 Platform SE 5.0)

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 다음 클래스

프레임으로 프레임 없이

개요: NESTED | 필드 | 생성자 | 메서드

상세: 필드 | 생성자 | 메서드

org.xml.sax
인터페이스 Parser

알려진 구현 클래스 목록:: XMLReaderAdapter

추천하지 않습니다. 이 인터페이스는 이름 공간을 지원하는 SAX2 XMLReader 인터페이스로 대체할 수 있습니다.

public interface Parser

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

이 모듈은 원시 코드, 문서 모두 공개 도메인에 놓여져 있습니다. 따라서, 내용에 관한보증은 일절 제공되지 않습니다. 상세한 것에 대하여는 http://www.saxproject.org 를 참조하십시오.

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

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

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

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

void setLocale(Locale  locale)
               throws SAXException

추천하지 않습니다.

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

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

파라미터:: locale - Java Locale 객체
예외:: SAXException - 요구된 로케일이 지원 되어 있지 않은 경우, 이전의 (디폴트의) 로케일을 사용해 예외를 Throw
관련 항목:: SAXException, SAXParseException

setEntityResolver

void setEntityResolver(EntityResolver  resolver)

추천하지 않습니다.

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

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

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

파라미터:: resolver - 해결하는 엔티티의 객체
관련 항목:: EntityResolver, HandlerBase

setDTDHandler

void setDTDHandler(DTDHandler  handler)

추천하지 않습니다.

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

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

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

파라미터:: handler - DTD 핸들러
관련 항목:: DTDHandler, HandlerBase

setDocumentHandler

void setDocumentHandler(DocumentHandler  handler)

추천하지 않습니다.

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

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

파라미터:: handler - 문서 핸들러
관련 항목:: DocumentHandler, HandlerBase

setErrorHandler

void setErrorHandler(ErrorHandler  handler)

추천하지 않습니다.

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

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

파라미터:: handler - 에러 핸들러
관련 항목:: ErrorHandler, SAXException, HandlerBase

parse

void parse(InputSource  source)
           throws SAXException,

                  IOException

추천하지 않습니다.

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

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

구문 분석중은 어플리케이션으로부터 이 메서드를 호출할 수 없습니다. 추가하는 XML 문서가 있는 경우는 그 1개 1개에 새로운 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

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)