Parser (Java Platform SE 6) - xrath.com 에서 번역됨

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM Platform
Standard Ed. 6

전의 클래스 다음의 클래스

프레임 있어 프레임 없음

개요: 상자 | 필드 | 생성자 | 메소드

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

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)