StreamReaderDelegate (Java Platform SE 6) - xrath.com 에서 번역됨

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스

프레임 있어 프레임 없음

개요: 상자 | 필드 | 생성자 | 메소드

상세: 필드 | 생성자 | 메소드

javax.xml.stream.util
클래스 StreamReaderDelegate

java.lang.Object 
  javax.xml.stream.util.StreamReaderDelegate

모든 구현된 인터페이스:: XMLStreamConstants , XMLStreamReader

public class StreamReaderDelegate
extends Object
implements XMLStreamReader
extends Object
implements XMLStreamReader

이것은, XMLStreamReader 필터를 파생시키는 base class입니다. 이 클래스는, XMLStreamReader 와 어플리케이션의 XMLStreamReader 의 중간에 놓여집니다. 디폴트에서는, 각 메소드는 아무것도 하지 않습니다만, 친인터페이스상의 대응하는 메소드를 호출합니다.

도입된 버젼:: 1.6
관련 항목:: XMLStreamReader , EventReaderDelegate

필드의 개요

인터페이스 javax.xml.stream. XMLStreamConstants 로부터 상속된 필드
`ATTRIBUTE , CDATA , CHARACTERS , COMMENT , DTD , END_DOCUMENT , END_ELEMENT , ENTITY_DECLARATION , ENTITY_REFERENCE , NAMESPACE , NOTATION_DECLARATION , PROCESSING_INSTRUCTION , SPACE , START_DOCUMENT , START_ELEMENT`

생성자 의 개요
`StreamReaderDelegate ()` 부모를 가지지 않는 빈 상태(empty)의 필터를 구축합니다.
`StreamReaderDelegate (XMLStreamReader reader)` 지정된 부모를 가지는 필터를 구축합니다.

