org.xml.sax
클래스 HandlerBase

java.lang.Object 
  |
  +--org.xml.sax.HandlerBase

모든 구현 인터페이스:

DocumentHandler , DTDHandler , EntityResolver , ErrorHandler

추천 되고 있지 않습니다. 이 클래스는 비추천의 DocumentHandler 인터페이스로 동작합니다. SAX2 에서는 이 클래스는 DefaultHandler 클래스에서 옮겨놓을 수 있고 있습니다.

public class HandlerBase

extends Object

implements EntityResolver , DTDHandler , DocumentHandler , ErrorHandler

핸들러의 디폴트의 base class입니다.

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

이 클래스는 EntityResolver, DTDHandler, DocumentHandler, ErrorHandler 의 4 개의 SAX1 인터페이스의 디폴트의 동작을 구현합니다. 이 클래스는 현재 사용되고 있지 않습니다만, 낡은 SAX1 어플리케이션을 서포트하기 위해(때문에), SAX2 에 포함할 수 있고 있습니다. SAX2 어플리케이션은 이 클래스 대신에 DefaultHandler 클래스를 사용할 필요가 있습니다.

어플리케이션의 작성자는 인터페이스의 일부만을 구현할 필요가 있을 때, 이 클래스를 확장합니다. 파서의 작성자는 어플리케이션 고유의 디폴트 핸들러가 제공되지 않을 때, 이 클래스를 인스턴스화해 디폴트 핸들러를 제공합니다.

이 클래스의 사용은 옵션입니다.

도입된 버젼:

SAX 1.0

관련 항목:

EntityResolver , DTDHandler , DocumentHandler , ErrorHandler

생성자의 개요

HandlerBase ()
추천 되고 있지 않습니다.

메소드의 개요

void	characters (char[] ch, int start, int length) 추천 되고 있지 않습니다. 요소내의 캐릭터 데이터의 통지를 받습니다.
void	endDocument () 추천 되고 있지 않습니다. 문서의 종료 통지를 받습니다.
void	endElement (String name) 추천 되고 있지 않습니다. 요소의 종료 통지를 받습니다.
void	error (SAXParseException e) 추천 되고 있지 않습니다. 회복 가능한 파서 에러의 통지를 받습니다.
void	fatalError (SAXParseException e) 추천 되고 있지 않습니다. 치명적인 XML 구문 분석 에러를 보고합니다.
void	ignorableWhitespace (char[] ch, int start, int length) 추천 되고 있지 않습니다. 요소 컨텐츠에 포함되는 무시할 수 있는 공백 캐릭터의 통지를 받습니다.
void	notationDecl (String name, String publicId, String systemId) 추천 되고 있지 않습니다. 표기법선언의 통지를 받습니다.
void	processingInstruction (String target, String data) 추천 되고 있지 않습니다. 처리 인스트럭션의 통지를 받습니다.
InputSource	resolveEntity (String publicId, String systemId) 추천 되고 있지 않습니다. 외부 엔티티를 해결합니다.
void	setDocumentLocator (Locator locator) 추천 되고 있지 않습니다. 문서 이벤트의 Locator 오브젝트를 받습니다.
void	startDocument () 추천 되고 있지 않습니다. 문서의 개시 통지를 받습니다.
void	startElement (String name, AttributeList attributes) 추천 되고 있지 않습니다. 요소의 개시 통지를 받습니다.
void	unparsedEntityDecl (String name, String publicId, String systemId, String notationName) 추천 되고 있지 않습니다. 미구문 분석 엔티티 선언의 통지를 받습니다.
void	warning (SAXParseException e) 추천 되고 있지 않습니다. 파서 경고의 통지를 받습니다.

클래스 java.lang. Object 에서 상속받은 메소드

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

생성자의 상세

HandlerBase

public HandlerBase()

추천 되고 있지 않습니다.

메소드의 상세

resolveEntity

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

추천 되고 있지 않습니다.

외부 엔티티를 해결합니다.

항상 null 를 돌려줍니다. 이것은 파서에 XML 문서내의 시스템 식별자를 사용시키기 (위해)때문에입니다. 이 메소드는 SAX 의 디폴트의 동작을 구현합니다. 어플리케이션의 작성자는 서브 클래스내에서 이것을 오버라이드(override) 해, 카탈로그 검색이나 URI 리디렉션과 같이 특수한 변환을 실시합니다.

정의:

인터페이스 EntityResolver 내의 resolveEntity

파라미터:

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

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

반환값:

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

예외:

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

관련 항목:

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

notationDecl

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

추천 되고 있지 않습니다.

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

