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입니다.

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

이 클래스는 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 state) 기능 상태를 설정합니다.
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 필터를 구축합니다.

이 필터는 부모를 가지지 않습니다. 구문 분석이나, setFeature 또는 setProperty 를 사용해 구성을 실시하기 전에, 부모를 할당할 필요가 있습니다.

관련 항목:

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

XMLFilterImpl

public XMLFilterImpl(XMLReader  parent)

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

관련 항목:

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

메소드의 상세

setParent

public void setParent(XMLReader  parent)

친리더를 설정합니다.

이 필터는 이 XMLReader 로부터 이벤트를 취득해, 이 XMLReader 에 구성 요구를 건네줍니다. 다른 필터를 부모로 지정할 수도 있습니다.

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

정의:

인터페이스 XMLFilter 내의 setParent

파라미터:

parent - 친 XML 리더

예외:

NullPointerException - 부모가 null 의 경우

관련 항목:

getParent()

getParent

public XMLReader  getParent()

친리더를 취득합니다.

정의:

인터페이스 XMLFilter 내의 getParent

반환값:

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

관련 항목:

setParent(org.xml.sax.XMLReader)

setFeature

public void setFeature(String  name,
                       boolean state)
                throws SAXNotRecognizedException ,
                       SAXNotSupportedException 

기능 상태를 설정합니다.

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

정의:

인터페이스 XMLReader 내의 setFeature

파라미터:

name - 기능명

state - 요구된 기능 상태

예외:

SAXNotRecognizedException - XMLReader 가 기능명을 인식하지 않는 경우

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

관련 항목:

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

getFeature

public boolean getFeature(String  name)
                   throws SAXNotRecognizedException ,
                          SAXNotSupportedException 

기능 상태를 검색합니다.

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

정의:

인터페이스 XMLReader 내의 getFeature

파라미터:

name - 기능명

반환값:

기능의 현재 상태

예외:

SAXNotRecognizedException - XMLReader 가 기능명을 인식하지 않는 경우

SAXNotSupportedException - XMLReader 가 기능명을 인식하는 것만으로, 현시점에서는 그 상태를 판단할 수 없는 경우

관련 항목:

XMLReader.getFeature(java.lang.String)

setProperty

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

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

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

정의:

인터페이스 XMLReader 내의 setProperty

파라미터:

name - 프로퍼티명

예외:

SAXNotRecognizedException - XMLReader 가 프로퍼티명을 인식하지 않는 경우

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

관련 항목:

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

getProperty

public Object  getProperty(String  name)
                   throws SAXNotRecognizedException ,
                          SAXNotSupportedException 

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

정의:

인터페이스 XMLReader 내의 getProperty

파라미터:

name - 프로퍼티명

반환값:

현재의 프로퍼티치

예외:

SAXNotRecognizedException - XMLReader 가 기능명을 인식하지 않는 경우

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

관련 항목:

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

setEntityResolver

public void setEntityResolver(EntityResolver  resolver)

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

정의:

인터페이스 XMLReader 내의 setEntityResolver

파라미터:

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

예외:

NullPointerException - resolver가 null 의 경우

관련 항목:

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

getEntityResolver

public EntityResolver  getEntityResolver()

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

정의:

인터페이스 XMLReader 내의 getEntityResolver

반환값:

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

관련 항목:

XMLReader.getEntityResolver()

setDTDHandler

public void setDTDHandler(DTDHandler  handler)

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

정의:

인터페이스 XMLReader 내의 setDTDHandler

파라미터:

handler - DTD 핸들러

예외:

NullPointerException - 핸들러가 null 의 경우

관련 항목:

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

getDTDHandler

public DTDHandler  getDTDHandler()

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

정의:

인터페이스 XMLReader 내의 getDTDHandler

반환값:

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

관련 항목:

XMLReader.getDTDHandler()

setContentHandler

public void setContentHandler(ContentHandler  handler)

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

정의:

인터페이스 XMLReader 내의 setContentHandler

파라미터:

handler - 컨텐츠 핸들러

예외:

NullPointerException - 핸들러가 null 의 경우

관련 항목:

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

getContentHandler

public ContentHandler  getContentHandler()

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

정의:

인터페이스 XMLReader 내의 getContentHandler

반환값:

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

관련 항목:

XMLReader.getContentHandler()

setErrorHandler

public void setErrorHandler(ErrorHandler  handler)

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

정의:

인터페이스 XMLReader 내의 setErrorHandler

파라미터:

handler - 에러 핸들러

예외:

NullPointerException - 핸들러가 null 의 경우

관련 항목:

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

getErrorHandler

public ErrorHandler  getErrorHandler()

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

정의:

인터페이스 XMLReader 내의 getErrorHandler

반환값:

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

관련 항목:

XMLReader.getErrorHandler()

parse

public void parse(InputSource  input)
           throws SAXException ,
                  IOException 

문서를 구문 분석 합니다.

정의:

인터페이스 XMLReader 내의 parse

파라미터:

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

예외:

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

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

관련 항목:

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

parse

