org.xml.sax.helpers
클래스 XMLFilterImpl

java.lang.Object 
  org.xml.sax.helpers.XMLFilterImpl

모든 구현된 인터페이스:

ContentHandler, DTDHandler, EntityResolver, ErrorHandler, XMLFilter, XMLReader

public class XMLFilterImpl
extends Object 
implements XMLFilter,
 EntityResolver,
 DTDHandler,
 ContentHandler,
 ErrorHandler 

XML 필터를 파생하는 base class입니다.

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

이 클래스는 XMLReader 와 클라이언트 어플리케이션의 이벤트 핸들러의 중간에 놓여집니다. 디폴트에서는 핸들러에 대한 이벤트를 변경하지 않고 요구를 리더에게 건네줄 뿐입니다. 그러나, 서브 클래스에서는 특정의 메서드를 오버라이드(override) 해, 전송중에 이벤트스크리무나 구성 요구를 변경할 수 있습니다.

도입된 버전 :

SAX 2.0

관련 항목:

XMLFilter, XMLReader, EntityResolver, DTDHandler, ContentHandler, ErrorHandler

생성자 개요

XMLFilterImpl ()
부모를 가지지 않는 비어있는 XML 필터를 구축합니다.

XMLFilterImpl (XMLReader parent)
지정된 부모를 가지는 XML 필터를 구축합니다.

메서드 개요

void	characters (char[] ch, int start, int length) 문자 데이터 이벤트를 필터링 합니다.
void	endDocument () 문서 종료 이벤트를 필터링 합니다.
void	endElement (String uri, String localName, String qName) 요소 종료 이벤트를 필터링 합니다.
void	endPrefixMapping (String prefix) 이름 공간 접두사 매핑의 종료 이벤트를 필터링 합니다.
void	error (SAXParseException e) 에러 이벤트를 필터링 합니다.
void	fatalError (SAXParseException e) 치명적인 에러 이벤트를 필터링 합니다.
ContentHandler	getContentHandler () 컨텐츠 이벤트 핸들러를 취득합니다.
DTDHandler	getDTDHandler () 현재의 DTD 이벤트 핸들러를 취득합니다.
EntityResolver	getEntityResolver () 현재의 엔티티리조르바를 취득합니다.
ErrorHandler	getErrorHandler () 현재의 에러 이벤트 핸들러를 취득합니다.
boolean	getFeature (String name) 기능의 값을 검색합니다.
XMLReader	getParent () 친리더를 취득합니다.
Object	getProperty (String name) 프로퍼티치를 검색합니다.
void	ignorableWhitespace (char[] ch, int start, int length) 무시할 수 있는 공백류 문자 이벤트를 필터링 합니다.
void	notationDecl (String name, String publicId, String systemId) 표기법선언 이벤트를 필터링 합니다.
void	parse (InputSource input) 문서를 구문 분석 합니다.
void	parse (String systemId) 문서를 구문 분석 합니다.
void	processingInstruction (String target, String data) 처리 명령 이벤트를 필터링 합니다.
InputSource	resolveEntity (String publicId, String systemId) 외부 엔티티 해결을 파이르타링 합니다.
void	setContentHandler (ContentHandler handler) 컨텐츠 이벤트 핸들러를 설정합니다.
void	setDocumentLocator (Locator locator) 새로운 문서 locator 이벤트를 필터링 합니다.
void	setDTDHandler (DTDHandler handler) DTD 이벤트 핸들러를 설정합니다.
void	setEntityResolver (EntityResolver resolver) 엔티티리조르바를 설정합니다.
void	setErrorHandler (ErrorHandler handler) 에러 이벤트 핸들러를 설정합니다.
void	setFeature (String name, boolean value) 기능의 값을 설정합니다.
void	setParent (XMLReader parent) 친리더를 설정합니다.
void	setProperty (String name, Object value) 프로퍼티치를 설정합니다.
void	skippedEntity (String name) 스킵 된 엔티티이벤트를 필터링 합니다.
void	startDocument () 문서 개시 이벤트를 필터링 합니다.
void	startElement (String uri, String localName, String qName, Attributes atts) 요소 개시 이벤트를 필터링 합니다.
void	startPrefixMapping (String prefix, String uri) 이름 공간 접두사 매핑의 개시 이벤트를 필터링 합니다.
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