메소드의 개요
`void`	`close ()` 이 리더가 관련지을 수 있었던 자원을 모두 해제합니다.
`int`	`getAttributeCount ()` 이 START_ELEMENT 상의 속성의 수를 돌려줍니다.
`String`	`getAttributeLocalName (int index)` 지정된 인덱스에 있는 속성의 localName 를 돌려줍니다.
`QName`	`getAttributeName (int index)` 지정된 인덱스에 있는 속성의 qname 를 돌려줍니다.
`String`	`getAttributeNamespace (int index)` 지정된 인덱스에 있는 속성의 이름 공간을 돌려줍니다.
`String`	`getAttributePrefix (int index)` 지정된 인덱스에 있는 속성의 접두사를 돌려줍니다.
`String`	`getAttributeType (int index)` 지정된 인덱스에 있는 속성의 XML 형을 돌려줍니다.
`String`	`getAttributeValue (int index)` 인덱스에 있는 속성의 값을 돌려줍니다.
`String`	`getAttributeValue (String namespaceUri, String localName)` 이름 공간과 localName 를 가지는 속성의 정규화된 속성치를 돌려줍니다.
`String`	`getCharacterEncodingScheme ()` XML 선언으로 선언된 문자 인코딩을 돌려줍니다.
`String`	`getElementText ()` 텍스트만의 요소의 컨텐츠를 읽어냅니다.
`String`	`getEncoding ()` 입력 인코딩이 기존의 경우는, 그 입력 인코딩을 돌려줍니다.
`int`	`getEventType ()` 커서가 포인트 하고 있는 이벤트의 형태를 나타내는 정수형 코드를 돌려줍니다.
`String`	`getLocalName ()` 현재의 이벤트의 로컬명을 돌려줍니다.
`Location`	`getLocation ()` 프로세서의 현재의 위치를 돌려줍니다.
`QName`	`getName ()` 현재의 START_ELEMENT 또는 END_ELEMENT 이벤트의 QName 를 돌려줍니다.
`NamespaceContext`	`getNamespaceContext ()` 현재의 위치의 읽기 전용의 이름 공간 문맥을 돌려줍니다.
`int`	`getNamespaceCount ()` 이 START_ELEMENT 또는 END_ELEMENT 로 선언된 이름 공간의 수를 돌려줍니다.
`String`	`getNamespacePrefix (int index)` 지정된 인덱스로 선언된 이름 공간의 접두사를 돌려줍니다.
`String`	`getNamespaceURI ()` 현재의 이벤트가 START_ELEMENT 또는 END_ELEMENT 인 경우, 이 메소드는 접두사의 URI 또는 디폴트의 이름 공간을 돌려줍니다.
`String`	`getNamespaceURI (int index)` 지정된 인덱스로 선언된 이름 공간의 URI 를 돌려줍니다.
`String`	`getNamespaceURI (String prefix)` 지정된 접두사의 URI 를 돌려줍니다.
`XMLStreamReader`	`getParent ()` 이 인스턴스의 부모를 가져옵니다.
`String`	`getPIData ()` 처리 명령의 데이터 섹션을 가져옵니다.
`String`	`getPITarget ()` 처리 명령의 타겟을 가져옵니다.
`String`	`getPrefix ()` 현재의 이벤트의 접두사를 돌려줍니다.
`Object`	`getProperty (String name)` 기본이 되는 구현으로부터 기능 또는 프로퍼티의 값을 가져옵니다.
`String`	`getText ()` 구문 분석 이벤트의 현재의 값을 캐릭터 라인으로서 돌려줍니다.
`char[]`	`getTextCharacters ()` 이 이벤트로부터의 문자를 포함한 배열을 돌려줍니다.
`int`	`getTextCharacters (int sourceStart, char[] target, int targetStart, int length)` CHARACTERS, SPACE, 또는 CDATA 이벤트에 관련지을 수 있었던 텍스트를 가져옵니다.
`int`	`getTextLength ()` 이 텍스트 이벤트에 대한 텍스트 문자 배열내의 문자 순서의 길이를 돌려줍니다.
`int`	`getTextStart ()` 이 텍스트 이벤트의 최초의 문자가 보존되고 있는 텍스트 문자 배열에의 오프셋(offset)를 돌려줍니다.
`String`	`getVersion ()` XML 선언으로 선언된 XML 버젼을 가져옵니다.
`boolean`	`hasName ()` 현재의 이벤트가 이름 (START_ELEMENT 또는 END_ELEMENT)을 가지는 경우 true, 그렇지 않은 경우 false 를 돌려줍니다.
`boolean`	`hasNext ()` 구문 분석 이벤트가 아직 있는 경우는 true, 그렇지 않은 경우는 false 를 돌려줍니다.
`boolean`	`hasText ()` 현재의 이벤트에 텍스트가 포함되는 경우 true, 그렇지 않은 경우 false 를 돌려줍니다.
`boolean`	`isAttributeSpecified (int index)` 이 속성이 디폴트로 작성되었는지의 여부를 나타내는 boolean 치를 돌려줍니다.
`boolean`	`isCharacters ()` 커서가 문자 데이터 이벤트를 포인트 하고 있는 경우는 true 를 돌려줍니다.
`boolean`	`isEndElement ()` 커서가 종료 태그를 포인트 하고 있는 경우는 true, 그렇지 않은 경우는 false 를 돌려줍니다.
`boolean`	`isStandalone ()` XML 선언으로부터 스탠드얼론 선언을 가져옵니다.
`boolean`	`isStartElement ()` 커서가 개시 태그를 포인트 하고 있는 경우는 true, 그렇지 않은 경우는 false 를 돌려줍니다.
`boolean`	`isWhiteSpace ()` 커서가 공백 문자만으로 구성되는 문자 데이터 이벤트를 포인트 하고 있는 경우는 true 를 돌려줍니다.
`int`	`next ()` 다음의 구문 분석 이벤트를 가져옵니다.
`int`	`nextTag ()` START_ELEMENT 또는 END_ELEMENT 에 이를 때까지, 모든 공백 문자 (isWhiteSpace()가 true 를 돌려준다), COMMENT, 또는 PROCESSING_INSTRUCTION 를 스킵 합니다.
`void`	`require (int type, String namespaceURI, String localName)` 현재의 이벤트가 지정의 형태인가 부디 이름 공간과 이름이 현재의 이벤트의 현재의 이름 공간과 이름에 일치할지 어떨지를 테스트합니다.
`void`	`setParent (XMLStreamReader reader)` 이 인스턴스의 부모를 설정합니다.
`boolean`	`standaloneSet ()` 문서로 스탠드얼론이 설정되어 있었는지의 여부를 확인합니다.

클래스 java.lang. Object 로부터 상속된 메소드
`clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait`

생성자 의 상세

StreamReaderDelegate

public StreamReaderDelegate()

부모를 가지지 않는 빈 상태(empty)의 필터를 구축합니다.

StreamReaderDelegate

public StreamReaderDelegate(XMLStreamReader  reader)

지정된 부모를 가지는 필터를 구축합니다.

파라미터:: reader - 부모

메소드의 상세

setParent

public void setParent(XMLStreamReader  reader)

이 인스턴스의 부모를 설정합니다.

파라미터:: reader - 새로운 부모

getParent

public XMLStreamReader  getParent()

이 인스턴스의 부모를 가져옵니다.

반환값:: 부모, 또는 설정되어 있지 않은 경우는 null

public int next()
         throws XMLStreamException

인터페이스 XMLStreamReader 의 기술:

다음의 구문 분석 이벤트를 가져옵니다. 프로세서는, 연속하는 문자 데이터를 모두 단일의 체크로서 또는 몇개의 체크에 분할해 돌려줍니다. javax.xml.stream.isCoalescing 프로퍼티이 true 로 설정되어 있는 경우는, 요소 컨텐츠를 합체 해, 연속하는 요소 컨텐츠 또는 CDATA 섹션에 대해서, CHARACTERS 이벤트가 1 개만 돌려주어지도록 해 주세요. 디폴트에서는, 엔티티 참조는 전개되어 어플리케이션에 투과적으로 보고될 필요가 있습니다. 엔티티 참조를 전개할 수 없는 경우는, 예외가 throw 됩니다. 요소 컨텐츠가 빈 상태(empty) (즉 "")의 경우, CHARACTERS 이벤트는 보고되지 않습니다. 　

다음의 XML 에 대해 생각합니다.
<foo><! --description-->content text<! [CDATA[<greeting>Hello</greeting>]]>other content</foo>
foo 에 대한 next() 호출의 동작은 이하대로입니다.
1- 코멘트 (COMMENT)
2- 문자 섹션 (CHARACTERS)
3- CDATA 섹션 ( 이제(벌써) 1 개의 CHARACTERS)
4- 다음의 문자 섹션 ( 이제(벌써) 1 개의 CHARACTERS)
5- END_ELEMENT
　

주: 공의 요소 (<tag/> 등)는 2 개의 별개의 이벤트인 START_ELEMENT 와 END_ELEMENT 로서 보고됩니다. 이것에 의해, 빈 상태(empty)의 요소의 해석이 <tag></tag> 와 동일하게 유지됩니다. hasNext()가 false 를 돌려주면(자), 이 메소드는 IllegalStateException 를 throw 합니다.

정의:: 인터페이스 XMLStreamReader 내의 next

반환값:: 현재의 구문 분석 이벤트에 대응하는 정수형 코드
예외:: XMLStreamException - 기본이 되는 XML 소스의 처리에 에러가 발생했을 경우
관련 항목:: XMLEvent

nextTag

public int nextTag()
            throws XMLStreamException

인터페이스 XMLStreamReader 의 기술:

START_ELEMENT 또는 END_ELEMENT 에 이를 때까지, 모든 공백 문자 (isWhiteSpace()가 true 를 돌려준다), COMMENT, 또는 PROCESSING_INSTRUCTION 를 스킵 합니다. 공백 문자, COMMENT, PROCESSING_INSTRUCTION, START_ELEMENT, END_ELEMENT 이외가 발견되면(자), 예외가 throw 됩니다. 공백 문자로 단락지어진 요소만의 컨텐츠를 처리할 경우에는, 이 메소드를 사용하도록(듯이) 합니다.
전제 조건은 없습니다.
사후 조건은, 현재의 이벤트가 START_ELEMENT 또는 END_ELEMENT 이며, 커서가 몇개의 공백 문자 이벤트 위를 움직였을 경우입니다.
기본적으로, 다음의 처리를 실행합니다 (구현에서는 최적화할 수도 있습니다만, 동등의 처리를 실행할 필요가 있습니다).

 int eventType = next();
 while((eventType == XMLStreamConstants.CHARACTERS && isWhiteSpace()) // skip whitespace
 || (eventType == XMLStreamConstants.CDATA && isWhiteSpace()) 
 // skip whitespace
 || eventType == XMLStreamConstants.SPACE
 || eventType == XMLStreamConstants.PROCESSING_INSTRUCTION
 || eventType == XMLStreamConstants.COMMENT
 ) {
 eventType = next();
 }
 if (eventType ! = XMLStreamConstants.START_ELEMENT && eventType ! = XMLStreamConstants.END_ELEMENT) {
 throw new String XMLStreamException("expected start or end tag", getLocation());
 }
 return eventType;

정의:: 인터페이스 XMLStreamReader 내의 nextTag

반환값:: 읽어낸 요소의 이벤트형 (START_ELEMENT 또는 END_ELEMENT)
예외:: XMLStreamException - 현재의 이벤트가 공백 문자, PROCESSING_INSTRUCTION, START_ELEMENT, 또는 END_ELEMENT 가 아닌 경우

getElementText

public String  getElementText()
                      throws XMLStreamException

인터페이스 XMLStreamReader 의 기술:

텍스트만의 요소의 컨텐츠를 읽어냅니다. 텍스트만의 요소가 아닌 경우는, 예외가 throw 됩니다. javax.xml.stream.isCoalescing 의 값에 관계없이, 이 메소드는 항상 합체 한 컨텐츠를 돌려줍니다.
전제 조건은, 현재의 이벤트가 START_ELEMENT 인 것입니다.
사후 조건은, 현재의 이벤트가 대응하는 END_ELEMENT 인 것입니다.
메소드는 다음의 처리를 실행합니다 (구현에서는 최적화할 수도 있습니다만, 동등의 처리를 실행할 필요가 있습니다).

 if(getEventType() ! = XMLStreamConstants.START_ELEMENT) {
 throw new XMLStreamException(
 "parser must be on START_ELEMENT to read next text", getLocation());
 }
 int eventType = next();
 StringBuffer content = new StringBuffer();
 while(eventType ! = XMLStreamConstants.END_ELEMENT ) {
 if(eventType == XMLStreamConstants.CHARACTERS
 || eventType == XMLStreamConstants.CDATA
 || eventType == XMLStreamConstants.SPACE
 || eventType == XMLStreamConstants.ENTITY_REFERENCE) {
 buf.append(getText());
 } else if(eventType == XMLStreamConstants.PROCESSING_INSTRUCTION
 || eventType == XMLStreamConstants.COMMENT) {
 // skipping
 } else if(eventType == XMLStreamConstants.END_DOCUMENT) {
 throw new XMLStreamException(
 "unexpected end of document when reading element text content", this);
 } else if(eventType == XMLStreamConstants.START_ELEMENT) {
 throw new XMLStreamException(
 "element text content may not contain START_ELEMENT", getLocation());
 } else {
 throw new XMLStreamException(
 "Unexpected event type "+eventType, getLocation());
 }
 eventType = next();
 }
 return buf.toString();

정의:: 인터페이스 XMLStreamReader 내의 getElementText

반환값:: 텍스트만의 요소의 컨텐츠
예외:: XMLStreamException - 현재의 이벤트가 START_ELEMENT 가 아닌 경우, 또는 텍스트 이외의 요소가 발견되었을 경우

require

public void require(int type,
                    String  namespaceURI,
                    String  localName)
             throws XMLStreamException

인터페이스 XMLStreamReader 의 기술:

현재의 이벤트가 지정의 형태인가 부디 이름 공간과 이름이 현재의 이벤트의 현재의 이름 공간과 이름에 일치할지 어떨지를 테스트합니다. namespaceURI 가 null 의 경우, 이름 공간이 일치할지 어떨지는 확인되지 않습니다. 또, localName 가 null 의 경우, 이름이 일치할지 어떨지는 확인되지 않습니다.

정의:: 인터페이스 XMLStreamReader 내의 require

파라미터:: type - 이벤트의 형태; namespaceURI - 이벤트의 URI (null 의 경우도 있다); localName - 이벤트의 localName (null 의 경우도 있다)
예외:: XMLStreamException - 요구된 값이 일치하지 않았던 경우

hasNext

public boolean hasNext()
                throws XMLStreamException

인터페이스 XMLStreamReader 의 기술:

구문 분석 이벤트가 아직 있는 경우는 true, 그렇지 않은 경우는 false 를 돌려줍니다. 이 메소드는, XMLStreamReader 의 현재 상태가 END_DOCUMENT 의 경우는 false 를 돌려줍니다.

정의:: 인터페이스 XMLStreamReader 내의 hasNext

반환값:: 이벤트가 아직 있는 경우는 true, 그렇지 않은 경우는 false
예외:: XMLStreamException - 다음 상태의 검출시에 치명적인 에러가 발생했을 경우

close

public void close()
           throws XMLStreamException

인터페이스 XMLStreamReader 의 기술:

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

정의:: 인터페이스 XMLStreamReader 내의 close

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

getNamespaceURI

public String  getNamespaceURI(String  prefix)

인터페이스 XMLStreamReader 의 기술:

지정된 접두사의 URI 를 돌려줍니다. 반환되는 URI 는 프로세서의 현재 상태에 따라서 다릅니다. 　

주: 접두사 「xml」는,Namespaces in XML 권고로 정의되고 있도록(듯이) 「http://www.w3.org/XML/1998/namespace」에 바인드 됩니다.

주: 접두사 「xmlns」는 이름 공간 http://www.w3.org/2000/xmlns/ 에 해결될 필요가 있습니다.

정의:: 인터페이스 XMLStreamReader 내의 getNamespaceURI

파라미터:: prefix - 검색하는 접두사 (null 이외)
반환값:: 지정된 접두사에 바인드 된 URI. 바인드되어 있지 않은 경우는 null

getNamespaceContext

public NamespaceContext  getNamespaceContext()

인터페이스 XMLStreamReader 의 기술:

