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

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

도입된 버젼:: 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)