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

public interface DeclHandler

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

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

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

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

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

DeclHandler 를 XML 리더로 설정하려면 , propertyId "http://xml.org/sax/properties/declaration-handler" 를 지정해 setProperty 메소드를 사용합니다. 리더가 선언 이벤트를 서포트하지 않는 경우, 핸들러를 등록하려고 하면(자),SAXNotRecognizedException 또는 SAXNotSupportedException 가 슬로우 됩니다.

도입된 버젼:

1.0

관련 항목:

XMLReader

메소드의 개요

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

메소드의 상세

elementDecl

public void elementDecl(String  name,
                        String  model)
                 throws SAXException 

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

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

파라미터:

name - 요소형명

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

예외:

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

attributeDecl

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

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

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

통상의 엔티티와는 달라, 속성치에 포함되는 파라메이타엔티티는 모두 확장됩니다.

파라미터:

eName - 관련 요소명

aName - 속성의 이름

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

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

value - 속성의 디폴트 값를 나타내는 캐릭터 라인. 존재하지 않는 경우는 null

예외:

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

internalEntityDecl

public 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

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

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

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

파라미터:

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)