org.xml.sax
인터페이스 DTDHandler

알려진 서브 인터페이스 목록 :

TransformerHandler

알려진 구현 클래스 목록:

DefaultHandler, DefaultHandler2, HandlerBase, XMLFilterImpl

public interface DTDHandler

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

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

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

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

SAX 파서는 이러한 이벤트를, 표기법이나 해석 대상외의 엔티티가 선언된 순서와는 관계없이, 임의의 순서로 보고합니다. 다만, 모든 DTD 이벤트는 문서 핸들러의 startDocument 이벤트의 뒤와 최초의 startElement 이벤트의 전으로 보고되지 않으면 안됩니다. LexicalHandler 가 사용되고 있는 경우, 이러한 이벤트는 endDTD event 전에서도 보고될 필요가 있습니다.

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

도입된 버전 :

SAX 1.0

관련 항목:

XMLReader.setDTDHandler(org.xml.sax.DTDHandler)

메서드 개요

void	notationDecl (String name, String publicId, String systemId) 표기법선언 이벤트의 통지를 받습니다.
void	unparsedEntityDecl (String name, String publicId, String systemId, String notationName) 해석 대상외 엔티티 선언 이벤트의 통지를 받습니다.

메서드의 상세

notationDecl

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), Attributes

unparsedEntityDecl

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

해석 대상외 엔티티 선언 이벤트의 통지를 받습니다.

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

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

파라미터:

name - 해석 대상외 엔티티명

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

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

notationName - 관련 표기 법명

예외:

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

관련 항목:

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