StreamReaderDelegate (Java Platform SE 8)

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

すべての実装されたインタフェース:

XMLStreamConstants, XMLStreamReader
```
public class StreamReaderDelegate
extends Object
implements XMLStreamReader
```
これは、XMLStreamReaderフィルタを派生させる基底クラスです。このクラスは、XMLStreamReaderとアプリケーションのXMLStreamReaderの中間に置かれます。デフォルトでは、各メソッドは何もしませんが、親インタフェース上の対応するメソッドを呼び出します。

導入されたバージョン:

1.6

バージョン:

1.0

関連項目:

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()` 親を持たない空のフィルタを構築します。
`StreamReaderDelegate(XMLStreamReader reader)` 指定された親を持つフィルタを構築します。

メソッドのサマリー

すべてのメソッドインスタンス・メソッド具象メソッド
修飾子と型	メソッドと説明
`void`	`close()` このリーダーに関連付けられているリソースをすべて解放します。
`int`	`getAttributeCount()` このSTART_ELEMENT上の属性の数を返します。このメソッドはSTART_ELEMENTまたはATTRIBUTEのみで有効です。
`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を持つ属性の正規化された属性値を返します。namespaceURIがnullの場合、名前空間が一致するかどうかは確認されません。
`String`	`getCharacterEncodingScheme()` XML宣言で宣言された文字エンコーディングを返します。宣言されていない場合はnullを返します。
`String`	`getElementText()` テキストのみの要素のコンテンツを読み取ります。テキストのみの要素でない場合は、例外がスローされます。
`String`	`getEncoding()` 入力エンコーディングが既知の場合は、その入力エンコーディングを返します。未知の場合はnullを返します。
`int`	`getEventType()` カーソルがポイントしているイベントのタイプを示す整数型コードを返します。
`String`	`getLocalName()` 現在のイベントのローカル名を返します。
`Location`	`getLocation()` プロセッサの現在の位置を返します。
`QName`	`getName()` 現在のSTART_ELEMENTまたはEND_ELEMENTイベントのQNameを返します。
`NamespaceContext`	`getNamespaceContext()` 現在の位置の読取り専用の名前空間コンテキストを返します。
`int`	`getNamespaceCount()` このSTART_ELEMENTまたはEND_ELEMENTで宣言された名前空間の数を返します。このメソッドはSTART_ELEMENT、END_ELEMENT、またはNAMESPACEのみで有効です。
`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()` 現在のイベントの接頭辞を返します。イベントが接頭辞を持たない場合はnullを返します。
`Object`	`getProperty(String name)` ベースとなる実装から機能またはプロパティの値を取得します。
`String`	`getText()` 構文解析イベントの現在の値を文字列として返します。CHARACTERSイベントの文字列値、COMMENTの値、ENTITY_REFERENCEの置換値、CDATAセクションの文字列値、SPACEイベントの文字列値、DTDの内部サブセットの文字列値を返します。
`char[]`	`getTextCharacters()` このイベントからの文字を含む配列を返します。
`int`	`getTextCharacters(int sourceStart, char[] target, int targetStart, int length)` CHARACTERS、SPACE、またはCDATAイベントに関連付けられているテキストを取得します。
`int`	`getTextLength()` このテキスト・イベントに対するテキスト文字配列内の文字シーケンスの長さを返します。
`int`	`getTextStart()` このテキスト・イベントの最初の文字が保存されているテキスト文字配列へのオフセットを返します。
`String`	`getVersion()` XML宣言で宣言されたXMLバージョンを取得します。宣言されていない場合はnullを返します。
`boolean`	`hasName()` 現在のイベントが名前(START_ELEMENTまたはEND_ELEMENT)を持つ場合true、そうでない場合falseを返します。
`boolean`	`hasNext()` 構文解析イベントがまだある場合はtrue、そうでない場合はfalseを返します。
`boolean`	`hasText()` 現在のイベントにテキストが含まれる場合true、そうでない場合falseを返します。CHARACTERS、DTD、ENTITY_REFERENCE、COMMENT、SPACEの各イベントにはテキストが含まれます。
`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()
```
    親を持たない空のフィルタを構築します。
  - StreamReaderDelegate
```
public StreamReaderDelegate(XMLStreamReader reader)
```
    指定された親を持つフィルタを構築します。
    
    パラメータ:
    
    reader - 親
- メソッドの詳細
  - setParent
```
public void setParent(XMLStreamReader reader)
```
    このインスタンスの親を設定します。
    
    パラメータ:
    
    reader - 新しい親
  - getParent
