モジュール java.xml
パッケージ org.xml.sax.ext

インタフェースAttributes2

  • すべてのスーパー・インタフェース:
    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)

    • メソッドの詳細

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