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 로서 적응시킵니다.

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

이 클래스는 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) SAX1 의 캐릭터 이벤트를 적응시킵니다.
void	endDocument () SAX1 의 문서 종료 이벤트를 적응시킵니다.
void	endElement (String qName) SAX1 의 요소 종료 이벤트를 적응시킵니다.
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) SAX1 의 무시할 수 있는 공백 캐릭터 이벤트를 적응시킵니다.
void	parse (InputSource input) XML 문서를 구문 분석 합니다.
void	parse (String systemId) XML 문서를 구문 분석 합니다.
void	processingInstruction (String target, String data) SAX1 의 처리 인스트럭션 이벤트를 적응시킵니다.
void	setContentHandler (ContentHandler handler) 컨텐츠 핸들러를 설정합니다.
void	setDocumentLocator (Locator locator) SAX1 의 문서 locator 이벤트를 적응시킵니다.
void	setDTDHandler (DTDHandler handler) DTD 핸들러를 설정합니다.
void	setEntityResolver (EntityResolver resolver) 엔티티리조르바를 설정합니다.
void	setErrorHandler (ErrorHandler handler) 에러 핸들러를 설정합니다.
void	setFeature (String name, boolean state) 파서의 기능을 설정합니다.
void	setProperty (String name, Object value) 파서 프로퍼티를 설정합니다.
void	startDocument () SAX1 의 문서 개시 이벤트를 적응시킵니다.
void	startElement (String qName, AttributeList qAtts) SAX1 의 요소 개시 이벤트를 적응시킵니다.

클래스 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 state)
                throws SAXNotRecognizedException ,
                       SAXNotSupportedException 

파서의 기능을 설정합니다.

서포트되고 있는 기능은 이름 공간과 이름 공간앞치수식자만입니다.

정의:

인터페이스 XMLReader 내의 setFeature

파라미터:

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

state - 요구된 기능 상태

예외:

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 - 새로운 엔티티리조르바

예외:

NullPointerException - 엔티티리조르바파라메이타가 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 - DTD 핸들러 파라미터가 null 의 경우

관련 항목:

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 - 컨텐츠 핸들러

예외:

NullPointerException - 컨텐츠 핸들러 파라미터가 null 의 경우

관련 항목:

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

getContentHandler

public ContentHandler  getContentHandler()

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

정의:

인터페이스 XMLReader 내의 getContentHandler

반환값:

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

관련 항목:

XMLReader.getEntityResolver()

setErrorHandler

public void setErrorHandler(ErrorHandler  handler)

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

정의:

인터페이스 XMLReader 내의 setErrorHandler

파라미터:

handler - 에러 핸들러

예외:

NullPointerException - 에러 핸들러 파라미터가 null 의 경우

관련 항목:

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 1.0 속성 리스트 (수식 명명나무)

예외:

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

관련 항목:

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)