```
public XMLStreamReader getParent()
```
    このインスタンスの親を取得します。
    
    戻り値:
    
    親、または設定されていない場合はnull
  - next
```
public int next()
         throws XMLStreamException
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    次の構文解析イベントを取得します。プロセッサは、連続する文字データをすべて単一のチャンクとして、またはいくつかのチャンクに分割して返します。javax.xml.stream.isCoalescingプロパティがtrueに設定されている場合は、要素コンテンツを合体し、連続する要素コンテンツまたはCDATAセクションに対して、CHARACTERSイベントが1つだけ返されるようにしてください。デフォルトでは、エンティティ参照は展開され、アプリケーションに透過的に報告される必要があります。エンティティ参照を展開できない場合は、例外がスローされます。要素コンテンツが空("")の場合、CHARACTERSイベントは報告されません。
    次のXMLについて考えます。
    <foo>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で報告されます。これにより、空の要素の解析が<tag></tag>と等しく保たれます。hasNext()がfalseを返すと、このメソッドはIllegalStateExceptionをスローします。
    
    定義:
    
    next、インタフェース: XMLStreamReader
    
    戻り値:
    
    現在の構文解析イベントに対応する整数型コード
    
    例外:
    
    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以外が見つかると、例外がスローされます。空白文字で区切られた要素のみのコンテンツを処理するときには、このメソッドを使用するようにします。
    前提条件: なし
    事後条件: 現在のイベントが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;
 
```
    定義:
    
    nextTag、インタフェース: XMLStreamReader
    
    戻り値:
    
    読み取った要素のイベント・タイプ(START_ELEMENTまたはEND_ELEMENT)
    
    例外:
    
    XMLStreamException - 現在のイベントが空白文字、PROCESSING_INSTRUCTION、START_ELEMENT、またはEND_ELEMENTでない場合
  - getElementText
```
public String getElementText()
                      throws XMLStreamException
```
    インタフェースからコピーされた説明: XMLStreamReader
    テキストのみの要素のコンテンツを読み取ります。テキストのみの要素でない場合は、例外がスローされます。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();
 
```
    定義:
    
    getElementText、インタフェース: XMLStreamReader
    
    例外:
    
    XMLStreamException - 現在のイベントがSTART_ELEMENTでない場合、またはテキスト以外の要素が見つかった場合
  - require
```
public void require(int type,
                    String namespaceURI,
                    String localName)
             throws XMLStreamException
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    現在のイベントが指定の型かどうか、名前空間と名前が現在のイベントの現在の名前空間と名前に一致するかどうかをテストします。namespaceURIがnullの場合、名前空間が一致するかどうかは確認されません。また、localNameがnullの場合、名前が一致するかどうかは確認されません。
    
    定義:
    
    require、インタフェース: XMLStreamReader
    
    パラメータ:
    
    type - イベントのタイプ
    
    namespaceURI - イベントのURI (nullの場合もある)
    
    localName - イベントのlocalName (nullの場合もある)
    
    例外:
    
    XMLStreamException - 要求された値が一致しない場合。
  - hasNext
```
public boolean hasNext()
                throws XMLStreamException
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    構文解析イベントがまだある場合はtrue、そうでない場合はfalseを返します。このメソッドは、XMLStreamReaderの現在の状態がEND_DOCUMENTの場合はfalseを返します。
    
    定義:
    
    hasNext、インタフェース: XMLStreamReader
    
    戻り値:
    
    イベントがまだある場合はtrue、そうでない場合はfalse
    
    例外:
    
    XMLStreamException - 次の状態の検出時に致命的なエラーが発生した場合
  - close
```
public void close()
           throws XMLStreamException
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    このリーダーに関連付けられているリソースをすべて解放します。このメソッドはベースとなる入力ソースを閉じません。
    
    定義:
    
    close、インタフェース: XMLStreamReader
    
    例外:
    
    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/に解決される必要があります。
    
    定義:
    
    getNamespaceURI、インタフェース: XMLStreamReader
    
    パラメータ:
    
    prefix - 検索する接頭辞(null以外)
    
    戻り値:
    
    指定された接頭辞にバインドされたURI。バインドされていない場合はnull
  - getNamespaceContext
```
public NamespaceContext getNamespaceContext()
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    現在の位置の読取り専用の名前空間コンテキストを返します。コンテキストは一時的なもので、next()の呼出しによってリーダーの状態が変更されるまで有効です。
    
    定義:
    
    getNamespaceContext、インタフェース: XMLStreamReader
    
    戻り値:
    
    名前空間コンテキスト
  - isStartElement
```
public boolean isStartElement()
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    カーソルが開始タグをポイントしている場合はtrue、そうでない場合はfalseを返します。
    
    定義:
    
    isStartElement、インタフェース: XMLStreamReader
    
    戻り値:
    
    カーソルが開始タグをポイントしている場合はtrue、そうでない場合はfalse
  - isEndElement