public void parse(String  systemId)
           throws SAXException ,
                  IOException 

문서를 구문 분석 합니다.

정의:

인터페이스 XMLReader 내의 parse

파라미터:

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

예외:

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

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

관련 항목:

XMLReader.parse(java.lang.String)

resolveEntity

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

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

정의:

인터페이스 EntityResolver 내의 resolveEntity

파라미터:

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

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

반환값:

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

예외:

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

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

관련 항목:

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

notationDecl

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

표기법선언 이벤트를 파이르타링 합니다.

정의:

인터페이스 DTDHandler 내의 notationDecl

파라미터:

name - 표기 법명

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

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

예외:

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

관련 항목:

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

unparsedEntityDecl

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

미구문 분석 엔티티 선언 이벤트를 파이르타링 합니다.

정의:

인터페이스 DTDHandler 내의 unparsedEntityDecl

파라미터:

name - 엔티티명

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

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

notationName - 관련 표기 법명

예외:

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

관련 항목:

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

setDocumentLocator

public void setDocumentLocator(Locator  locator)

새로운 문서 locator 이벤트를 파이르타링 합니다.

정의:

인터페이스 ContentHandler 내의 setDocumentLocator

파라미터:

locator - 문서 locator

관련 항목:

ContentHandler.setDocumentLocator(org.xml.sax.Locator)

startDocument

public void startDocument()
                   throws SAXException 

문서 개시 이벤트를 파이르타링 합니다.

정의:

인터페이스 ContentHandler 내의 startDocument

예외:

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

관련 항목:

ContentHandler.startDocument()

endDocument

public void endDocument()
                 throws SAXException 

문서 종료 이벤트를 파이르타링 합니다.

정의:

인터페이스 ContentHandler 내의 endDocument

예외:

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

관련 항목:

ContentHandler.endDocument()

startPrefixMapping

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

이름 공간앞치수식자 매핑의 개시 이벤트를 파이르타링 합니다.

정의:

인터페이스 ContentHandler 내의 startPrefixMapping

파라미터:

prefix - 이름 공간앞치수식자

uri - 이름 공간 URI

예외:

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

관련 항목:

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

endPrefixMapping

public void endPrefixMapping(String  prefix)
                      throws SAXException 

이름 공간앞치수식자 매핑의 종료 이벤트를 파이르타링 합니다.

정의:

인터페이스 ContentHandler 내의 endPrefixMapping

파라미터:

prefix - 이름 공간앞치수식자

예외:

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

관련 항목:

ContentHandler.endPrefixMapping(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 - 처리중에 클라이언트가 예외를 슬로우 하는 일이 있는

관련 항목:

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

endElement

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

요소 종료 이벤트를 파이르타링 합니다.

정의:

인터페이스 ContentHandler 내의 endElement

파라미터:

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

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

qName - 요소의 전치수식자 첨부의 수식명 또는 공문자열

예외:

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

관련 항목:

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

characters

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

캐릭터 데이터 이벤트를 파이르타링 합니다.

정의:

인터페이스 ContentHandler 내의 characters

파라미터:

ch - 캐릭터 배열

start - 배열내의 개시 위치

length - 배열로부터 읽어내지는 캐릭터수

예외:

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

관련 항목:

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

ignorableWhitespace

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

무시할 수 있는 공백 캐릭터 이벤트를 파이르타링 합니다.

정의:

인터페이스 ContentHandler 내의 ignorableWhitespace

파라미터:

ch - 캐릭터 배열

start - 배열내의 개시 위치

length - 배열로부터 읽어내지는 캐릭터수

예외:

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

관련 항목:

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

processingInstruction

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

처리 인스트럭션 이벤트를 파이르타링 합니다.

정의:

인터페이스 ContentHandler 내의 processingInstruction

파라미터:

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

data - 타겟의 텍스트

예외:

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

관련 항목:

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

skippedEntity

public void skippedEntity(String  name)
                   throws SAXException 

스킵 된 엔티티이벤트를 파이르타링 합니다.

정의:

인터페이스 ContentHandler 내의 skippedEntity

파라미터:

name - 스킵 된 엔티티의 이름

예외:

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

관련 항목:

ContentHandler.skippedEntity(java.lang.String)

warning

public void warning(SAXParseException  e)
             throws SAXException 

경고 이벤트를 파이르타링 합니다.

정의:

인터페이스 ErrorHandler 내의 warning

파라미터:

e - 경고를 나타내는 예외

예외:

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

관련 항목:

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

error

public void error(SAXParseException  e)
           throws SAXException 

에러 이벤트를 파이르타링 합니다.

정의:

인터페이스 ErrorHandler 내의 error

파라미터:

e - 에러를 나타내는 예외

예외:

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

관련 항목:

ErrorHandler.error(org.xml.sax.SAXParseException)

fatalError

public void fatalError(SAXParseException  e)
                throws SAXException 

치명적인 에러 이벤트를 파이르타링 합니다.

정의:

인터페이스 ErrorHandler 내의 fatalError

파라미터:

e - 에러를 나타내는 예외

예외:

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

관련 항목:

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