org.xml.sax.ext
클래스 DefaultHandler2

java.lang.Object 
  org.xml.sax.helpers.DefaultHandler 
      org.xml.sax.ext.DefaultHandler2

모든 구현된 인터페이스:

ContentHandler, DTDHandler, EntityResolver, ErrorHandler, DeclHandler, EntityResolver2, LexicalHandler

public class DefaultHandler2
extends DefaultHandler 
implements LexicalHandler,
 DeclHandler,
 EntityResolver2 

이 클래스는 SAX2 기본이 되는 핸들러 클래스를 확장해 SAX2 LexicalHandler, DeclHandler 및 EntityResolver2 확장을 지원 합니다. 원의 SAX1 resolveEntity() 메서드를 오버라이드(override) 하는 이외는 추가하는 핸들러의 메서드가 돌려주고질 뿐입니다. 사브크라사는 메서드 마다 모든 것을 오버라이드(override) 할 수 있습니다.

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

주: 이 클래스는 「ContentHandler.setDocumentLocator()」호출에 Locator2 객체가 건네받아 또 「ContentHandler.startElement()」호출에 Attributes2 객체가 건네받은 것을 이미 인식하고 있을 가능성이 있습니다.

도입된 버전 :

SAX 2.0 (extensions 1.1 alpha)

생성자 개요

DefaultHandler2 ()
모든 구문 분석 이벤트를 무시하는 핸들러를 구축합니다.

메서드 개요

void	attributeDecl (String eName, String aName, String type, String mode, String value) 속성형 선언을 보고합니다.
void	comment (char[] ch, int start, int length) 문서내의 임의의 위치에 있는 XML 코멘트를 보고합니다.
void	elementDecl (String name, String model) 요소형 선언을 보고합니다.
void	endCDATA () CDATA 섹션의 마지막을 보고합니다.
void	endDTD () DTD 선언의 마지막을 보고합니다.
void	endEntity (String name) 엔티티의 마지막을 보고합니다.
void	externalEntityDecl (String name, String publicId, String systemId) 구문 분석 끝난 외부 엔티티 선언을 보고합니다.
InputSource	getExternalSubset (String name, String baseURI) 외부 부분집합이 문서 텍스트에 선언되지 않았던 경우, 아무것도 사용되지 않는 것을 파서에 통지합니다.
void	internalEntityDecl (String name, String value) 내부 엔티티 선언을 보고합니다.
InputSource	resolveEntity (String publicId, String systemId) EntityResolver2.resolveEntity()를 null 엔티티명과 기저 URI 로 호출합니다.
InputSource	resolveEntity (String name, String publicId, String baseURI, String systemId) 기저 URI에 대해서 systemId를 해석 처리해 결과가 절대 URI가 된 엔티티테키스트를 읽어내도록 파서에 통지합니다.
void	startCDATA () CDATA 섹션의 개시를 보고합니다.
void	startDTD (String name, String publicId, String systemId) DTD 선언이 있는 경우, 그 개시를 보고합니다.
void	startEntity (String name) 내부 및 외부의 XML 엔티티의 일부의 개시를 보고합니다.

클래스 org.xml.sax.helpers. DefaultHandler 로부터 상속된 메서드

characters, endDocument, endElement, endPrefixMapping, error, fatalError, ignorableWhitespace, notationDecl, processingInstruction, setDocumentLocator, skippedEntity, startDocument, startElement, startPrefixMapping, unparsedEntityDecl, warning

클래스 java.lang. Object 로부터 상속된 메서드

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

생성자 상세

DefaultHandler2

public DefaultHandler2()

모든 구문 분석 이벤트를 무시하는 핸들러를 구축합니다.

메서드의 상세

startCDATA

public void startCDATA()
                throws SAXException 

인터페이스 LexicalHandler 기술:

CDATA 섹션의 개시를 보고합니다.

