モジュール 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)

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    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 - 指定された名前が属性を識別しない場合。