현재의 위치의 읽기 전용의 이름 공간 문맥을 돌려줍니다. 문맥은 일시적인 것으로, next()의 호출에 의해 리더 상태가 변경될 때까지 유효합니다.

정의:: 인터페이스 XMLStreamReader 내의 getNamespaceContext

반환값:: 이름 공간 문맥

isStartElement

public boolean isStartElement()

인터페이스 XMLStreamReader 의 기술:

커서가 개시 태그를 포인트 하고 있는 경우는 true, 그렇지 않은 경우는 false 를 돌려줍니다.

정의:: 인터페이스 XMLStreamReader 내의 isStartElement

반환값:: 커서가 개시 태그를 포인트 하고 있는 경우는 true, 그렇지 않은 경우는 false

isEndElement

public boolean isEndElement()

인터페이스 XMLStreamReader 의 기술:

커서가 종료 태그를 포인트 하고 있는 경우는 true, 그렇지 않은 경우는 false 를 돌려줍니다.

정의:: 인터페이스 XMLStreamReader 내의 isEndElement

반환값:: 커서가 종료 태그를 포인트 하고 있는 경우는 true, 그렇지 않은 경우는 false

isCharacters

public boolean isCharacters()

인터페이스 XMLStreamReader 의 기술:

커서가 문자 데이터 이벤트를 포인트 하고 있는 경우는 true 를 돌려줍니다.

정의:: 인터페이스 XMLStreamReader 내의 isCharacters

반환값:: 커서가 문자 데이터를 포인트 하고 있는 경우는 true, 그렇지 않은 경우는 false

isWhiteSpace

public boolean isWhiteSpace()

인터페이스 XMLStreamReader 의 기술:

커서가 공백 문자만으로 구성되는 문자 데이터 이벤트를 포인트 하고 있는 경우는 true 를 돌려줍니다.

정의:: 인터페이스 XMLStreamReader 내의 isWhiteSpace

반환값:: 커서가 모든 공백 문자를 포인트 하고 있는 경우는 true, 그렇지 않은 경우는 false

getAttributeValue

public String  getAttributeValue(String  namespaceUri,
                                String  localName)

인터페이스 XMLStreamReader 의 기술:

이름 공간과 localName 를 가지는 속성의 정규화된 속성치를 돌려줍니다. namespaceURI 가 null 의 경우, 이름 공간이 일치할지 어떨지는 확인되지 않습니다.

정의:: 인터페이스 XMLStreamReader 내의 getAttributeValue

파라미터:: namespaceUri - 속성의 이름 공간; localName - 속성의 로컬명 (null 이외)
반환값:: 속성의 값. 발견되지 않는 경우는 null

getAttributeCount

public int getAttributeCount()

인터페이스 XMLStreamReader 의 기술:

이 START_ELEMENT 상의 속성의 수를 돌려줍니다. 이 메소드는 START_ELEMENT 또는 ATTRIBUTE 만으로 유효합니다. 이 수에는, 이름 공간의 정의는 포함되지 않습니다. 속성 인덱스는 제로로부터 시작됩니다.

정의:: 인터페이스 XMLStreamReader 내의 getAttributeCount

반환값:: 속성의 수

getAttributeName

public QName  getAttributeName(int index)

인터페이스 XMLStreamReader 의 기술:

지정된 인덱스에 있는 속성의 qname 를 돌려줍니다.

정의:: 인터페이스 XMLStreamReader 내의 getAttributeName

파라미터:: index - 속성의 위치
반환값:: 속성의 QName

getAttributePrefix

public String  getAttributePrefix(int index)

인터페이스 XMLStreamReader 의 기술:

지정된 인덱스에 있는 속성의 접두사를 돌려줍니다.

정의:: 인터페이스 XMLStreamReader 내의 getAttributePrefix

파라미터:: index - 속성의 위치
반환값:: 속성의 접두사

getAttributeNamespace

public String  getAttributeNamespace(int index)

인터페이스 XMLStreamReader 의 기술:

지정된 인덱스에 있는 속성의 이름 공간을 돌려줍니다.

정의:: 인터페이스 XMLStreamReader 내의 getAttributeNamespace

파라미터:: index - 속성의 위치
반환값:: 이름 공간 URI (null 의 경우도 있다)

getAttributeLocalName

public String  getAttributeLocalName(int index)

인터페이스 XMLStreamReader 의 기술:

지정된 인덱스에 있는 속성의 localName 를 돌려줍니다.

정의:: 인터페이스 XMLStreamReader 내의 getAttributeLocalName

파라미터:: index - 속성의 위치
반환값:: 속성의 localName

getAttributeType

public String  getAttributeType(int index)

인터페이스 XMLStreamReader 의 기술:

지정된 인덱스에 있는 속성의 XML 형을 돌려줍니다.

정의:: 인터페이스 XMLStreamReader 내의 getAttributeType

파라미터:: index - 속성의 위치
반환값:: 속성의 XML 형

getAttributeValue

public String  getAttributeValue(int index)

인터페이스 XMLStreamReader 의 기술:

인덱스에 있는 속성의 값을 돌려줍니다.

정의:: 인터페이스 XMLStreamReader 내의 getAttributeValue

파라미터:: index - 속성의 위치
반환값:: 속성치

isAttributeSpecified

public boolean isAttributeSpecified(int index)

인터페이스 XMLStreamReader 의 기술:

이 속성이 디폴트로 작성되었는지의 여부를 나타내는 boolean 치를 돌려줍니다.

정의:: 인터페이스 XMLStreamReader 내의 isAttributeSpecified

파라미터:: index - 속성의 위치
반환값:: 디폴트의 속성인 경우는 true

getNamespaceCount

public int getNamespaceCount()

인터페이스 XMLStreamReader 의 기술:

이 START_ELEMENT 또는 END_ELEMENT 로 선언된 이름 공간의 수를 돌려줍니다. 이 메소드는 START_ELEMENT, END_ELEMENT, 또는 NAMESPACE 만으로 유효합니다. END_ELEMENT 에서는, 범위외가 되려 하고 있는 이름 공간의 수가 됩니다. 이것은, 요소 종료 이벤트의 SAX 콜백에 의해 보고되는 정보와 동등합니다.

정의:: 인터페이스 XMLStreamReader 내의 getNamespaceCount

반환값:: 이 요소상의 이름 공간 선언의 수

getNamespacePrefix

public String  getNamespacePrefix(int index)

인터페이스 XMLStreamReader 의 기술:

지정된 인덱스로 선언된 이름 공간의 접두사를 돌려줍니다. 디폴트의 이름 공간 선언의 경우는 null 를 돌려줍니다.

정의:: 인터페이스 XMLStreamReader 내의 getNamespacePrefix

파라미터:: index - 이름 공간 선언의 위치
반환값:: 이름 공간의 접두사

getNamespaceURI

public String  getNamespaceURI(int index)

인터페이스 XMLStreamReader 의 기술:

지정된 인덱스로 선언된 이름 공간의 URI 를 돌려줍니다.

정의:: 인터페이스 XMLStreamReader 내의 getNamespaceURI

파라미터:: index - 이름 공간 선언의 위치
반환값:: 이름 공간 URI

getEventType

public int getEventType()

인터페이스 XMLStreamReader 의 기술:

커서가 포인트 하고 있는 이벤트의 형태를 나타내는 정수형 코드를 돌려줍니다.

정의:: 인터페이스 XMLStreamReader 내의 getEventType

getText

public String  getText()

인터페이스 XMLStreamReader 의 기술:

구문 분석 이벤트의 현재의 값을 캐릭터 라인으로서 돌려줍니다. CHARACTERS 이벤트의 캐릭터 라인치, COMMENT 의 값, ENTITY_REFERENCE 의 치환치, CDATA 섹션의 캐릭터 라인치, SPACE 이벤트의 캐릭터 라인치, DTD 의 내부 부분집합의 캐릭터 라인치를 돌려줍니다. ENTITY_REFERENCE 가 해결되고 있는 경우, 모든 문자 데이터가 CHARACTERS 이벤트로서 보고됩니다.

정의:: 인터페이스 XMLStreamReader 내의 getText

반환값:: 현재의 텍스트 또는 null

getTextCharacters

public int getTextCharacters(int sourceStart,
                             char[] target,
                             int targetStart,
                             int length)
                      throws XMLStreamException

인터페이스 XMLStreamReader 의 기술:

CHARACTERS, SPACE, 또는 CDATA 이벤트에 관련지을 수 있었던 텍스트를 가져옵니다. sourceStart 로 시작되는 텍스트가, target 의 targetStart 로 시작되는 위치에 카피됩니다. 최대로 length 의 수의 문자가 카피됩니다. 실제로 카피된 문자수가 돌려주어집니다. sourceStart 인수는 0 이상으로, 이벤트에 관련지을 수 있었던 문자수이하인 것이 필요합니다. 일반적으로, sourceStart 가 0 의 위치에서 시작되는 텍스트가 요구됩니다. 실제로 카피된 문자수가 length 보다 적었던 경우, 그 이상의 텍스트는 존재하지 않습니다. 그렇지 않은 경우, 모든 텍스트가 취득될 때까지 후속의 호출이 필요하게 됩니다. 다음에 예를 나타냅니다.

int length = 1024; char[] myBuffer = new char[ length ];
 
