org.xml.sax.helpers
클래스 ParserAdapter

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

모든 구현된 인터페이스:

DocumentHandler , XMLReader

public class ParserAdapter
extends Object 
implements XMLReader , DocumentHandler 

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

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

이 클래스는, SAX1 Parser 를 랩 해, 기능, 프로퍼티, 이름 공간을 이용할 수 있는 SAX 2 XMLReader 로서 동작시킵니다. 다만,skippedEntity 이벤트의 보고는 행해지지 않습니다. 이것은, 이 정보가 SAX1 에서는 제공되지 않기 때문입니다.

이름 공간 수식자 첨부의 속성명이 중복 하고 있는 환경에 있어서의 이 어댑터의 동작은 미검증입니다.

도입된 버젼:

SAX 2.0

관련 항목:

XMLReaderAdapter , XMLReader , Parser

생성자 의 개요

ParserAdapter ()
새로운 퍼서 어댑터를 구축합니다.

ParserAdapter (Parser parser)
새로운 퍼서 어댑터를 구축합니다.

메소드의 개요

void	characters (char[] ch, int start, int length) 어댑터 구현 메소드는 호출하지 않습니다.
void	endDocument () 어댑터 구현 메소드는 호출하지 않습니다.
void	endElement (String qName) 어댑터 구현 메소드는 호출하지 않습니다.
ContentHandler	getContentHandler () 현재의 컨텐츠 핸들러를 돌려줍니다.
DTDHandler	getDTDHandler () 현재의 DTD 핸들러를 돌려줍니다.
EntityResolver	getEntityResolver () 현재의 엔티티리조르바를 돌려줍니다.
ErrorHandler	getErrorHandler () 현재의 에러 핸들러를 돌려줍니다.
boolean	getFeature (String name) 퍼서 기능 플래그를 체크합니다.
Object	getProperty (String name) 퍼서 프로퍼티을 가져옵니다.
void	ignorableWhitespace (char[] ch, int start, int length) 어댑터 구현 메소드는 호출하지 않습니다.
void	parse (InputSource input) XML 문서를 구문 분석 합니다.
void	parse (String systemId) XML 문서를 구문 분석 합니다.
void	processingInstruction (String target, String data) 어댑터 구현 메소드는 호출하지 않습니다.
void	setContentHandler (ContentHandler handler) 컨텐츠 핸들러를 설정합니다.
void	setDocumentLocator (Locator locator) 어댑터 구현 메소드는 호출하지 않습니다.
void	setDTDHandler (DTDHandler handler) DTD 핸들러를 설정합니다.
void	setEntityResolver (EntityResolver resolver) 엔티티리조르바를 설정합니다.
void	setErrorHandler (ErrorHandler handler) 에러 핸들러를 설정합니다.
void	setFeature (String name, boolean value) 퍼서의 기능 플래그를 설정합니다.
void	setProperty (String name, Object value) 퍼서 프로퍼티을 설정합니다.
void	startDocument () 어댑터 구현 메소드는 호출하지 않습니다.
void	startElement (String qName, AttributeList qAtts) 어댑터 구현 메소드는 호출하지 않습니다.

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

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

생성자 의 상세

ParserAdapter

public ParserAdapter()
              throws SAXException 

새로운 퍼서 어댑터를 구축합니다.

「org.xml.sax.parser」프로퍼티을 사용해 편입 SAX1 드라이버를 특정합니다.

예외:

SAXException - 편입 드라이버를 인스턴스화할 수 없는 경우, 또는 org.xml.sax.parser 프로퍼티이 지정되어 있지 않다 경우

ParserAdapter

public ParserAdapter(Parser  parser)

새로운 퍼서 어댑터를 구축합니다.

어댑터의 작성 후는, 편입 퍼서를 변경할 수 없습니다. 다른 퍼서를 짜넣으려면 , 새로운 ParserAdapter 를 할당합니다.

파라미터:

parser - 짜넣는 SAX1 퍼서

예외:

NullPointerException - 퍼서 파라미터가 null 의 경우

메소드의 상세

setFeature

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

퍼서의 기능 플래그를 설정합니다.

인식되고 있는 기능은 이름 공간과 이름 공간 접두사만입니다.

정의:

인터페이스 XMLReader 내의 setFeature

파라미터:

name - 기능명을 나타내는 완전한 URI

value - 요구된 기능의 값

예외:

SAXNotRecognizedException - 기능의 값을 할당할 수 없는, 또는 취득할 수 없는 경우

SAXNotSupportedException - 기능을 그 값에 할당할 수 없는 경우

관련 항목:

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

getFeature

public boolean getFeature(String  name)
                   throws SAXNotRecognizedException ,
                          SAXNotSupportedException 

퍼서 기능 플래그를 체크합니다.

인식되고 있는 기능은 이름 공간과 이름 공간 접두사만입니다.

정의:

인터페이스 XMLReader 내의 getFeature

파라미터:

name - 기능명을 나타내는 완전한 URI

반환값:

현재의 기능의 값

예외:

SAXNotRecognizedException - 기능의 값을 할당할 수 없는, 또는 취득할 수 없는 경우

SAXNotSupportedException - 기능이 현재 읽어낼 수 없는 경우

관련 항목:

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

setProperty

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

퍼서 프로퍼티을 설정합니다.

현재 인식되는 프로퍼티은 없습니다.

정의:

인터페이스 XMLReader 내의 setProperty

파라미터:

name - 프로퍼티명

value - 프로퍼티의 값

예외:

SAXNotRecognizedException - 프로퍼티의 값을 할당할 수 없는, 또는 취득할 수 없는 경우

SAXNotSupportedException - 프로퍼티을 그 값에 할당할 수 없는 경우

관련 항목:

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

getProperty

public Object  getProperty(String  name)
                   throws SAXNotRecognizedException ,
                          SAXNotSupportedException 

퍼서 프로퍼티을 가져옵니다.

현재 인식되는 프로퍼티은 없습니다.

정의:

인터페이스 XMLReader 내의 getProperty

파라미터:

name - 프로퍼티명

반환값:

프로퍼티의 값

예외:

SAXNotRecognizedException - 프로퍼티의 값을 할당할 수 없는, 또는 취득할 수 없는 경우

SAXNotSupportedException - 프로퍼티의 값을 현재 읽어낼 수 없는 경우

관련 항목:

XMLReader.getProperty(java.lang.String)

setEntityResolver

public void setEntityResolver(EntityResolver  resolver)

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

정의:

인터페이스 XMLReader 내의 setEntityResolver

파라미터:

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

관련 항목:

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 핸들러

관련 항목:

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

getDTDHandler

public DTDHandler  getDTDHandler()

현재의 DTD 핸들러를 돌려줍니다.

정의:

인터페이스 XMLReader 내의 getDTDHandler

반환값:

현재의 DTD 핸들러. 제공되지 않았던 경우는 null

관련 항목:

XMLReader.getEntityResolver()

setContentHandler

public void setContentHandler(ContentHandler  handler)

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

정의:

인터페이스 XMLReader 내의 setContentHandler

파라미터:

handler - 새로운 컨텐츠 핸들러

관련 항목:

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

getContentHandler

public ContentHandler  getContentHandler()

현재의 컨텐츠 핸들러를 돌려줍니다.

정의:

인터페이스 XMLReader 내의 getContentHandler

반환값:

현재의 컨텐츠 핸들러. 제공되지 않았던 경우는 null

관련 항목:

XMLReader.getEntityResolver()

setErrorHandler

public void setErrorHandler(ErrorHandler  handler)

에러 핸들러를 설정합니다.

정의:

인터페이스 XMLReader 내의 setErrorHandler

파라미터:

handler - 새로운 에러 핸들러

관련 항목:

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

