- すべての実装されたインタフェース:
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(String name)
がtrueを返す場合、Transformerはこの型のSource入力をサポートします。 -
コンストラクタのサマリー
コンストラクタ コンストラクタ 説明 StAXSource(XMLEventReader xmlEventReader)
XMLEventReader
を指定して、StAXSource
の新しいインスタンスを作成します。StAXSource(XMLStreamReader xmlStreamReader)
XMLStreamReader
を指定して、StAXSource
の新しいインスタンスを作成します。 -
メソッドのサマリー
修飾子と型 メソッド 説明 String
getSystemId()
このStAXSource
が使用するシステム識別子を取得します。XMLEventReader
getXMLEventReader()
このStAXSource
が使用するXMLEventReader
を取得します。XMLStreamReader
getXMLStreamReader()
このStAXSource
が使用するXMLStreamReader
を取得します。boolean
isEmpty()
StAXSource
オブジェクトが空であるかどうかを示します。void
setSystemId(String systemId)
StAXSource
のコンテキストでは、システム識別子を明示的に設定することは適切ではありません。
-
フィールド詳細
-
FEATURE
public static final String FEATUREこの値を引数として渡したときにTransformerFactory.getFeature(String name)
がtrueを返す場合、Transformerはこの型のSource入力をサポートします。- 関連項目:
- 定数フィールド値
-
-
コンストラクタの詳細
-
StAXSource
public StAXSource(XMLEventReader xmlEventReader) throws XMLStreamExceptionXMLEventReader
を指定して、StAXSource
の新しいインスタンスを作成します。XMLEventReader
はnull
でない参照である必要があります。XMLEventReader
はXMLStreamConstants.START_DOCUMENT
またはXMLStreamConstants.START_ELEMENT
状態である必要があります。- パラメータ:
xmlEventReader
- このStAXSource
の作成に使われるXMLEventReader
。- 例外:
XMLStreamException
-xmlEventReader
アクセスがException
をスローする場合。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
は常にこのメソッドによってスローされます。- 定義:
setSystemId
、インタフェース:Source
- パラメータ:
systemId
- 無視される。- 例外:
UnsupportedOperationException
- 常にこのメソッドによってスローされる。
-
getSystemId
public String getSystemId()この
StAXSource
が使用するシステム識別子を取得します。XMLソースのシステム識別子を決定する際は、この
StAXSource
の構築に使用されたXMLStreamReader
またはXMLEventReader
が照会されます。システム識別子は
null
か、空の""
String
である可能性があります。- 定義:
getSystemId
、インタフェース:Source
- 戻り値:
- この
StAXSource
が使用するシステム識別子。
-
isEmpty
public boolean isEmpty()StAXSource
オブジェクトが空であるかどうかを示します。StAXSource
オブジェクトは決して空ではないので、このメソッドは常にfalseを返します。
-