javax.xml.transform.stax
클래스 StAXSource

java.lang.Object 
  javax.xml.transform.stax.StAXSource

모든 구현된 인터페이스:

Source

public class StAXSource
extends Object 
implements Source 

StAX 리더 (XMLStreamReader 또는 XMLEventReader )의 형식의 XML Source 의 홀더로서 기능합니다.. StAXSource 는,Source 를 받아들이는 모든 케이스, 예를 들어 Transformer 나, 입력으로서 Source 를 받아들이는 Validator 로 사용할 수 있습니다.

StAXSource 는 처리중에 소비됩니다. 재사용은 할 수 없습니다.

도입된 버젼:

1.6

관련 항목:

JSR 173: Streaming API for XML , XMLStreamReader , XMLEventReader

필드의 개요

static String

FEATURE 이 값을 인수로서 건네주었을 때에 TransformerFactory.getFeature(java.lang.String) 이 true 를 돌려주는 경우, Transformer 는 이 형태의 Source 입력을 지원합니다.

생성자 의 개요

StAXSource (XMLEventReader xmlEventReader)
XMLEventReader 를 지정해,StAXSource 의 새로운 인스턴스를 작성합니다.

StAXSource (XMLStreamReader xmlStreamReader)
XMLStreamReader 를 지정해,StAXSource 의 새로운 인스턴스를 작성합니다.

메소드의 개요

String	getSystemId () 이 StAXSource 가 사용하는 시스템 식별자를 가져옵니다.
XMLEventReader	getXMLEventReader () 이 StAXSource 가 사용하는 XMLEventReader 를 가져옵니다.
XMLStreamReader	getXMLStreamReader () 이 StAXSource 가 사용하는 XMLStreamReader 를 가져옵니다.
void	setSystemId (String systemId) StAXSource 의 문맥에서는, 시스템 식별자를 명시적으로 설정하는 것은 적절하지는 않습니다.

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

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

필드의 상세

FEATURE

public static final String  FEATURE

이 값을 인수로서 건네주었을 때에 TransformerFactory.getFeature(java.lang.String) 가 true 를 돌려주는 경우, Transformer 는 이 형태의 Source 입력을 지원합니다.

관련 항목:

정수 필드치

생성자 의 상세

StAXSource

public StAXSource(XMLEventReader  xmlEventReader)
           throws XMLStreamException 

XMLEventReader 를 지정해,StAXSource 의 새로운 인스턴스를 작성합니다.

XMLEventReader 는 null 가 아닌 참조일 필요가 있습니다.

XMLEventReader 는,XMLStreamConstants.START_DOCUMENT 상태 또는 XMLStreamConstants.START_ELEMENT 상태입니다.

파라미터:

xmlEventReader - 이 StAXSource 의 작성에 사용하는 XMLEventReader

예외:

XMLStreamException - xmlEventReader 액세스가 Exception 를 throw 하는 경우

IllegalArgumentException - xmlEventReader == null 의 경우

IllegalStateException - xmlEventReader 가 XMLStreamConstants.START_DOCUMENT 상태에서도 XMLStreamConstants.START_ELEMENT 상태도 아닌 경우

StAXSource

public StAXSource(XMLStreamReader  xmlStreamReader)

XMLStreamReader 를 지정해,StAXSource 의 새로운 인스턴스를 작성합니다.

XMLStreamReader 는 null 가 아닌 참조일 필요가 있습니다.

XMLStreamReader 는,XMLStreamConstants.START_DOCUMENT 상태 또는 XMLStreamConstants.START_ELEMENT 상태입니다.

파라미터:

xmlStreamReader - 이 StAXSource 의 작성에 사용하는 XMLStreamReader

예외:

IllegalArgumentException - xmlStreamReader == null 의 경우

IllegalStateException - xmlStreamReader 가 XMLStreamConstants.START_DOCUMENT 상태에서도 XMLStreamConstants.START_ELEMENT 상태도 아닌 경우

메소드의 상세

getXMLEventReader

public XMLEventReader  getXMLEventReader()

이 StAXSource 가 사용하는 XMLEventReader 를 가져옵니다.

이 StAXSource 가 XMLStreamReader 에 근거해 작성되었을 경우,XMLEventReader 는 null 가 됩니다.

반환값:

이 StAXSource 가 사용하는 XMLEventReader

getXMLStreamReader

public XMLStreamReader  getXMLStreamReader()

이 StAXSource 가 사용하는 XMLStreamReader 를 가져옵니다.

이 StAXSource 가 XMLEventReader 에 근거해 작성되었을 경우,XMLStreamReader 는 null 가 됩니다.

반환값:

이 StAXSource 가 사용하는 XMLStreamReader

setSystemId

public void setSystemId(String  systemId)

StAXSource 의 문맥에서는, 시스템 식별자를 명시적으로 설정하는 것은 적절하지는 않습니다. XML 소스의 시스템 식별자는, 이 StAXSource 의 구축에 사용된 XMLStreamReader 또는 XMLEventReader 에 의해 결정됩니다.

UnsupportedOperationException 는항상이 메소드에 의해 throw 됩니다.

정의:

인터페이스 Source 내의 setSystemId

파라미터:

systemId - 무시된다

예외:

UnsupportedOperationException - 항상이 메소드에 의해 throw 된다

getSystemId

public String  getSystemId()

이 StAXSource 가 사용하는 시스템 식별자를 가져옵니다.

XML 소스의 시스템 식별자를 결정할 때는, 이 StAXSource 의 구축에 사용된 XMLStreamReader 또는 XMLEventReader 가 조회됩니다.

시스템 식별자는 null 인가, 빈 상태(empty)의 String ("")일 가능성이 있습니다.

정의:

인터페이스 Source 내의 getSystemId

반환값:

이 StAXSource 가 사용하는 시스템 식별자