CDATA 섹션의 컨텐츠는 정규의 characters 이벤트를 개입시켜 보고됩니다. 이 이벤트는 경계의 보고인 만큼 사용됩니다.

정의:

인터페이스 LexicalHandler 내의 startCDATA

예외:

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

관련 항목:

LexicalHandler.endCDATA()

endCDATA

public void endCDATA()
              throws SAXException 

인터페이스 LexicalHandler 기술:

CDATA 섹션의 마지막을 보고합니다.

정의:

인터페이스 LexicalHandler 내의 endCDATA

예외:

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

관련 항목:

LexicalHandler.startCDATA()

startDTD

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

인터페이스 LexicalHandler 기술:

DTD 선언이 있는 경우, 그 개시를 보고합니다.

이 메서드는 DOCTYPE 선언의 개시를 보고하는 메서드입니다. 문서에 DOCTYPE 선언이 포함되지 않은 경우는 불려가 지 않습니다.

DTDHandler 또는 DeclHandler 이벤트를 개입시켜 보고되는 모든 선언은 startDTD 이벤트로부터 endDTD 이벤트까지의 사이에 출현하게 되어 있습니다. 선언은, startEntity 이벤트로부터 endEntity 이벤트까지의 사이에 출현하지 않으면 내부 DTD 부분집합에 소속하는 것이라고 보여집니다. DTD 코멘트 및 처리 명령도, startDTD 이벤트로부터 endDTD 이벤트까지의 사이에 원의 (논리적인) 발생순서로 보고되게 되어 있습니다. 다만, DTDHandler 이벤트나 DeclHandler 이벤트에 대한 정확한 상대 위치에 출현할 필요는 없습니다.

start/endDTD 이벤트는 ContentHandler start/endDocument 이벤트내의 최초의 startElement 이벤트의 전에 출현합니다.

정의:

인터페이스 LexicalHandler 내의 startDTD

파라미터:

name - 문서형명

publicId - 선언된 외부 DTD 부분집합의 공개 식별자. 선언되어 있지 않은 경우는 null

systemId - 선언된 외부 DTD 부분집합의 시스템 식별자. 선언되어 있지 않은 경우는 null. 문서의 베이스 URI에 대해서는 해결되지 않는 것에 주의하는 것

예외:

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

관련 항목:

LexicalHandler.endDTD(), LexicalHandler.startEntity(java.lang.String)

endDTD

public void endDTD()
            throws SAXException 

인터페이스 LexicalHandler 기술:

DTD 선언의 마지막을 보고합니다.

이 메서드는 DOCTYPE 선언의 마지막을 보고하는 메서드입니다. 문서에 DOCTYPE 선언이 포함되지 않은 경우는 불려가 지 않습니다.

정의:

인터페이스 LexicalHandler 내의 endDTD

예외:

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

관련 항목:

LexicalHandler.startDTD(java.lang.String, java.lang.String, java.lang.String)

startEntity

public void startEntity(String  name)
                 throws SAXException 

인터페이스 LexicalHandler 기술:

내부 및 외부의 XML 엔티티의 일부의 개시를 보고합니다.

파라메이타엔티티 (외부 DTD 부분집합을 포함한다)의 보고 기능은 옵션입니다. LexicalHandler 이벤트를 보고하는 SAX2 드라이버 속에는 이 기능을 구현하지 않는 것도 있습니다. http://xml.org/sax/features/lexical-handler/parameter-entities 기능을 사용해, 파라메이타엔티티의 보고를 조회 또는 제어할 수 있습니다 .

일반적인 엔티티는 정규명으로 보고됩니다. 파라메이타엔티티명의 전에는 「%」를 붙일 수 있고 있습니다. 외부 DTD 부분집합은 「[dtd]」라고 하는 사 엔티티명을 가지고 있습니다.

SAX2 드라이버가 이러한 이벤트를 제공하고 있을 때는 그 외의 모든 이벤트를 start/end 엔티티이벤트내에 올바르게 상자로 할 필요가 있습니다. DeclHandler 또는 DTDHandler 이벤트를 올바른 순서로 나란해질 수 있을 필요는 없습니다.