생성자 상세

XMLFilterImpl

public XMLFilterImpl()

부모를 가지지 않는 비어있는 XML 필터를 구축합니다.

이 필터는 부모를 가지지 않습니다. 이 필터를 XMLReader 로서가 아니고 순수한 이벤트 컨슈머(consumer)로서 사용하지 않는 한, 구문 분석을 시작하기 전, 혹은 setFeature 또는 setProperty를 사용해 구성을 시작하기 전에 부모를 할당할 필요가 있습니다.

관련 항목:

XMLReader.setFeature(java.lang.String, boolean), XMLReader.setProperty(java.lang.String, java.lang.Object), setParent(org.xml.sax.XMLReader)

XMLFilterImpl

public XMLFilterImpl(XMLReader  parent)

지정된 부모를 가지는 XML 필터를 구축합니다.

관련 항목:

setParent(org.xml.sax.XMLReader), getParent()

메서드의 상세

setParent

public void setParent(XMLReader  parent)

친리더를 설정합니다.

친리더는 이 필터가 이벤트를 취득해, 구성 요구를 건네주는 XMLReader 그 자체입니다. 친리더로서 다른 필터를 지정할 수도 있습니다.

친리더가 설정되어 있지 않으면 구문 분석, 기능 또는 프로퍼티의 설정이나 취득에 실패합니다.

정의:

인터페이스 XMLFilter 내의 setParent

파라미터:

parent - 친 XML 리더

관련 항목:

getParent()

getParent

public XMLReader  getParent()

친리더를 취득합니다.

정의:

인터페이스 XMLFilter 내의 getParent

반환값:

친 XML 리더. 설정되어 있지 않은 경우는 null

관련 항목:

setParent(org.xml.sax.XMLReader)

setFeature

public void setFeature(String  name,
                       boolean value)
                throws SAXNotRecognizedException,

                       SAXNotSupportedException 

기능의 값을 설정합니다.

부모가 null인 경우는 항상 실패합니다.

정의:

인터페이스 XMLReader 내의 setFeature

파라미터:

name - 기능명

value - 요구된 기능의 값

예외:

SAXNotRecognizedException - 기능치를 할당할 수 없는 혹은 부모로부터 취득할 수 없는 경우

SAXNotSupportedException - 부모가 기능명을 인식하는 것만으로 요구된 값을 설정할 수 없는 경우

관련 항목:

XMLReader.getFeature(java.lang.String)

getFeature

public boolean getFeature(String  name)
                   throws SAXNotRecognizedException,

                          SAXNotSupportedException 

기능의 값을 검색합니다.

부모가 null인 경우는 항상 실패합니다.

정의:

인터페이스 XMLReader 내의 getFeature

파라미터:

name - 기능명

반환값:

기능의 현재의 값

예외:

SAXNotRecognizedException - 기능치를 할당할 수 없는 혹은 부모로부터 취득할 수 없는 경우

SAXNotSupportedException - 부모가 기능명을 인식하는 것만으로 현시점에서는 그 값을 판단할 수 없는 경우

관련 항목:

XMLReader.setFeature(java.lang.String, boolean)

setProperty

public void setProperty(String  name,
                        Object  value)
                 throws SAXNotRecognizedException,

                        SAXNotSupportedException 

프로퍼티치를 설정합니다.

부모가 null인 경우는 항상 실패합니다.

정의:

인터페이스 XMLReader 내의 setProperty

파라미터:

name - 프로퍼티명

value - 요구된 프로퍼티치

예외:

SAXNotRecognizedException - 프로퍼티치를 할당할 수 없는 혹은 부모로부터 취득할 수 없는 경우

SAXNotSupportedException - 부모가 프로퍼티명을 인식하는 것만으로 요구된 값을 설정할 수 없는 경우

