org.xml.sax.helpers
클래스 XMLReaderAdapter

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

모든 구현된 인터페이스:

ContentHandler, Parser

public class XMLReaderAdapter
extends Object 
implements Parser,
 ContentHandler 

SAX2 XMLReader를 SAX1 Parser 로서 적응시킵니다.

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

이 클래스는 SAX 2 XMLReader를 랩 해, SAX1 Parser 로서 동작시킵니다. XMLReader는 http://xml.org/sax/features/namespace-prefixes 프로퍼티의 값이 true 일 때의 조건을 지원 하고 있을 필요가 있습니다. 지원 하고 있지 않는 경우, 구문 분석에 실패해, SAXException을 발생시킵니다. XMLReader가 http://xml.org/sax/features/namespaces 프로퍼티의 값이 false 일 때의 조건을 지원 하고 있는 경우는 효율을 개선하기 위해서 그것이 사용됩니다.

도입된 버전 :

SAX 2.0

관련 항목:

Parser, XMLReader

생성자 개요

XMLReaderAdapter ()
새로운 어댑터를 작성합니다.

XMLReaderAdapter (XMLReader xmlReader)
새로운 어댑터를 작성합니다.

메서드 개요

void	characters (char[] ch, int start, int length) SAX2 문자 이벤트를 적응시킵니다.
void	endDocument () 문서 이벤트를 종료합니다.
void	endElement (String uri, String localName, String qName) SAX2 요소 종료 이벤트를 적응시킵니다.
void	endPrefixMapping (String prefix) SAX2 접두사의 매핑 종료 이벤트를 적응시킵니다.
void	ignorableWhitespace (char[] ch, int start, int length) SAX2 무시할 수 있는 공백 문자 이벤트를 적응시킵니다.
void	parse (InputSource input) 문서를 구문 분석 합니다.
void	parse (String systemId) 문서를 구문 분석 합니다.
void	processingInstruction (String target, String data) SAX2 처리 명령 이벤트를 적응시킵니다.
void	setDocumentHandler (DocumentHandler handler) SAX1 문서 이벤트 핸들러를 등록합니다.
void	setDocumentLocator (Locator locator) 문서 locator를 설정합니다.
void	setDTDHandler (DTDHandler handler) DTD 이벤트 핸들러를 등록합니다.
void	setEntityResolver (EntityResolver resolver) 엔티티리조르바를 등록합니다.
void	setErrorHandler (ErrorHandler handler) 에러 이벤트 핸들러를 등록합니다.
void	setLocale (Locale locale) 에러 보고를 위한 로케일을 설정합니다.
void	skippedEntity (String name) SAX2 스킵 된 엔티티이벤트를 적응시킵니다.
void	startDocument () 문서 이벤트를 개시합니다.
void	startElement (String uri, String localName, String qName, Attributes atts) SAX2 요소 개시 이벤트를 적응시킵니다.
void	startPrefixMapping (String prefix, String uri) SAX2 접두사의 매핑 개시 이벤트를 적응시킵니다.

클래스 java.lang. Object 로부터 상속된 메서드

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

생성자 상세

XMLReaderAdapter

public XMLReaderAdapter()
                 throws SAXException 

새로운 어댑터를 작성합니다.

「org.xml.sax.driver」프로퍼티를 사용해, 짜넣는 SAX2 드라이버를 특정합니다.

예외:

SAXException - 빌트인 드라이버를 인스턴스화할 수 없는 경우, 또는 org.xml.sax.driver 프로퍼티가 지정되지 않았던 경우

XMLReaderAdapter

public XMLReaderAdapter(XMLReader  xmlReader)

새로운 어댑터를 작성합니다.

SAX2 XMLReader를 감싸는 새로운 어댑터를 작성합니다. 이 어댑터는 XMLReader를 SAX1 Parser 로서 기능시킵니다.

파라미터:

xmlReader -감싸는 SAX2 XMLReader

예외:

NullPointerException - 인수가 null인 경우

메서드의 상세

setLocale

public void setLocale(Locale  locale)
               throws SAXException 

에러 보고를 위한 로케일을 설정합니다.

이 메서드는 SAX2 에서는 지원 되지 않습니다. 이 때문에 항상 예외를 Throw 합니다.

정의:

인터페이스 Parser 내의 setLocale

파라미터:

locale - 에러 보고의 로케일

예외:

SAXException - 오버라이드(override) 되지 않는 경우는 발생되는

관련 항목:

Parser.setLocale(java.util.Locale)

setEntityResolver

public void setEntityResolver(EntityResolver  resolver)

엔티티리조르바를 등록합니다.

정의:

인터페이스 Parser 내의 setEntityResolver

파라미터:

resolver - 새로운 리절버

관련 항목:

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

setDTDHandler

public void setDTDHandler(DTDHandler  handler)

DTD 이벤트 핸들러를 등록합니다.

정의:

인터페이스 Parser 내의 setDTDHandler