디폴트에서는 아무것도 실시하지 않습니다. 문서내에 선언된 표기법을 추적할 필요가 있는 경우, 어플리케이션의 작성자는 서브 클래스내에서 이 메소드를 오버라이드(override) 합니다.

정의:

인터페이스 DTDHandler 내의 notationDecl

파라미터:

name - 표기 법명

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

systemId - 표기법의 시스템 식별자

관련 항목:

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

unparsedEntityDecl

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

추천 되고 있지 않습니다.

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

디폴트에서는 아무것도 실시하지 않습니다. 문서내에 선언된 미구문 분석 엔티티를 추적할 필요가 있는 경우, 어플리케이션의 작성자는 서브 클래스내에서 이 메소드를 오버라이드(override) 합니다.

정의:

인터페이스 DTDHandler 내의 unparsedEntityDecl

파라미터:

name - 엔티티명

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

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

notationName - 관련 표기 법명

관련 항목:

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

setDocumentLocator

public void setDocumentLocator(Locator  locator)

추천 되고 있지 않습니다.

문서 이벤트의 Locator 오브젝트를 받습니다.

디폴트에서는 아무것도 실시하지 않습니다. 그 외의 문서 이벤트로 사용하기 위해서 locator를 저장해 둘 필요가 있는 경우, 어플리케이션의 작성자는 서브 클래스내에서 이 메소드를 오버라이드(override) 합니다.

정의:

인터페이스 DocumentHandler 내의 setDocumentLocator

파라미터:

locator - 모든 SAX 문서 이벤트의 locator

관련 항목:

DocumentHandler.setDocumentLocator(org.xml.sax.Locator) , Locator

startDocument

public void startDocument()
                   throws SAXException 

추천 되고 있지 않습니다.

문서의 개시 통지를 받습니다.

디폴트에서는 아무것도 실시하지 않습니다. 어플리케이션의 작성자는 서브 클래스내의 이 메소드를 오버라이드(override) 해, 문서의 마지막으로 특수한 액션 (트리의 루트 노드의 할당, 출력 파일의 작성등)을 실행할 수가 있습니다.

정의:

인터페이스 DocumentHandler 내의 startDocument

예외:

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

관련 항목:

DocumentHandler.startDocument()

endDocument

public void endDocument()
                 throws SAXException 

추천 되고 있지 않습니다.

문서의 종료 통지를 받습니다.

디폴트에서는 아무것도 실시하지 않습니다. 어플리케이션의 작성자는 서브 클래스내의 이 메소드를 오버라이드(override) 해, 문서의 선두에서 특수한 액션 (트리의 파이나라이즈, 출력 파일의 종료등)을 실행할 수가 있습니다.

정의:

인터페이스 DocumentHandler 내의 endDocument

예외:

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

관련 항목:

DocumentHandler.endDocument()

startElement

public void startElement(String  name,
                         AttributeList  attributes)
                  throws SAXException 

추천 되고 있지 않습니다.

요소의 개시 통지를 받습니다.

디폴트에서는 아무것도 실시하지 않습니다. 어플리케이션의 작성자는 서브 클래스내의 이 메소드를 오버라이드(override) 해, 각 요소의 처음에 특수한 액션 (새로운 트리 노드의 할당, 출력 내용의 파일에의 기입등)을 실행할 수가 있습니다.

정의:

인터페이스 DocumentHandler 내의 startElement

파라미터:

name - 요소형명

attributes - 지정된 속성 또는 디폴트의 속성

예외:

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

관련 항목:

DocumentHandler.startElement(java.lang.String, org.xml.sax.AttributeList)

endElement

public void endElement(String  name)
                throws SAXException 

추천 되고 있지 않습니다.

요소의 종료 통지를 받습니다.

디폴트에서는 아무것도 실시하지 않습니다. 어플리케이션의 작성자는 서브 클래스내의 이 메소드를 오버라이드(override) 해, 각 요소의 마지막으로 특수한 액션 (트리 노드의 파이나라이즈, 출력 내용의 파일에의 기입등)을 실행할 수가 있습니다.

정의:

인터페이스 DocumentHandler 내의 endElement

파라미터:

name - 요소형명

예외:

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

관련 항목:

DocumentHandler.endElement(java.lang.String)

characters

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

추천 되고 있지 않습니다.

요소내의 캐릭터 데이터의 통지를 받습니다.

디폴트에서는 아무것도 실시하지 않습니다. 어플리케이션의 작성자는 이 메소드를 오버라이드(override) 해, 각 캐릭터 데이타체크에 대해서 특수한 액션 (노드 또는 버퍼에의 데이터의 추가, 데이터의 파일에의 출력등)을 실행할 수가 있습니다.