getProperty

public Object  getProperty(String  name)
                   throws SAXNotRecognizedException,

                          SAXNotSupportedException 

프로퍼티치를 검색합니다.

정의:

인터페이스 XMLReader 내의 getProperty

파라미터:

name - 프로퍼티명

반환값:

현재의 프로퍼티치

예외:

SAXNotRecognizedException - 프로퍼티치를 할당할 수 없는 혹은 부모로부터 취득할 수 없는 경우

SAXNotSupportedException - 부모가 프로퍼티명을 인식하는 것만으로 현시점에서는 그 값을 판단할 수 없는 경우

관련 항목:

XMLReader.setProperty(java.lang.String, java.lang.Object)

setEntityResolver

public void setEntityResolver(EntityResolver  resolver)

엔티티리조르바를 설정합니다.

정의:

인터페이스 XMLReader 내의 setEntityResolver

파라미터:

resolver - 새로운 엔티티리조르바

관련 항목:

XMLReader.getEntityResolver()

getEntityResolver

public EntityResolver  getEntityResolver()

현재의 엔티티리조르바를 취득합니다.

정의:

인터페이스 XMLReader 내의 getEntityResolver

반환값:

현재의 엔티티리조르바. 설정되어 있지 않은 경우는 null

관련 항목:

XMLReader.setEntityResolver(org.xml.sax.EntityResolver)

setDTDHandler

public void setDTDHandler(DTDHandler  handler)

DTD 이벤트 핸들러를 설정합니다.

정의:

인터페이스 XMLReader 내의 setDTDHandler

파라미터:

handler - 새로운 DTD 핸들러

관련 항목:

XMLReader.getDTDHandler()

getDTDHandler

public DTDHandler  getDTDHandler()

현재의 DTD 이벤트 핸들러를 취득합니다.

정의:

인터페이스 XMLReader 내의 getDTDHandler

반환값:

현재의 DTD 핸들러. 설정되어 있지 않은 경우는 null

관련 항목:

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

setContentHandler

public void setContentHandler(ContentHandler  handler)

컨텐츠 이벤트 핸들러를 설정합니다.

정의:

인터페이스 XMLReader 내의 setContentHandler

파라미터:

handler - 새로운 컨텐츠 핸들러

관련 항목:

XMLReader.getContentHandler()

getContentHandler

public ContentHandler  getContentHandler()

컨텐츠 이벤트 핸들러를 취득합니다.

정의:

인터페이스 XMLReader 내의 getContentHandler

반환값:

현재의 컨텐츠 핸들러. 설정되어 있지 않은 경우는 null

관련 항목:

XMLReader.setContentHandler(org.xml.sax.ContentHandler)

setErrorHandler

public void setErrorHandler(ErrorHandler  handler)

에러 이벤트 핸들러를 설정합니다.

정의:

인터페이스 XMLReader 내의 setErrorHandler

파라미터:

handler - 새로운 에러 핸들러

관련 항목:

XMLReader.getErrorHandler()

getErrorHandler

public ErrorHandler  getErrorHandler()

현재의 에러 이벤트 핸들러를 취득합니다.

정의:

인터페이스 XMLReader 내의 getErrorHandler

반환값:

현재의 에러 핸들러. 설정되어 있지 않은 경우는 null

관련 항목:

XMLReader.setErrorHandler(org.xml.sax.ErrorHandler)

parse

public void parse(InputSource  input)
           throws SAXException,

                  IOException 

문서를 구문 분석 합니다.

정의:

인터페이스 XMLReader 내의 parse

파라미터:

input - 문서 엔티티의 입력 소스

예외:

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

IOException - 파서로부터의 IO 예외. 보통, 어플리케이션이 제공하는 바이트 스트림 또는 문자 스트림로부터의 예외

관련 항목:

InputSource, XMLReader.parse(java.lang.String), XMLReader.setEntityResolver(org.xml.sax.EntityResolver), XMLReader.setDTDHandler(org.xml.sax.DTDHandler), XMLReader.setContentHandler(org.xml.sax.ContentHandler), XMLReader.setErrorHandler(org.xml.sax.ErrorHandler)

