- すべてのスーパー・インタフェース:
Attributes
- 既知のすべての実装クラス:
Attributes2Impl
public interface Attributes2 extends Attributes
SAX2拡張機能で、
Attributes
から提供される属性ごとの情報を補強します。 実装がこの拡張をサポートしている場合、ContentHandler.startElement()
で提供される属性はこのインタフェースを実装し、http://xml.org/sax/features/use-attributes2機能フラグは値trueを持ちます。
XMLReader実装はこの情報のサポートに必要ありません。これはSAX2のコア・ディストリビューションだけに含まれるものではありません。
属性は、デフォルトに設定されている場合(!isSpecified())、必然的にDTDにも宣言されています(isDeclared())。 同様に、属性の型がCDATA以外であれば必ず宣言されます。
- 導入されたバージョン:
- 1.5, 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を返します。
-
メソッドの詳細
-
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
属性が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
属性値が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
- 指定された名前が属性を識別しない場合。
-