org.xml.sax.ext
インタフェース Attributes2

すべてのスーパーインタフェース:

Attributes

既知の実装クラスの一覧:

Attributes2Impl

public interface Attributes2
extends Attributes

SAX2 拡張は Attributes を通して提供される per- 属性情報を増やします。実装がこの拡張をサポートしている場合、ContentHandler.startElement() で提供される属性はこのインタフェースを実装し、「http://xml.org/sax/features/use-attributes2」機能フラグは値「true」を持ちます。

このモジュールは、ソースコード、文書ともに公開ドメインに置かれています。したがって、内容に関する保証は一切提供されません。

XMLReader 実装はこの情報のサポートに必要ありません。これは SAX2 のコアディストリビューションだけに含まれるものではありません。

属性は、デフォルトで「!isSpecified()」指定されると 、必然的に DTDにも「isDeclared()」宣言されます 。同様に、属性の型が CDATA 以外であれば必ず宣言されます。

導入されたバージョン:

SAX 2.0 (extensions 1.1 alpha)

メソッドの概要

boolean	isDeclared(int index) 属性が DTD に宣言されなかった場合は false を返します。
boolean	isDeclared(String qName) 属性が DTD に宣言されなかった場合は false を返します。
boolean	isDeclared(String uri, String localName) 属性が DTD に宣言されなかった場合は false を返します。
boolean	isSpecified(int index) 属性値が DTD のデフォルトによって提供されなかった場合は true を返します。
boolean	isSpecified(String qName) 属性値が DTD のデフォルトによって提供されなかった場合は true を返します。
boolean	isSpecified(String uri, String localName) 属性値が DTD のデフォルトによって提供されなかった場合は true を返します。

インタフェース org.xml.sax.Attributes から継承されたメソッド

getIndex, getIndex, getLength, getLocalName, getQName, getType, getType, getType, getURI, getValue, getValue, getValue

メソッドの詳細

isDeclared

boolean isDeclared(int index)

属性が DTD に宣言されなかった場合は false を返します。これにより、SAX が CDATA として報告する属性を、宣言された属性 (通常は有効) と宣言されなかった属性 (無効) の 2 種類に区別できます。

パラメータ:

index - 属性インデックス (ゼロから始まる)

戻り値:

属性が DTD に宣言された場合は true、そうでない場合は false

例外:

ArrayIndexOutOfBoundsException - 指定されたインデックスが属性を識別しない場合

isDeclared

boolean isDeclared(String qName)

属性が DTD に宣言されなかった場合は false を返します。これにより、SAX が CDATA として報告する属性を、宣言された属性 (通常は有効) と宣言されなかった属性 (無効) の 2 種類に区別できます。

パラメータ:

qName - XML の接頭辞付きの修飾名

戻り値:

属性が DTD に宣言された場合は true、そうでない場合は false

例外:

IllegalArgumentException - 指定された名前が属性を識別しない場合

isDeclared

boolean isDeclared(String uri,
                   String localName)

属性が DTD に宣言されなかった場合は false を返します。これにより、SAX が CDATA として報告する属性を、宣言された属性 (通常は有効) と宣言されなかった属性 (無効) の 2 種類に区別できます。

DTD は名前空間を理解していないので、属性に関連付けられた名前空間 URI は DTD に由来するものではないことに注意してください。宣言は属性の「qName」に適用されます。

パラメータ:

uri - 名前空間 URI。名前が名前空間 URI を持たない場合は空文字列

localName - 属性のローカル名

戻り値:

属性が DTD に宣言された場合は true、そうでない場合は false

例外:

IllegalArgumentException - 指定された名前が属性を識別しない場合

isSpecified

boolean isSpecified(int index)

属性値が DTD のデフォルトによって提供されなかった場合は true を返します。

パラメータ:

index - 属性インデックス (ゼロから始まる)

戻り値:

値が XML テキストに見つからなかった場合は true、DTD のデフォルトによって提供された場合は false

例外:

ArrayIndexOutOfBoundsException - 指定されたインデックスが属性を識別しない場合

isSpecified

boolean isSpecified(String uri,
                    String localName)

属性値が DTD のデフォルトによって提供されなかった場合は true を返します。

DTD は名前空間を理解していないので、属性に関連付けられた名前空間 URI は DTD に由来するものではないことに注意してください。宣言は属性の「qName」に適用されます。

パラメータ:

uri - 名前空間 URI。名前が名前空間 URI を持たない場合は空文字列

localName - 属性のローカル名

戻り値:

値が XML テキストに見つからなかった場合は true、DTD のデフォルトによって提供された場合は false

例外:

IllegalArgumentException - 指定された名前が属性を識別しない場合

isSpecified

boolean isSpecified(String qName)

属性値が DTD のデフォルトによって提供されなかった場合は true を返します。

パラメータ:

qName - XML の接頭辞付きの修飾名

戻り値:

値が XML テキストに見つからなかった場合は true、DTD のデフォルトによって提供された場合は false

例外:

IllegalArgumentException - 指定された名前が属性を識別しない場合