```
public boolean isEndElement()
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    カーソルが終了タグをポイントしている場合はtrue、そうでない場合はfalseを返します。
    
    定義:
    
    isEndElement、インタフェース: XMLStreamReader
    
    戻り値:
    
    カーソルが終了タグをポイントしている場合はtrue、そうでない場合はfalse
  - isCharacters
```
public boolean isCharacters()
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    カーソルが文字データ・イベントをポイントしている場合はtrueを返します。
    
    定義:
    
    isCharacters、インタフェース: XMLStreamReader
    
    戻り値:
    
    カーソルが文字データをポイントしている場合はtrue、そうでない場合はfalse
  - isWhiteSpace
```
public boolean isWhiteSpace()
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    カーソルが空白文字だけで構成される文字データ・イベントをポイントしている場合はtrueを返します。
    
    定義:
    
    isWhiteSpace、インタフェース: XMLStreamReader
    
    戻り値:
    
    カーソルがすべての空白文字をポイントしている場合はtrue、そうでない場合はfalse
  - getAttributeValue
```
public String getAttributeValue(String namespaceUri,
                                String localName)
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    名前空間とlocalNameを持つ属性の正規化された属性値を返します。namespaceURIがnullの場合、名前空間が一致するかどうかは確認されません。
    
    定義:
    
    getAttributeValue、インタフェース: XMLStreamReader
    
    パラメータ:
    
    namespaceUri - 属性の名前空間
    
    localName - 属性のローカル名(null以外)
    
    戻り値:
    
    属性の値。見つからない場合はnull
  - getAttributeCount
```
public int getAttributeCount()
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    このSTART_ELEMENT上の属性の数を返します。このメソッドはSTART_ELEMENTまたはATTRIBUTEのみで有効です。この数には、名前空間の定義は含まれません。属性インデックスはゼロから始まります。
    
    定義:
    
    getAttributeCount、インタフェース: XMLStreamReader
    
    戻り値:
    
    属性の数
  - getAttributeName
```
public QName getAttributeName(int index)
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    指定されたインデックスにある属性のqnameを返します。
    
    定義:
    
    getAttributeName、インタフェース: XMLStreamReader
    
    パラメータ:
    
    index - 属性の位置
    
    戻り値:
    
    属性のQName
  - getAttributePrefix
```
public String getAttributePrefix(int index)
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    指定されたインデックスにある属性の接頭辞を返します。
    
    定義:
    
    getAttributePrefix、インタフェース: XMLStreamReader
    
    パラメータ:
    
    index - 属性の位置
    
    戻り値:
    
    属性の接頭辞
  - getAttributeNamespace
```
public String getAttributeNamespace(int index)
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    指定されたインデックスにある属性の名前空間を返します。
    
    定義:
    
    getAttributeNamespace、インタフェース: XMLStreamReader
    
    パラメータ:
    
    index - 属性の位置
    
    戻り値:
    
    名前空間URI (nullの場合もある)
  - getAttributeLocalName
```
public String getAttributeLocalName(int index)
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    指定されたインデックスにある属性のlocalNameを返します。
    
    定義:
    
    getAttributeLocalName、インタフェース: XMLStreamReader
    
    パラメータ:
    
    index - 属性の位置
    
    戻り値:
    
    属性のlocalName
  - getAttributeType
```
public String getAttributeType(int index)
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    指定されたインデックスにある属性のXML型を返します。
    
    定義:
    
    getAttributeType、インタフェース: XMLStreamReader
    
    パラメータ:
    
    index - 属性の位置
    
    戻り値:
    
    属性のXML型
  - getAttributeValue
```
public String getAttributeValue(int index)
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    インデックスにある属性の値を返します。
    
    定義:
    
    getAttributeValue、インタフェース: XMLStreamReader
    
    パラメータ:
    
    index - 属性の位置
    
    戻り値:
    
    属性値
  - isAttributeSpecified
```
public boolean isAttributeSpecified(int index)
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    この属性がデフォルトで作成されたかどうかを示すboolean値を返します。
    
    定義:
    
    isAttributeSpecified、インタフェース: XMLStreamReader
    
    パラメータ:
    
    index - 属性の位置
    
    戻り値:
    
    デフォルトの属性である場合はtrue
  - getNamespaceCount