for ( int sourceStart = 0 ; ; sourceStart += length ) { int nCopied = stream.getTextCharacters( sourceStart, myBuffer, 0, length );

if (nCopied < length) break; }

기본이 되는 소스로 어떠한 XML 에러가 발생하면(자), XMLStreamException 가 throw 됩니다. targetStart 인수는 0 이상으로, target 의 길이보다 작을 필요가 있어, length 는 0 보다 크고, targetStart 와 length 의 합계는 target 의 길이 이하인 것이 필요합니다.

정의:: 인터페이스 XMLStreamReader 내의 getTextCharacters

파라미터:: sourceStart - 카피 대상 소스 배열내의 최초의 문자의 인덱스; target - 전송처 배열; targetStart - 타겟의 배열내에서의 개시 오프셋(offset); length - 카피하는 문자수
반환값:: 실제로 카피한 문자수
예외:: XMLStreamException - 기본이 되는 XML 소스가 정형식이 아닌 경우

getTextCharacters

public char[] getTextCharacters()

인터페이스 XMLStreamReader 의 기술:

이 이벤트로부터의 문자를 포함한 배열을 돌려줍니다. 이 배열을 읽어내 전용으로 일시적인 것으로 해 처리하도록(듯이) 합니다. 즉, 이 배열에 텍스트 문자가 포함되는 것은, XMLStreamReader 가 다음의 이벤트로 이동할 때까지 입니다. 그 이상의 기간 텍스트를 문자 배열 로 유지하거나 배열의 내용을 변경하거나 하면(자), 이 인터페이스의 규약 위반이 됩니다.

정의:: 인터페이스 XMLStreamReader 내의 getTextCharacters

반환값:: 현재의 텍스트 또는 빈 상태(empty)의 배열

getTextStart

public int getTextStart()

인터페이스 XMLStreamReader 의 기술:

이 텍스트 이벤트의 최초의 문자가 보존되고 있는 텍스트 문자 배열에의 오프셋(offset)를 돌려줍니다.

정의:: 인터페이스 XMLStreamReader 내의 getTextStart

getTextLength

public int getTextLength()

인터페이스 XMLStreamReader 의 기술:

이 텍스트 이벤트에 대한 텍스트 문자 배열내의 문자 순서의 길이를 돌려줍니다.

정의:: 인터페이스 XMLStreamReader 내의 getTextLength

getEncoding

public String  getEncoding()

인터페이스 XMLStreamReader 의 기술:

입력 인코딩이 기존의 경우는, 그 입력 인코딩을 돌려줍니다. 미지의 경우는 null 를 돌려줍니다.

정의:: 인터페이스 XMLStreamReader 내의 getEncoding

반환값:: 이 인스턴스의 인코딩 또는 null

hasText

public boolean hasText()

인터페이스 XMLStreamReader 의 기술:

현재의 이벤트에 텍스트가 포함되는 경우 true, 그렇지 않은 경우 false 를 돌려줍니다. CHARACTERS, DTD, ENTITY_REFERENCE, COMMENT, SPACE 의 각 이벤트에는 텍스트가 포함됩니다.

정의:: 인터페이스 XMLStreamReader 내의 hasText

getLocation

public Location  getLocation()

인터페이스 XMLStreamReader 의 기술:

프로세서의 현재의 위치를 돌려줍니다. Location 를 모르는 경우, 프로세서는 Location 의 구현을 돌려줍니다. 이것은, 위치에 도착해 -1 를 돌려주어, publicId 와 systemId 에 대해 null 를 돌려줍니다. 위치 정보는, next()가 불려 갈 때까지 유효합니다.

정의:: 인터페이스 XMLStreamReader 내의 getLocation

getName

public QName  getName()

인터페이스 XMLStreamReader 의 기술:

현재의 START_ELEMENT 또는 END_ELEMENT 이벤트의 QName 를 돌려줍니다.

정의:: 인터페이스 XMLStreamReader 내의 getName

반환값:: 현재의 START_ELEMENT 또는 END_ELEMENT 이벤트의 QName

getLocalName

public String  getLocalName()

인터페이스 XMLStreamReader 의 기술:

현재의 이벤트의 로컬명을 돌려줍니다. START_ELEMENT 또는 END_ELEMENT 에 대해서는, 현재의 요소의 로컬명을 돌려줍니다. ENTITY_REFERENCE 에 대해서는, 엔티티명을 돌려줍니다. 현재의 이벤트는, START_ELEMENT, END_ELEMENT, ENTITY_REFERENCE 의 언젠가가 아니면 안됩니다.

정의:: 인터페이스 XMLStreamReader 내의 getLocalName

