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