```
public int getNamespaceCount()
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    このSTART_ELEMENTまたはEND_ELEMENTで宣言された名前空間の数を返します。このメソッドはSTART_ELEMENT、END_ELEMENT、またはNAMESPACEのみで有効です。END_ELEMENTでは、スコープ外に出つつある名前空間の数になります。これは、要素終了イベントのSAXコールバックによって報告される情報と同等です。
    
    定義:
    
    getNamespaceCount、インタフェース: XMLStreamReader
    
    戻り値:
    
    この要素上の名前空間宣言の数
  - getNamespacePrefix
```
public String getNamespacePrefix(int index)
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    指定されたインデックスで宣言された名前空間の接頭辞を返します。デフォルトの名前空間宣言の場合はnullを返します。
    
    定義:
    
    getNamespacePrefix、インタフェース: XMLStreamReader
    
    パラメータ:
    
    index - 名前空間宣言の位置
    
    戻り値:
    
    名前空間の接頭辞
  - getNamespaceURI
```
public String getNamespaceURI(int index)
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    指定されたインデックスで宣言された名前空間のURIを返します。
    
    定義:
    
    getNamespaceURI、インタフェース: XMLStreamReader
    
    パラメータ:
    
    index - 名前空間宣言の位置
    
    戻り値:
    
    名前空間URI
  - getEventType
```
public int getEventType()
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    カーソルがポイントしているイベントのタイプを示す整数型コードを返します。
    
    定義:
    
    getEventType、インタフェース: XMLStreamReader
  - getText
```
public String getText()
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    構文解析イベントの現在の値を文字列として返します。CHARACTERSイベントの文字列値、COMMENTの値、ENTITY_REFERENCEの置換値、CDATAセクションの文字列値、SPACEイベントの文字列値、DTDの内部サブセットの文字列値を返します。ENTITY_REFERENCEが解決されている場合、すべての文字データがCHARACTERSイベントとして報告されます。
    
    定義:
    
    getText、インタフェース: XMLStreamReader
    
    戻り値:
    
    現在のテキストまたはnull
  - getTextCharacters
```
public int getTextCharacters(int sourceStart,
                             char[] target,
                             int targetStart,
                             int length)
                      throws XMLStreamException
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    CHARACTERS、SPACE、またはCDATAイベントに関連付けられているテキストを取得します。sourceStartで始まるテキストが、targetStartの位置で始まるtargetにコピーされます。最大で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がスローされることがあります。targetStart引数は0以上で、targetの長さよりも小さい必要があり、lengthは0よりも大きく、targetStartとlengthの合計はtargetの長さ以下であることが必要です。
    
    定義:
    
    getTextCharacters、インタフェース: XMLStreamReader
    
    パラメータ:
    
    sourceStart - コピー対象ソース配列内の最初の文字のインデックス
    
    target - 転送先配列
    
    targetStart - ターゲットの配列内での開始オフセット
    
    length - コピーする文字数
    
    戻り値:
    
    実際にコピーした文字数
    
    例外:
    
    XMLStreamException - ベースとなるXMLソースが整形式でない場合
  - getTextCharacters
```
public char[] getTextCharacters()
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    このイベントからの文字を含む配列を返します。この配列を読取り専用で一時的なものとして処理するようにします。つまり、この配列にテキスト文字が含まれるのは、XMLStreamReaderが次のイベントに移動するまでの間です。それ以上の期間テキストを文字配列に保持したり、配列の内容を変更したりすると、このインタフェースの規約違反になります。
    
    定義:
    
    getTextCharacters、インタフェース: XMLStreamReader
    
    戻り値:
    
    現在のテキストまたは空の配列
  - getTextStart
```
public int getTextStart()
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    このテキスト・イベントの最初の文字が保存されているテキスト文字配列へのオフセットを返します。
    
    定義:
    
    getTextStart、インタフェース: XMLStreamReader
  - getTextLength
```
public int getTextLength()
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    このテキスト・イベントに対するテキスト文字配列内の文字シーケンスの長さを返します。
    
    定義:
    
    getTextLength、インタフェース: XMLStreamReader
  - getEncoding
```
public String getEncoding()
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    入力エンコーディングが既知の場合は、その入力エンコーディングを返します。未知の場合はnullを返します。
    
    定義:
    
    getEncoding、インタフェース: XMLStreamReader
    
    戻り値:
    
    このインスタンスのエンコーディングまたはnull
  - hasText