반환값:: localName

hasName

public boolean hasName()

인터페이스 XMLStreamReader 의 기술:

현재의 이벤트가 이름 (START_ELEMENT 또는 END_ELEMENT)을 가지는 경우 true, 그렇지 않은 경우 false 를 돌려줍니다.

정의:: 인터페이스 XMLStreamReader 내의 hasName

getNamespaceURI

public String  getNamespaceURI()

인터페이스 XMLStreamReader 의 기술:

현재의 이벤트가 START_ELEMENT 또는 END_ELEMENT 인 경우, 이 메소드는 접두사의 URI 또는 디폴트의 이름 공간을 돌려줍니다. 이벤트가 접두사를 가지지 않는 경우, null 를 돌려줍니다.

정의:: 인터페이스 XMLStreamReader 내의 getNamespaceURI

반환값:: 이 요소의 접두사에 바인드 된 URI, 디폴트의 이름 공간, 또는 null

getPrefix

public String  getPrefix()

인터페이스 XMLStreamReader 의 기술:

현재의 이벤트의 접두사를 돌려줍니다. 이벤트가 접두사를 가지지 않는 경우는 null 를 돌려줍니다.

정의:: 인터페이스 XMLStreamReader 내의 getPrefix

반환값:: 접두사 또는 null

getVersion

public String  getVersion()

인터페이스 XMLStreamReader 의 기술:

XML 선언으로 선언된 XML 버젼을 가져옵니다. 선언되어 있지 않은 경우는 null 를 돌려줍니다.

정의:: 인터페이스 XMLStreamReader 내의 getVersion

반환값:: XML 버젼 또는 null

isStandalone

public boolean isStandalone()

인터페이스 XMLStreamReader 의 기술:

XML 선언으로부터 스탠드얼론 선언을 가져옵니다.

정의:: 인터페이스 XMLStreamReader 내의 isStandalone

반환값:: 스탠드얼론인 경우는 true, 그렇지 않은 경우는 false

standaloneSet

public boolean standaloneSet()

인터페이스 XMLStreamReader 의 기술:

문서로 스탠드얼론이 설정되어 있었는지의 여부를 확인합니다.

정의:: 인터페이스 XMLStreamReader 내의 standaloneSet

반환값:: 문서로 스탠드얼론이 설정되어 있었을 경우는 true, 그렇지 않은 경우는 false

getCharacterEncodingScheme

public String  getCharacterEncodingScheme()

인터페이스 XMLStreamReader 의 기술:

XML 선언으로 선언된 문자 인코딩을 돌려줍니다. 선언되어 있지 않은 경우는 null 를 돌려줍니다.

정의:: 인터페이스 XMLStreamReader 내의 getCharacterEncodingScheme

반환값:: 문서로 선언된 인코딩 또는 null

getPITarget

public String  getPITarget()

인터페이스 XMLStreamReader 의 기술:

처리 명령의 타겟을 가져옵니다.

정의:: 인터페이스 XMLStreamReader 내의 getPITarget

반환값:: 타겟 또는 null

getPIData

public String  getPIData()

인터페이스 XMLStreamReader 의 기술:

처리 명령의 데이터 섹션을 가져옵니다.

정의:: 인터페이스 XMLStreamReader 내의 getPIData

반환값:: 데이터 또는 null

getProperty

public Object  getProperty(String  name)

인터페이스 XMLStreamReader 의 기술:

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

정의:: 인터페이스 XMLStreamReader 내의 getProperty

파라미터:: name - 프로퍼티의 이름 (null 이외)
반환값:: 프로퍼티의 값

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스

프레임 있어 프레임 없음

개요: 상자 | 필드 | 생성자 | 메소드

상세: 필드 | 생성자 | 메소드

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

javax.xml.stream.util 클래스 StreamReaderDelegate

StreamReaderDelegate

StreamReaderDelegate

setParent

getParent

next

nextTag

getElementText

require

hasNext

close

getNamespaceURI

getNamespaceContext

isStartElement

isEndElement

isCharacters

isWhiteSpace

getAttributeValue

getAttributeCount

getAttributeName

getAttributePrefix

getAttributeNamespace

getAttributeLocalName

getAttributeType

getAttributeValue

isAttributeSpecified

getNamespaceCount

getNamespacePrefix

getNamespaceURI

getEventType

getText

getTextCharacters

getTextCharacters

getTextStart

getTextLength

getEncoding

hasText

getLocation

getName

getLocalName

hasName

getNamespaceURI

getPrefix

getVersion

isStandalone

standaloneSet

getCharacterEncodingScheme

getPITarget

getPIData

getProperty

javax.xml.stream.util
클래스 StreamReaderDelegate