org.xml.sax.ext
인터페이스 DeclHandler

알려진 구현 클래스 목록:

DefaultHandler2

public interface DeclHandler

DTD 선언 이벤트를 위한 SAX2 확장 핸들러입니다.

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

XML 문서중의 DTD 선언에 관한보다 완전한 정보를 제공하는 SAX2용의 임의의 확장 핸들러입니다. 이 핸들러를 인식하기 위해서 XML 리더는 불필요합니다. 또, 이 핸들러는 SAX2 코어 디스트리뷰션인 만큼 포함되어 있는 것은 아닙니다.

데이터 관련의 DTD 선언 (미구문 분석의 엔티티 및 표기법)은 이미 DTDHandler 인터페이스에 의해 보고되고 있는 점에 주의해 주세요.

선언 핸들러와 자구 핸들러를 동시에 사용하는 경우, 모든 이벤트는 startDTD 로부터 endDTD 까지의 사이에 발생합니다.

DeclHandler를 XML 리더로 설정하려면, 프로퍼티명 http://xml.org/sax/properties/declaration-handler 곳의 인터페이스 (또는 null)를 값으로 해서 구현하는 객체를 가지는 setProperty 메서드를 사용합니다. 리더가 선언 이벤트를 보고하지 않는 경우, 핸들러를 등록하려고 하면 SAXNotRecognizedException을 발생시킵니다.

도입된 버전 :

SAX 2.0 (extensions 1.0)

메서드 개요

void	attributeDecl (String eName, String aName, String type, String mode, String value) 속성형 선언을 보고합니다.
void	elementDecl (String name, String model) 요소형 선언을 보고합니다.
void	externalEntityDecl (String name, String publicId, String systemId) 구문 분석 끝난 외부 엔티티 선언을 보고합니다.
void	internalEntityDecl (String name, String value) 내부 엔티티 선언을 보고합니다.

메서드의 상세

elementDecl

void elementDecl(String  name,
                 String  model)
                 throws SAXException 

요소형 선언을 보고합니다.

컨텐츠 모델은 캐릭터 라인 「EMPTY」, 캐릭터 라인 「ANY」, 또는 괄호에 넣어진 그룹 (옵션으로 출현 인디케이터(indicator)를 동반한다)으로 구성됩니다. 이 모델은 모든 파라메이타엔티티가 완전하게 해결되어 모든 공백 문자가 삭제되도록 정규화됩니다. 또, 둘러싸는 괄호를 포함합니다. 그 외의 정규화 (중복 한 괄호의 삭제, 출현 인디케이터(indicator)의 간이화등)는 파서에 의해 수의 행해집니다.

파라미터:

name - 요소형명

model - 컨텐츠 모델을 나타내는 정규 캐릭터 라인

예외:

SAXException - 어플리케이션이 예외를 생성하는 일이 있다

attributeDecl

void attributeDecl(String  eName,
                   String  aName,
                   String  type,
                   String  mode,
                   String  value)
                   throws SAXException 

속성형 선언을 보고합니다.

유효한 (최초의) 속성 선언만이 보고됩니다. 형태는 「CDATA」, 「ID」, 「IDREF」, 「IDREFS」, 「NMTOKEN」, 「NMTOKENS」, 「ENTITY」, 「ENTITIES」, 단락 문자 「|」이라고, 삭제된 모든 공백 문자와 함께 괄호에 넣어진 토큰 그룹, 또는 삭제된 모든 공백 문자와 함께 괄호에 넣어진 토큰 그룹의 직전에 있는 공백 문자의, 직전의 「NOTATION」라고 하는 말의 어떤 것인가의 캐릭터 라인이 됩니다.

값은 어플리케이션에 보고되어 적정하게 정규화되어 실체 참조와 캐릭터 라인 참조를 확장한 값이 됩니다.

파라미터:

eName - 관련 요소명

aName - 속성의 이름

type - 속성형을 나타내는 캐릭터 라인

mode - 속성의 디폴트 모드 (#IMPLIED, #REQUIRED, 또는 #FIXED)를 나타내는 캐릭터 라인. 어느 것에도 들어맞지 않는 경우는 null

value - 속성의 기본값을 나타내는 캐릭터 라인. 존재하지 않는 경우는 null

예외:

SAXException - 어플리케이션이 예외를 생성하는 일이 있다

internalEntityDecl

void internalEntityDecl(String  name,
                        String  value)
                        throws SAXException 

내부 엔티티 선언을 보고합니다.

유효한 (최초의) 엔티티 선언만이 보고됩니다. 보통 의 엔티티와는 달라, 값에 포함되는 모든 파라메이타엔티티는 확장됩니다.

파라미터:

name - 엔티티명. 파라메이타엔티티의 경우, 이름은 「%」로 시작되는

value - 엔티티의 치환 텍스트

예외:

SAXException - 어플리케이션이 예외를 생성하는 일이 있는

관련 항목:

externalEntityDecl(java.lang.String, java.lang.String, java.lang.String), DTDHandler.unparsedEntityDecl(java.lang.String, java.lang.String, java.lang.String, java.lang.String)

externalEntityDecl

void externalEntityDecl(String  name,
                        String  publicId,
                        String  systemId)
                        throws SAXException 

구문 분석 끝난 외부 엔티티 선언을 보고합니다.

유효한 (최초의) 엔티티 선언만이 보고됩니다.

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

파라미터:

name - 엔티티명. 파라메이타엔티티의 경우, 이름은 「%」로 시작되는

publicId - 엔티티의 공개 식별자. 지정되어 있지 않은 경우는 null

systemId - 엔티티의 시스템 식별자

예외:

SAXException - 어플리케이션이 예외를 생성하는 일이 있는

관련 항목:

internalEntityDecl(java.lang.String, java.lang.String), DTDHandler.unparsedEntityDecl(java.lang.String, java.lang.String, java.lang.String, java.lang.String)