스킵 된 엔티티는 ContentHandler 인터페이스의 일부인 skippedEntity 이벤트를 개입시켜 보고됩니다.

SAX가 채용하고 있는 스트리밍 이벤트 모델의 제약에의해 아래의 상황에서는 일부의 엔티티 경계를 보고할 수가 없습니다.

• 속성값에 포함되어 있는 일반적인 엔티티
• 선언에 포함되어 있는 파라메이타엔티티

이것들은 통지 없게 확장됩니다. 원의 엔티티 경계의 위치는 나타나지 않습니다.

문자 참조의 경계 (실제로는 엔티티는 아니다)도 보고되지 않는 점에 주의해 주세요.

모든 start/endEntity 이벤트를 올바르게 상자로 할 필요가 있습니다.

정의:

인터페이스 LexicalHandler 내의 startEntity

파라미터:

name - 엔티티의 이름. 파라메이타엔티티의 경우, 이 이름은 「%」로 시작된다. 외부 DTD 부분집합의 경우, 「[dtd]」로 시작된다

예외:

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

관련 항목:

LexicalHandler.endEntity(java.lang.String), DeclHandler.internalEntityDecl(java.lang.String, java.lang.String), DeclHandler.externalEntityDecl(java.lang.String, java.lang.String, java.lang.String)

endEntity

public void endEntity(String  name)
               throws SAXException 

인터페이스 LexicalHandler 기술:

엔티티의 마지막을 보고합니다.

정의:

인터페이스 LexicalHandler 내의 endEntity

파라미터:

name - 종료하는 엔티티의 이름

예외:

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

관련 항목:

LexicalHandler.startEntity(java.lang.String)

comment

public void comment(char[] ch,
                    int start,
                    int length)
             throws SAXException 

인터페이스 LexicalHandler 기술:

문서내의 임의의 위치에 있는 XML 코멘트를 보고합니다.

이 콜백은 문서 요소의 내외에 존재하는 코멘트 (외부 DTD 부분집합내의 코멘트도 포함한다)에 대해서 사용됩니다. DTD 내의 코멘트는 start/endDTD 이벤트와 start/endEntity 이벤트 (사용되고 있는 경우)의 내부에 올바르게 상자로 할 필요가 있습니다.

정의:

인터페이스 LexicalHandler 내의 comment

파라미터:

ch - 코멘트에 포함되는 문자를 포함하는 배열

start - 배열내의 개시 위치

length - 배열로부터 읽어내지는 문자수

예외:

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

attributeDecl

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

인터페이스 DeclHandler 기술:

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

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

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

정의:

인터페이스 DeclHandler 내의 attributeDecl

파라미터:

eName - 관련 요소명

aName - 속성의 이름

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

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

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

예외:

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

elementDecl

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

인터페이스 DeclHandler 기술:

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

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

정의:

인터페이스 DeclHandler 내의 elementDecl

파라미터:

name - 요소형명

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

예외:

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

externalEntityDecl

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

인터페이스 DeclHandler 기술:

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

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

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

정의:

인터페이스 DeclHandler 내의 externalEntityDecl

파라미터:

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

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

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

예외:

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

관련 항목:

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

internalEntityDecl

public void internalEntityDecl(String  name,
                               String  value)
                        throws SAXException 

인터페이스 DeclHandler 기술:

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

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

정의:

인터페이스 DeclHandler 내의 internalEntityDecl

파라미터:

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

value - 엔티티의 치환 텍스트

예외:

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

관련 항목:

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

getExternalSubset

public InputSource  getExternalSubset(String  name,
                                     String  baseURI)
                              throws SAXException,

                                     IOException 

외부 부분집합이 문서 텍스트에 선언되지 않았던 경우, 아무것도 사용되지 않는 것을 파서에 통지합니다.