정의:

인터페이스 DocumentHandler 내의 characters

파라미터:

ch - 캐릭터

start - 캐릭터 배열내의 개시 위치

length - 캐릭터 배열로부터 사용되는 캐릭터수

예외:

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

관련 항목:

DocumentHandler.characters(char[], int, int)

ignorableWhitespace

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

추천 되고 있지 않습니다.

요소 컨텐츠에 포함되는 무시할 수 있는 공백 캐릭터의 통지를 받습니다.

디폴트에서는 아무것도 실시하지 않습니다. 어플리케이션의 작성자는 이 메소드를 오버라이드(override) 해, 무시할 수 있는 공백 캐릭터의 각 체크에 대해서 특수한 액션 (노드 또는 버퍼에의 데이터의 추가, 데이터의 파일에의 출력등)을 실행할 수가 있습니다.

정의:

인터페이스 DocumentHandler 내의 ignorableWhitespace

파라미터:

ch - 공백 캐릭터

start - 캐릭터 배열내의 개시 위치

length - 캐릭터 배열로부터 사용되는 캐릭터수

예외:

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

관련 항목:

DocumentHandler.ignorableWhitespace(char[], int, int)

processingInstruction

public void processingInstruction(String  target,
                                  String  data)
                           throws SAXException 

추천 되고 있지 않습니다.

처리 인스트럭션의 통지를 받습니다.

디폴트에서는 아무것도 실시하지 않습니다. 어플리케이션의 작성자는 서브 클래스내의 이 메소드를 오버라이드(override) 해, 각 처리 인스트럭션에 대해서 특수한 액션 (상태 변수의 설정, 그 외의 메소드의 호출등)을 실행할 수가 있습니다.

정의:

인터페이스 DocumentHandler 내의 processingInstruction

파라미터:

target - 처리 인스트럭션의 타겟

data - 처리 인스트럭션 데이터. 데이터가 제공되지 않는 경우는 null

예외:

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

관련 항목:

DocumentHandler.processingInstruction(java.lang.String, java.lang.String)

warning

public void warning(SAXParseException  e)
             throws SAXException 

추천 되고 있지 않습니다.

파서 경고의 통지를 받습니다.

디폴트의 구현에서는 아무것도 실시하지 않습니다. 어플리케이션의 작성자는 서브 클래스내의 이 메소드를 오버라이드(override) 해, 각 경고에 대해서 특수한 액션 (로그 파일에의 메세지의 삽입, 메세지의 콘솔에의 출력등)을 실행할 수가 있습니다.

정의:

인터페이스 ErrorHandler 내의 warning

파라미터:

e - 예외로서 encode 된 경고 정보

예외:

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

관련 항목:

ErrorHandler.warning(org.xml.sax.SAXParseException) , SAXParseException

error

public void error(SAXParseException  e)
           throws SAXException 

추천 되고 있지 않습니다.

회복 가능한 파서 에러의 통지를 받습니다.

디폴트의 구현에서는 아무것도 실시하지 않습니다. 어플리케이션의 작성자는 서브 클래스내의 이 메소드를 오버라이드(override) 해, 각 에러에 대해서 특수한 액션 (로그 파일에의 메세지의 삽입, 메세지의 콘솔에의 출력등)을 실행할 수가 있습니다.

정의:

인터페이스 ErrorHandler 내의 error

파라미터:

e - 예외로서 encode 된 경고 정보

예외:

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

관련 항목:

ErrorHandler.warning(org.xml.sax.SAXParseException) , SAXParseException

fatalError

public void fatalError(SAXParseException  e)
                throws SAXException 

추천 되고 있지 않습니다.

치명적인 XML 구문 분석 에러를 보고합니다.

디폴트의 구현에서는 SAXParseException 를 슬로우 합니다. 어플리케이션의 작성자는 개개의 치명적인 에러에 대해서 특수한 액션을 잡을 (모든 에러를 단일의 보고에 정리하는 등) 필요가 있는 경우, 서브 클래스내의 이 메소드를 오버라이드(override) 할 수가 있습니다. 이 메소드가 불려 가면(자), 문서의 신뢰성이 낮아져, 파서도 구문 분석 이벤트를 보고하지 않게 되므로, 어플리케이션의 통상 처리는 모두 종료되지 않으면 안됩니다.

정의:

인터페이스 ErrorHandler 내의 fatalError

파라미터:

e - 예외로서 encode 된 에러 정보

예외:

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

관련 항목:

ErrorHandler.fatalError(org.xml.sax.SAXParseException) , SAXParseException