parse

public void parse(String  systemId)
           throws SAXException,

                  IOException 

문서를 구문 분석 합니다.

정의:

인터페이스 XMLReader 내의 parse

파라미터:

systemId - 시스템 식별자를 나타내는 완전 수식 URI

예외:

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

IOException - 파서로부터의 IO 예외. 보통, 어플리케이션이 제공하는 바이트 스트림 또는 문자 스트림로부터의 예외

관련 항목:

XMLReader.parse(org.xml.sax.InputSource)

resolveEntity

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

                                 IOException 

외부 엔티티 해결을 파이르타링 합니다.

정의:

인터페이스 EntityResolver 내의 resolveEntity

파라미터:

publicId - 엔티티의 공개 식별자 또는 null

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

반환값:

새로운 InputSource. 디폴트의 경우는 null

예외:

SAXException - 처리중에 클라이언트가 예외를 Throw 하는 일이 있다

IOException - 새로운 InputSource 취득중에 클라이언트가 입출력 관련의 예외를 Throw 하는 일이 있는

관련 항목:

InputSource

notationDecl

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

표기법선언 이벤트를 필터링 합니다.

정의:

인터페이스 DTDHandler 내의 notationDecl

파라미터:

name - 표기 법명

publicId - 표기법의 공개 식별자 또는 null

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

예외:

SAXException - 처리중에 클라이언트가 예외를 Throw 하는 일이 있는

관련 항목:

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

unparsedEntityDecl

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

해석 대상외 엔티티 선언 이벤트를 필터링 합니다.

정의:

인터페이스 DTDHandler 내의 unparsedEntityDecl

파라미터:

name - 엔티티명

publicId - 엔티티의 공개 식별자 또는 null

systemId - 엔티티의 시스템 식별자 또는 null

notationName - 관련 표기 법명

예외:

SAXException - 처리중에 클라이언트가 예외를 Throw 하는 일이 있는

관련 항목:

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

setDocumentLocator

public void setDocumentLocator(Locator  locator)

새로운 문서 locator 이벤트를 필터링 합니다.

정의:

인터페이스 ContentHandler 내의 setDocumentLocator

파라미터:

locator - 문서 locator

관련 항목:

Locator

startDocument

public void startDocument()
                   throws SAXException 

문서 개시 이벤트를 필터링 합니다.

정의:

인터페이스 ContentHandler 내의 startDocument

예외:

SAXException - 처리중에 클라이언트가 예외를 Throw 하는 일이 있는

관련 항목:

ContentHandler.endDocument()

endDocument

public void endDocument()
                 throws SAXException 

문서 종료 이벤트를 필터링 합니다.

정의:

인터페이스 ContentHandler 내의 endDocument

예외:

SAXException - 처리중에 클라이언트가 예외를 Throw 하는 일이 있는

관련 항목:

ContentHandler.startDocument()

startPrefixMapping

public void startPrefixMapping(String  prefix,
                               String  uri)
                        throws SAXException 

이름 공간 접두사 매핑의 개시 이벤트를 필터링 합니다.

정의:

인터페이스 ContentHandler 내의 startPrefixMapping

파라미터:

prefix - 이름 공간 접두사

uri - 이름 공간 URI

예외:

SAXException - 처리중에 클라이언트가 예외를 Throw 하는 일이 있는

관련 항목:

ContentHandler.endPrefixMapping(java.lang.String), ContentHandler.startElement(java.lang.String, java.lang.String, java.lang.String, org.xml.sax.Attributes)

endPrefixMapping

public void endPrefixMapping(String  prefix)
                      throws SAXException 

이름 공간 접두사 매핑의 종료 이벤트를 필터링 합니다.

정의:

인터페이스 ContentHandler 내의 endPrefixMapping

파라미터:

prefix - 이름 공간 접두사

예외:

SAXException - 처리중에 클라이언트가 예외를 Throw 하는 일이 있는