getErrorHandler

public ErrorHandler  getErrorHandler()

현재의 에러 핸들러를 돌려줍니다.

정의:

인터페이스 XMLReader 내의 getErrorHandler

반환값:

현재의 에러 핸들러. 제공되지 않았던 경우는 null

관련 항목:

XMLReader.getEntityResolver()

parse

public void parse(String  systemId)
           throws IOException ,
                  SAXException 

XML 문서를 구문 분석 합니다.

정의:

인터페이스 XMLReader 내의 parse

파라미터:

systemId - 문서의 절대 URL

예외:

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

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

관련 항목:

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

parse

public void parse(InputSource  input)
           throws IOException ,
                  SAXException 

XML 문서를 구문 분석 합니다.

정의:

인터페이스 XMLReader 내의 parse

파라미터:

input - 문서의 입력 소스

예외:

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

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

관련 항목:

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

setDocumentLocator

public void setDocumentLocator(Locator  locator)

어댑터 구현 메소드는 호출하지 않습니다. SAX1 의 문서 locator 이벤트를 적응시킵니다.

정의:

인터페이스 DocumentHandler 내의 setDocumentLocator

파라미터:

locator - 문서 locator

관련 항목:

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

startDocument

public void startDocument()
                   throws SAXException 

어댑터 구현 메소드는 호출하지 않습니다. SAX1 의 문서 개시 이벤트를 적응시킵니다.

정의:

인터페이스 DocumentHandler 내의 startDocument

예외:

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

관련 항목:

DocumentHandler.startDocument()

endDocument

public void endDocument()
                 throws SAXException 

어댑터 구현 메소드는 호출하지 않습니다. SAX1 의 문서 종료 이벤트를 적응시킵니다.

정의:

인터페이스 DocumentHandler 내의 endDocument

예외:

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

관련 항목:

DocumentHandler.endDocument()

startElement

public void startElement(String  qName,
                         AttributeList  qAtts)
                  throws SAXException 

어댑터 구현 메소드는 호출하지 않습니다. SAX1 의 요소 개시 이벤트를 적응시킵니다.

필요에 따라서, 이름 공간 처리를 실시합니다.

정의:

인터페이스 DocumentHandler 내의 startElement

파라미터:

qName - 전치수식자 첨부의 수식명

qAtts - XML 속성 리스트 (수식 명명나무)

예외:

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

관련 항목:

DocumentHandler.endElement(java.lang.String) , AttributeList

endElement

public void endElement(String  qName)
                throws SAXException 

어댑터 구현 메소드는 호출하지 않습니다. SAX1 의 요소 종료 이벤트를 적응시킵니다.

정의:

인터페이스 DocumentHandler 내의 endElement

파라미터:

qName - 전치수식자 첨부의 수식명

예외:

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

관련 항목:

DocumentHandler.endElement(java.lang.String)

characters

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

어댑터 구현 메소드는 호출하지 않습니다. SAX1 의 문자 이벤트를 적응시킵니다.

정의:

인터페이스 DocumentHandler 내의 characters

파라미터:

ch - 문자 배열

start - 배열내의 개시 위치

length - 사용하는 문자수

예외:

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

관련 항목:

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

ignorableWhitespace

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

어댑터 구현 메소드는 호출하지 않습니다. SAX1 의 무시할 수 있는 공백 문자 이벤트를 적응시킵니다.

정의:

인터페이스 DocumentHandler 내의 ignorableWhitespace

파라미터:

ch - 문자 배열

start - 배열내의 개시 위치

length - 사용하는 문자수

예외:

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

관련 항목:

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

processingInstruction

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

어댑터 구현 메소드는 호출하지 않습니다. SAX1 의 처리 명령 이벤트를 적응시킵니다.

정의:

인터페이스 DocumentHandler 내의 processingInstruction

파라미터:

target - 처리 명령의 타겟

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

예외:

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

관련 항목:

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