JavaTM 2 Platform
Standard Ed. 5.0

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 - 指定された名前が属性を識別しない場合

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。