파라미터:

handler - 새로운 DTD 이벤트 핸들러

관련 항목:

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

setDocumentHandler

public void setDocumentHandler(DocumentHandler  handler)

SAX1 문서 이벤트 핸들러를 등록합니다.

SAX1 문서 핸들러는 이름 공간을 지원 하지 않습니다.

정의:

인터페이스 Parser 내의 setDocumentHandler

파라미터:

handler - 새로운 SAX1 문서 이벤트 핸들러

관련 항목:

Parser.setDocumentHandler(org.xml.sax.DocumentHandler)

setErrorHandler

public void setErrorHandler(ErrorHandler  handler)

에러 이벤트 핸들러를 등록합니다.

정의:

인터페이스 Parser 내의 setErrorHandler

파라미터:

handler - 새로운 에러 이벤트 핸들러

관련 항목:

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

parse

public void parse(String  systemId)
           throws IOException,

                  SAXException 

문서를 구문 분석 합니다.

빌트인 XMLReader가 http://xml.org/sax/features/namespace-prefixes 프로퍼티를 지원 하지 않는 경우, 이 메서드는 예외를 Throw 합니다.

정의:

인터페이스 Parser 내의 parse

파라미터:

systemId - 문서의 절대 URL

예외:

IOException - 문서의 raw 컨텐츠의 독해시에 문제가 발생했을 경우

SAXException - 문서 처리시에 문제가 발생했을 경우

관련 항목:

parse(org.xml.sax.InputSource), Parser.parse(java.lang.String)

parse

public void parse(InputSource  input)
           throws IOException,

                  SAXException 

문서를 구문 분석 합니다.

빌트인 XMLReader가 http://xml.org/sax/features/namespace-prefixes 프로퍼티를 지원 하지 않는 경우, 이 메서드는 예외를 Throw 합니다.

정의:

인터페이스 Parser 내의 parse

파라미터:

input - 문서의 입력 소스

예외:

IOException - 문서의 raw 컨텐츠의 독해시에 문제가 발생했을 경우

SAXException - 문서 처리시에 문제가 발생했을 경우

관련 항목:

parse(java.lang.String), Parser.parse(org.xml.sax.InputSource)

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)

SAX2 접두사의 매핑 개시 이벤트를 적응시킵니다.

정의:

인터페이스 ContentHandler 내의 startPrefixMapping

파라미터:

prefix - 매핑 되는 접두사

uri - 매핑처의 이름 공간 URI

관련 항목:

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

endPrefixMapping

public void endPrefixMapping(String  prefix)

SAX2 접두사의 매핑 종료 이벤트를 적응시킵니다.

정의:

인터페이스 ContentHandler 내의 endPrefixMapping

파라미터:

prefix - 매핑 되는 접두사

관련 항목:

ContentHandler.endPrefixMapping(java.lang.String)

startElement

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

SAX2 요소 개시 이벤트를 적응시킵니다.

정의:

인터페이스 ContentHandler 내의 startElement

파라미터:

uri - 이름 공간 URI

localName - 이름 공간의 로컬명

qName - 접두사 첨부의 수식명

atts - SAX2 속성

예외:

SAXException - 클라이언트로 처리 예외가 발생할 가능성이 있는

관련 항목:

ContentHandler.endDocument()

endElement

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

SAX2 요소 종료 이벤트를 적응시킵니다.

정의:

인터페이스 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 

SAX2 문자 이벤트를 적응시킵니다.

정의:

인터페이스 ContentHandler 내의 characters

파라미터:

ch - 문자 배열

start - 배열내의 개시 위치

length - 사용하는 문자수

예외:

SAXException - 클라이언트로 처리 예외가 발생할 가능성이 있는

관련 항목:

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

ignorableWhitespace

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

SAX2 무시할 수 있는 공백 문자 이벤트를 적응시킵니다.

정의:

인터페이스 ContentHandler 내의 ignorableWhitespace

파라미터:

ch - 문자 배열

start - 배열내의 개시 위치

length - 사용하는 문자수

예외:

SAXException - 클라이언트로 처리 예외가 발생할 가능성이 있는

관련 항목:

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

processingInstruction

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

SAX2 처리 명령 이벤트를 적응시킵니다.

정의:

인터페이스 ContentHandler 내의 processingInstruction

파라미터:

target - 처리 명령의 타겟

data - 처리 명령을 받는 데이터

예외:

SAXException - 클라이언트로 처리 예외가 발생할 가능성이 있는

관련 항목:

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

skippedEntity

public void skippedEntity(String  name)
                   throws SAXException 

SAX2 스킵 된 엔티티이벤트를 적응시킵니다.

정의:

인터페이스 ContentHandler 내의 skippedEntity

파라미터:

name - 스킵 된 엔티티의 이름

예외:

SAXException - 서브 클래스에 의해 Throw 가능

관련 항목:

ContentHandler.skippedEntity(java.lang.String)