org.xml.sax
인터페이스 DTDHandler

기존의 서브 인터페이스의 일람:

TransformerHandler

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

DefaultHandler , HandlerBase , XMLFilterImpl

public interface DTDHandler

표준 DTD 관련 이벤트의 통지를 받습니다.

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

표기법이나 미구문 분석의 엔티티에 관한 정보가 필요한 경우, SAX 어플리케이션은 이 인터페이스를 구현해, 파서의 setDTDHandler 메소드를 사용해 인스턴스를 SAX 파서에 등록합니다. 파서는 이 인스턴스를 사용해, 표기법이나 미구문 분석의 엔티티의 선언을 어플리케이션에 보고합니다.

이 인터페이스에는 XML 권고로 프로세서가 보고하지 않으면 안 된다고 여겨지고 있는 DTD 이벤트 (표기법과 미구문 분석 엔티티의 선언)만이 포함됩니다.

SAX 파서는 이러한 이벤트를, 표기법이나 미구문 분석의 엔티티가 선언된 순서와는 관계없이, 임의의 순서로 보고합니다. 다만, 모든 DTD 이벤트는 문서 핸들러의 startDocument 이벤트의 뒤와 최초의 startElement 이벤트의 전으로 보고되지 않으면 안됩니다.

장래 사용할 수 있게 정보를 해시 테이블이나 오브젝트 트리내에 저장하는 어플리케이션과 그렇지 않은 어플리케이션이 있습니다. "NOTATION","ENTITY" 또는 "ENTITIES" 형의 속성이 검출되었을 경우, 어플리케이션은 이 인터페이스로부터 취득한 정보를 사용해 속성치에 대응하는 엔티티나 표기법을 검출할 수 있습니다.

도입된 버젼:

SAX 1.0

관련 항목:

Parser.setDTDHandler(org.xml.sax.DTDHandler) , HandlerBase

메소드의 개요

void	notationDecl (String name, String publicId, String systemId) 표기법선언 이벤트의 통지를 받습니다.
void	unparsedEntityDecl (String name, String publicId, String systemId, String notationName) 미구문 분석 엔티티 선언 이벤트의 통지를 받습니다.

메소드의 상세

notationDecl

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

표기법선언 이벤트의 통지를 받습니다.

나중에 참조할 수 있게 표기법을 기록하는 어플리케이션과 기록하지 않는 어플리케이션이 있습니다.

1 개 이상의 publicId 및 systemId 가 null 이외의 값이 아니면 안됩니다. 시스템 식별자가 존재해, 이것이 URL 인 경우, SAX 파서는 이 식별자를 이 이벤트로부터 어플리케이션에 건네주기 전에 완전하게 해결할 필요가 있습니다.

표기법선언이 이것을 사용하는 미구문 분석 엔티티의 전에 보고될지 어떨지는 프로텍션되고 있지 않습니다.

파라미터:

name - 표기 법명

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

systemId - 표기법의 시스템 식별자. 지정되어 있지 않은 경우는 null

예외:

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

관련 항목:

unparsedEntityDecl(java.lang.String, java.lang.String, java.lang.String, java.lang.String) , AttributeList

unparsedEntityDecl

public void unparsedEntityDecl(String  name,
                               String  publicId,
                               String  systemId,
                               String  notationName)
                        throws SAXException 

미구문 분석 엔티티 선언 이벤트의 통지를 받습니다.

표기 법명은 notationDecl 이벤트에 의해 보고되는 표기법으로 일치하고 있습니다. 나중에 참조할 수 있게 엔티티를 기록하는 어플리케이션과 기록하지 않는 어플리케이션이 있습니다.

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

파라미터:

name - 미구문 분석 엔티티명

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

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

예외:

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

관련 항목:

notationDecl(java.lang.String, java.lang.String, java.lang.String) , AttributeList