정의:

인터페이스 EntityResolver2 내의 getExternalSubset

파라미터:

name - 문서의 루트 요소의 식별. 이용 가능한 DOCTYPE 선언 또는 실제의 루트 요소로부터의 이름

baseURI - 문서의 기저 URI. 외부 서브 텍스트를 선택하는 추가 힌트로서 기능한다. XMLReader에는 InputSource 만이 지정되었기 때문에 null이 아닌 한 항상 절대 URI 이다

반환값:

파서에 의해 사용되는 새로운 외부 부분집합을 기술하는 InputSource 객체. 외부 부분집합이 제공되지 않는 경우는 null이 나타난다

예외:

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

IOException - 새로운 InputStream 나 Reader, 또는 부정한 URL 작성 실패를 나타내고 있을 가능성이 있다

resolveEntity

public InputSource  resolveEntity(String  name,
                                 String  publicId,
                                 String  baseURI,
                                 String  systemId)
                          throws SAXException,

                                 IOException 

기저 URI에 대해서 systemId를 해석 처리해 결과가 절대 URI가 된 엔티티테키스트를 읽어내도록 파서에 통지합니다. 낡은 DefaultHandler.resolveEntity() 는 이 메서드를 호출하기 위해서 오버라이드(override) 되므로 이 메서드는 null 명, 기저 URI 및 이미 절대화 되고 있는 systemId 로 호출할 수 있습니다 .

정의:

인터페이스 EntityResolver2 내의 resolveEntity

파라미터:

name - 해결되는 외부 실체의 식별. 외부 부분집합의 「[dtd]」나 파라미터 실체를 나타내는 「%」로 개시되는 이름, 또는 그 이외의 일반 실체의 이름. SAX2 파서에 의해 호출되는 경우는 null이 아닌

publicId - 참조되는 외부 실체의 공개 식별자 (XML 사양으로 요구되도록 정규화되고 있다). 제공되지 않았던 경우는 null

baseURI - 상대적인 systemID를 기준으로 한 URI 해석. XMLReader는 InputSource 로 지정된 가능성이 있으므로 null이 아닌 한 항상 절대 URI. 이 URI는 관련된 선언을 개시하는 「<」에 관련된 XML 사양에 의해 정의되는

systemId - 참조되는 외부 실체의 시스템 식별자. 상대 또는 절대 URI. SAX2 파서에 의해 호출되는 경우는 null은 아니고, 선언된 실체와 외부 부분집합만이, 그러한 파서에 의해 해결된다

반환값:

파서에 의해 사용되는 새로운 입력 소스를 기술하는 InputSource 객체. null을 돌려주는 것에의해 기저 URI에 대한 시스템 ID를 해결해, 결과적으로 얻을 수 있는 URI에 연결하도록 파서에 지시한다

예외:

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

IOException - 새로운 InputStream 나 Reader, 또는 부정한 URL 작성 실패를 나타내고 있을 가능성이 있다

resolveEntity

public InputSource  resolveEntity(String  publicId,
                                 String  systemId)
                          throws SAXException,

                                 IOException 

EntityResolver2.resolveEntity()를 null 엔티티명과 기저 URI 로 호출합니다. 이 클래스를 사용하는 메서드만을 오버라이드(override) 할 필요가 있습니다.

정의:

인터페이스 EntityResolver 내의 resolveEntity

오버라이드(override):

클래스 DefaultHandler 내의 resolveEntity

파라미터:

publicId - 공개 식별자. 사용할 수 없는 경우는 null

systemId - XML 문서에 포함되어 있는 시스템 식별자

반환값:

새로운 입력 소스. 디폴트의 동작이 필요한 경우는 null

예외:

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

IOException - Java 고유의 입출력 예외. 보통, InputSource 새로운 InputStream 또는 Reader가 생성되면 발생하는

관련 항목:

EntityResolver.resolveEntity(java.lang.String, java.lang.String)