org.xml.sax.HandlerBase
|
JavaTM Platform Standard Ed. 6 |
|||||||||
| 전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
| 개요: 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드 | |||||||||
java.lang.Object
DocumentHandler
인터페이스로 동작합니다. SAX2 에서는, 이 클래스는
DefaultHandler
클래스에서 옮겨놓을 수 있고 있습니다.
public class HandlerBase
핸들러의 디폴트의 base class입니다.
이 모듈은, 원시 코드, 문서 모두 공개 도메인에 놓여져 있습니다. 따라서, 내용에 관한보증은 일절 제공되지 않습니다. 상세한 것에 대하여는,http://www.saxproject.org 를 참조해 주세요.
이 클래스는, EntityResolver, DTDHandler, DocumentHandler, ErrorHandler 의 4 개의 SAX1 인터페이스의 디폴트의 동작을 구현합니다. 이 클래스는 현재 사용되고 있지 않습니다만, 낡은 SAX1 어플리케이션을 지원하기 위해(때문에), SAX2 에 포함할 수 있고 있습니다. SAX2 어플리케이션은, 이 클래스 대신에 DefaultHandler 클래스를 사용할 필요가 있습니다.
어플리케이션의 작성자는, 인터페이스의 일부만을 구현할 필요가 있을 때, 이 클래스를 확장합니다. 퍼서의 작성자는, 어플리케이션 고유의 디폴트 핸들러가 제공되지 않을 때, 이 클래스를 인스턴스화해 디폴트 핸들러를 제공합니다.
이 클래스의 사용은 옵션입니다.
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 |
| 생성자 의 상세 |
|---|
public HandlerBase()
| 메소드의 상세 |
|---|
public InputSource resolveEntity(String publicId,
String systemId)
throws SAXException
항상 null 를 돌려줍니다. 이것은, 퍼서에게 XML 문서내의 시스템 식별자를 사용시키기 (위해)때문에입니다. 이 메소드는 SAX 의 디폴트의 동작을 구현합니다. 어플리케이션의 작성자는, 서브 클래스내에서 이것을 오버라이드(override) 해, 카탈로그 검색이나 URI 리디렉션과 같이 특수한 변환을 실시합니다.
EntityResolver 내의 resolveEntity publicId - 공개 식별자. 사용할 수 없는 경우는
nullsystemId - XML 문서에 포함되어 있는 시스템
식별자
SAXException - SAX 예외.
다른 예외를 랩 하고 있을 가능성이 있는EntityResolver.resolveEntity(java.lang.String, java.lang.String)
public void notationDecl(String name,
String publicId,
String systemId)
디폴트에서는 아무것도 실시하지 않습니다. 문서내에 선언된 표기법을 추적할 필요가 있는 경우, 어플리케이션의 작성자는, 서브 클래스내에서 이 메소드를 오버라이드(override) 합니다.
DTDHandler 내의 notationDecl name - 표기 법명publicId - 표기법의 공개 식별자. 사용할 수 없는 경우는
nullsystemId - 표기법의 시스템 식별자DTDHandler.notationDecl(java.lang.String, java.lang.String, java.lang.String)
public void unparsedEntityDecl(String name,
String publicId,
String systemId,
String notationName)
디폴트에서는 아무것도 실시하지 않습니다. 문서내에 선언된 해석 대상외 엔티티를 추적할 필요가 있는 경우, 어플리케이션의 작성자는, 서브 클래스내에서 이 메소드를 오버라이드(override) 합니다.
DTDHandler 내의 unparsedEntityDecl name - 엔티티명publicId - 엔티티의 공개 식별자. 사용할 수 없는 경우는
nullsystemId - 엔티티의 시스템 식별자notationName - 관련 표기 법명DTDHandler.unparsedEntityDecl(java.lang.String, java.lang.String, java.lang.String, java.lang.String) public void setDocumentLocator(Locator locator)
디폴트에서는 아무것도 실시하지 않습니다. 그 외의 문서 이벤트로 사용하기 위해서 locator를 포함해 둘 필요가 있는 경우, 어플리케이션의 작성자는, 서브 클래스내에서 이 메소드를 오버라이드(override) 합니다.
DocumentHandler 내의 setDocumentLocator locator - 모든 SAX 문서 이벤트의 locatorDocumentHandler.setDocumentLocator(org.xml.sax.Locator) ,
Locator
public void startDocument()
throws SAXException
디폴트에서는 아무것도 실시하지 않습니다. 어플리케이션의 작성자는, 서브 클래스내의 이 메소드를 오버라이드(override) 해, 문서의 선두에서 특수한 액션 (트리의 루트 노드의 할당, 출력 파일의 작성등)을 실행할 수 있습니다.
DocumentHandler 내의 startDocument SAXException - SAX 예외.
다른 예외를 랩 하고 있을 가능성이 있는DocumentHandler.startDocument()
public void endDocument()
throws SAXException
디폴트에서는 아무것도 실시하지 않습니다. 어플리케이션의 작성자는, 서브 클래스내의 이 메소드를 오버라이드(override) 해, 문서의 마지막으로 특수한 액션 (트리의 finalize, 출력 파일의 종료등)을 실행할 수 있습니다.
DocumentHandler 내의 endDocument SAXException - SAX 예외.
다른 예외를 랩 하고 있을 가능성이 있는DocumentHandler.endDocument()
public void startElement(String name,
AttributeList attributes)
throws SAXException
디폴트에서는 아무것도 실시하지 않습니다. 어플리케이션의 작성자는, 서브 클래스내의 이 메소드를 오버라이드(override) 해, 각 요소의 선두에서 특수한 액션 (새로운 트리 노드의 할당, 출력 내용의 파일에의 기입등)을 실행할 수 있습니다. 이름 공간 URI.
DocumentHandler 내의 startElement name - 요소형명attributes - 지정된 속성 또는 디폴트의 속성
SAXException - SAX 예외.
다른 예외를 랩 하고 있을 가능성이 있는DocumentHandler.startElement(java.lang.String, org.xml.sax.AttributeList)
public void endElement(String name)
throws SAXException
디폴트에서는 아무것도 실시하지 않습니다. 어플리케이션의 작성자는, 서브 클래스내의 이 메소드를 오버라이드(override) 해, 각 요소의 마지막으로 특수한 액션 (트리 노드의 finalize, 출력 내용의 파일에의 기입등)을 실행할 수 있습니다.
DocumentHandler 내의 endElement name - 요소의 이름
SAXException - SAX 예외.
다른 예외를 랩 하고 있을 가능성이 있는DocumentHandler.endElement(java.lang.String)
public void characters(char[] ch,
int start,
int length)
throws SAXException
디폴트에서는 아무것도 실시하지 않습니다. 어플리케이션의 작성자는, 이 메소드를 오버라이드(override) 해, 각 문자 데이타체크에 대해서 특수한 액션 (노드 또는 버퍼에의 데이터의 추가, 데이터의 파일에의 출력등)을 실행할 수 있습니다.
DocumentHandler 내의 characters ch - 문자start - 문자 배열내의 개시 위치length - 문자 배열로부터 사용된다
문자수
SAXException - SAX 예외.
다른 예외를 랩 하고 있을 가능성이 있는DocumentHandler.characters(char[], int, int)
public void ignorableWhitespace(char[] ch,
int start,
int length)
throws SAXException
디폴트에서는 아무것도 실시하지 않습니다. 어플리케이션의 작성자는, 이 메소드를 오버라이드(override) 해, 무시할 수 있는 공백 문자의 각 체크에 대해서 특수한 액션 (노드 또는 버퍼에의 데이터의 추가, 데이터의 파일에의 출력등)을 실행할 수 있습니다.
DocumentHandler 내의 ignorableWhitespace ch - 공백 문자start - 문자 배열내의 개시 위치length - 문자 배열로부터 사용된다
문자수
SAXException - SAX 예외.
다른 예외를 랩 하고 있을 가능성이 있는DocumentHandler.ignorableWhitespace(char[], int, int)
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)
public void warning(SAXParseException e)
throws SAXException
디폴트 구현은 아무것도 실행하지 않습니다. 어플리케이션의 작성자는, 서브 클래스내의 이 메소드를 오버라이드(override) 해, 각 경고에 대해서 특수한 액션 (로그 파일에의 메세지의 삽입, 메세지의 콘솔에의 출력등)을 실행할 수 있습니다.
ErrorHandler 내의 warning e - 예외로서 encode 된 경고 정보
SAXException - SAX 예외.
다른 예외를 랩 하고 있을 가능성이 있는ErrorHandler.warning(org.xml.sax.SAXParseException) ,
SAXParseException
public void error(SAXParseException e)
throws SAXException
디폴트 구현은 아무것도 실행하지 않습니다. 어플리케이션의 작성자는, 서브 클래스내의 이 메소드를 오버라이드(override) 해, 각 에러에 대해서 특수한 액션 (로그 파일에의 메세지의 삽입, 메세지의 콘솔에의 출력등)을 실행할 수 있습니다.
ErrorHandler 내의 error e - 예외로서 encode 된 경고 정보
SAXException - SAX 예외.
다른 예외를 랩 하고 있을 가능성이 있는ErrorHandler.warning(org.xml.sax.SAXParseException) ,
SAXParseException
public void fatalError(SAXParseException e)
throws SAXException
디폴트의 구현에서는 SAXParseException 를 throw 합니다. 어플리케이션의 작성자는, 개개의 치명적인 에러에 대해서 특수한 액션을 잡을 (모든 에러를 단일의 보고에 정리하는 등) 필요가 있는 경우, 서브 클래스내의 이 메소드를 오버라이드(override) 할 수 있습니다. 이 메소드가 불려 가면(자), 문서의 신뢰성이 낮아져, 퍼서도 구문 분석 이벤트를 보고하지 않게 되므로, 어플리케이션의 일반적으로 처리는 모두 종료될 필요가 있습니다.
ErrorHandler 내의 fatalError e - 예외로서 encode 된 에러 정보
SAXException - SAX 예외.
다른 예외를 랩 하고 있을 가능성이 있는ErrorHandler.fatalError(org.xml.sax.SAXParseException) ,
SAXParseException
|
JavaTM Platform Standard Ed. 6 |
|||||||||
| 전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
| 개요: 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드 | |||||||||
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.