JavaTM Platform
Standard Ed. 6

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 ()
          부모를 가지지 않는 빈 상태(empty)의 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()
부모를 가지지 않는 빈 상태(empty)의 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

JavaTM Platform
Standard Ed. 6

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.