javax.xml.stream
인터페이스 XMLEventReader

모든 슈퍼 인터페이스:

Iterator

기존의 구현 클래스의 일람:

EventReaderDelegate

public interface XMLEventReader
extends Iterator 

XMLEvent 를 구문 분석하기 위한 최상정도의 인터페이스입니다. 이것을 사용하면(자), 다음에 계속되는 이벤트를 조사해 프로퍼티 인터페이스를 통해서 구성 정보를 돌려줄 수가 있습니다.

도입된 버젼:

1.6

관련 항목:

XMLInputFactory , XMLEventWriter

메소드의 개요

void	close () 이 리더가 관련지을 수 있었던 자원을 모두 해제합니다.
String	getElementText () 텍스트만의 요소의 컨텐츠를 읽어냅니다.
Object	getProperty (String name) 기본이 되는 구현으로부터 기능 또는 프로퍼티의 값을 가져옵니다.
boolean	hasNext () 그 이상 이벤트가 존재할지 어떨지를 조사합니다.
XMLEvent	nextEvent () 다음의 XMLEvent 를 가져옵니다.
XMLEvent	nextTag () START_ELEMENT 또는 END_ELEMENT 에 이를 때까지, 의미가 없는 공백 이벤트를 스킵 합니다.
XMLEvent	peek () 다음의 XMLEvent 를 조사합니다.

인터페이스 java.util. Iterator 로부터 상속된 메소드

next , remove

메소드의 상세

nextEvent

XMLEvent  nextEvent()
                   throws XMLStreamException 

다음의 XMLEvent 를 가져옵니다.

예외:

XMLStreamException - 기본이 되는 XML 에 에러가 발생했을 경우

NoSuchElementException - 반복 처리로 그 이상 요소가 없는 경우

관련 항목:

XMLEvent

hasNext

boolean hasNext()

그 이상 이벤트가 존재할지 어떨지를 조사합니다. 이벤트가 아직 있는 경우는 true, 그렇지 않은 경우는 false 를 돌려줍니다.

정의:

인터페이스 Iterator 내의 hasNext

반환값:

이벤트 리더에게 이벤트가 아직 있는 경우는 true, 그렇지 않은 경우는 false

peek

XMLEvent  peek()
              throws XMLStreamException 

다음의 XMLEvent 를 조사합니다. 다만, 스트림로부터 읽어내는 것은 하지 않습니다. 스트림이 EOF 가 되었을 경우, 또는 다음의 XMLEvent 가 없는 경우는 null 를 돌려줍니다. peek()의 호출은, 다음의 next()의 귀가와 같게 됩니다.

예외:

XMLStreamException

관련 항목:

XMLEvent

getElementText

String  getElementText()
                      throws XMLStreamException 

텍스트만의 요소의 컨텐츠를 읽어냅니다. 전제 조건은, 현재의 이벤트가 START_ELEMENT 인 것입니다. 사후 조건은, 현재의 이벤트가 대응하는 END_ELEMENT 인 것입니다.

예외:

XMLStreamException - 현재의 이벤트가 START_ELEMENT 가 아닌 경우, 또는 텍스트 이외의 요소가 발견되었을 경우

nextTag

XMLEvent  nextTag()
                 throws XMLStreamException 

START_ELEMENT 또는 END_ELEMENT 에 이를 때까지, 의미가 없는 공백 이벤트를 스킵 합니다. 공백 문자 이외에 달했을 경우는, 예외가 throw 됩니다. 이 메소드는 요소만의 컨텐츠를 처리할 경우에 사용하도록(듯이) 합니다. 이것은, DTD 가 발견되지 않는 경우 또는 해석되지 않는 경우는, 무시할 수 있는 공백 문자를 퍼서가 인식할 수 없기 때문입니다.

예외:

XMLStreamException - 공백 문자 이외에 달했을 경우

getProperty

Object  getProperty(String  name)
                   throws IllegalArgumentException 

기본이 되는 구현으로부터 기능 또는 프로퍼티의 값을 가져옵니다.

파라미터:

name - 프로퍼티의 이름

반환값:

프로퍼티의 값

예외:

IllegalArgumentException - 프로퍼티이 지원되어 있지 않은 경우

close

void close()
           throws XMLStreamException 

이 리더가 관련지을 수 있었던 자원을 모두 해제합니다. 이 메소드는 기본이 되는 입력 소스를 닫지 않습니다.

예외:

XMLStreamException - 관련지을 수 있었던 자원의 해제으로 에러가 발생했을 경우