관련 항목:

ContentHandler.startPrefixMapping(java.lang.String, java.lang.String), ContentHandler.endElement(java.lang.String, java.lang.String, java.lang.String)

startElement

public void startElement(String  uri,
                         String  localName,
                         String  qName,
                         Attributes  atts)
                  throws SAXException 

요소 개시 이벤트를 필터링 합니다.

정의:

인터페이스 ContentHandler 내의 startElement

파라미터:

uri - 요소의 이름 공간 URI 또는 공문자열

localName - 요소의 로컬명 또는 공문자열

qName - 요소의 접두사 첨부의 수식명 또는 공문자열

atts - 요소의 속성

예외:

SAXException - 처리중에 클라이언트가 예외를 Throw 하는 일이 있는

관련 항목:

ContentHandler.endElement(java.lang.String, java.lang.String, java.lang.String), Attributes, AttributesImpl

endElement

public void endElement(String  uri,
                       String  localName,
                       String  qName)
                throws SAXException 

요소 종료 이벤트를 필터링 합니다.

정의:

인터페이스 ContentHandler 내의 endElement

파라미터:

uri - 요소의 이름 공간 URI 또는 공문자열

localName - 요소의 로컬명 또는 공문자열

qName - 요소의 접두사 첨부의 수식명 또는 공문자열

예외:

SAXException - 처리중에 클라이언트가 예외를 Throw 하는 일이 있다

characters

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

문자 데이터 이벤트를 필터링 합니다.

정의:

인터페이스 ContentHandler 내의 characters

파라미터:

ch - 문자 배열

start - 배열내의 개시 위치

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

예외:

SAXException - 처리중에 클라이언트가 예외를 Throw 하는 일이 있는

관련 항목:

ContentHandler.ignorableWhitespace(char[], int, int), Locator

ignorableWhitespace

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

무시할 수 있는 공백류 문자 이벤트를 필터링 합니다.

정의:

인터페이스 ContentHandler 내의 ignorableWhitespace

파라미터:

ch - 문자 배열

start - 배열내의 개시 위치

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

예외:

SAXException - 처리중에 클라이언트가 예외를 Throw 하는 일이 있는

관련 항목:

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

processingInstruction

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

처리 명령 이벤트를 필터링 합니다.

정의:

인터페이스 ContentHandler 내의 processingInstruction

파라미터:

target - 처리 명령의 타겟

data - 타겟의 텍스트

예외:

SAXException - 처리중에 클라이언트가 예외를 Throw 하는 일이 있다

skippedEntity

public void skippedEntity(String  name)
                   throws SAXException 

스킵 된 엔티티이벤트를 필터링 합니다.

정의:

인터페이스 ContentHandler 내의 skippedEntity

파라미터:

name - 스킵 된 엔티티의 이름

예외:

SAXException - 처리중에 클라이언트가 예외를 Throw 하는 일이 있다

warning

public void warning(SAXParseException  e)
             throws SAXException 

경고 이벤트를 필터링 합니다.

정의:

인터페이스 ErrorHandler 내의 warning

파라미터:

e - 경고를 나타내는 예외

예외:

SAXException - 처리중에 클라이언트가 예외를 Throw 하는 일이 있는

관련 항목:

SAXParseException

error

public void error(SAXParseException  e)
           throws SAXException 

에러 이벤트를 필터링 합니다.

정의:

인터페이스 ErrorHandler 내의 error

파라미터:

e - 에러를 나타내는 예외

예외:

SAXException - 처리중에 클라이언트가 예외를 Throw 하는 일이 있는

관련 항목:

SAXParseException

fatalError

public void fatalError(SAXParseException  e)
                throws SAXException 

치명적인 에러 이벤트를 필터링 합니다.

정의:

인터페이스 ErrorHandler 내의 fatalError

파라미터:

e - 에러를 나타내는 예외

예외:

SAXException - 처리중에 클라이언트가 예외를 Throw 하는 일이 있는

관련 항목:

SAXParseException