```
public boolean hasText()
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    現在のイベントにテキストが含まれる場合true、そうでない場合falseを返します。CHARACTERS、DTD、ENTITY_REFERENCE、COMMENT、SPACEの各イベントにはテキストが含まれます。
    
    定義:
    
    hasText、インタフェース: XMLStreamReader
  - getLocation
```
public Location getLocation()
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    プロセッサの現在の位置を返します。Locationがわからない場合、プロセッサはLocationの実装を返します。これは、位置について -1を返し、publicIdとsystemIdについてnullを返します。位置情報が有効なのは、next()が呼び出されるまでのみです。
    
    定義:
    
    getLocation、インタフェース: XMLStreamReader
  - getName
```
public QName getName()
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    現在のSTART_ELEMENTまたはEND_ELEMENTイベントのQNameを返します。
    
    定義:
    
    getName、インタフェース: XMLStreamReader
    
    戻り値:
    
    現在のSTART_ELEMENTまたはEND_ELEMENTイベントのQName
  - getLocalName
```
public String getLocalName()
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    現在のイベントのローカル名を返します。START_ELEMENTまたはEND_ELEMENTについては、現在の要素のローカル名を返します。ENTITY_REFERENCEについては、エンティティ名を返します。現在のイベントは、START_ELEMENT、END_ELEMENT、ENTITY_REFERENCEのいずれかである必要があります。
    
    定義:
    
    getLocalName、インタフェース: XMLStreamReader
    
    戻り値:
    
    localName
  - hasName
```
public boolean hasName()
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    現在のイベントが名前(START_ELEMENTまたはEND_ELEMENT)を持つ場合true、そうでない場合falseを返します。
    
    定義:
    
    hasName、インタフェース: XMLStreamReader
  - getNamespaceURI
```
public String getNamespaceURI()
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    現在のイベントがSTART_ELEMENTまたはEND_ELEMENTである場合、このメソッドは接頭辞のURIまたはデフォルトの名前空間を返します。イベントが接頭辞を持たない場合、nullを返します。
    
    定義:
    
    getNamespaceURI、インタフェース: XMLStreamReader
    
    戻り値:
    
    この要素の接頭辞にバインドされたURI、デフォルトの名前空間、またはnull
  - getPrefix
```
public String getPrefix()
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    現在のイベントの接頭辞を返します。イベントが接頭辞を持たない場合はnullを返します。
    
    定義:
    
    getPrefix、インタフェース: XMLStreamReader
    
    戻り値:
    
    接頭辞またはnull
  - getVersion
```
public String getVersion()
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    XML宣言で宣言されたXMLバージョンを取得します。宣言されていない場合はnullを返します。
    
    定義:
    
    getVersion、インタフェース: XMLStreamReader
    
    戻り値:
    
    XMLバージョンまたはnull
  - isStandalone
```
public boolean isStandalone()
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    XML宣言からスタンドアロン宣言を取得します。
    
    定義:
    
    isStandalone、インタフェース: XMLStreamReader
    
    戻り値:
    
    スタンドアロンである場合はtrue、そうでない場合はfalse
  - standaloneSet
```
public boolean standaloneSet()
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    ドキュメントでスタンドアロンが設定されていたかどうかを確認します。
    
    定義:
    
    standaloneSet、インタフェース: XMLStreamReader
    
    戻り値:
    
    ドキュメントでスタンドアロンが設定されていた場合はtrue、そうでない場合はfalse
  - getCharacterEncodingScheme
```
public String getCharacterEncodingScheme()
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    XML宣言で宣言された文字エンコーディングを返します。宣言されていない場合はnullを返します。
    
    定義:
    
    getCharacterEncodingScheme、インタフェース: XMLStreamReader
    
    戻り値:
    
    ドキュメントで宣言されたエンコーディングまたはnull
  - getPITarget
```
public String getPITarget()
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    処理命令のターゲットを取得します。
    
    定義:
    
    getPITarget、インタフェース: XMLStreamReader
    
    戻り値:
    
    ターゲットまたはnull
  - getPIData
```
public String getPIData()
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    処理命令のデータ・セクションを取得します。
    
    定義:
    
    getPIData、インタフェース: XMLStreamReader
    
    戻り値:
    
    データまたはnull
  - getProperty
```
public Object getProperty(String name)
```
    インタフェースからコピーされた説明: XMLStreamReader
    
    ベースとなる実装から機能またはプロパティの値を取得します。
    
    定義:
    
    getProperty、インタフェース: XMLStreamReader
    
    パラメータ:
    
    name - プロパティの名前(null以外)
    
    戻り値:
    
    プロパティの値

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.

クラスStreamReaderDelegate

フィールドのサマリー

インタフェース javax.xml.stream.XMLStreamConstantsから継承されたフィールド

コンストラクタのサマリー

メソッドのサマリー

クラス java.lang.Objectから継承されたメソッド

コンストラクタの詳細

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