JavaTM 2 Platform
Standard Ed. 5.0

org.xml.sax
インタフェース AttributeList

既知の実装クラスの一覧:
AttributeListImpl

推奨されていません。 このインタフェースは、名前空間をサポートする SAX2 の Attributes インタフェースで置き換えられています。

public interface AttributeList

要素の属性指定のためのインタフェースです。

このモジュールは、ソースコード、文書ともに公開ドメインに置かれています。したがって、内容に関する保証は一切提供されません。詳細は、http://www.saxproject.org を参照してください。

これは、要素の属性を報告する SAX1 インタフェースです。新しい Attributes インタフェースとは異なり、名前空間関連情報のサポートは行いません。

属性リストが startElement イベントの一部として提供された場合、リストはイベント範囲内でのみ有効な結果を返します。イベントハンドラからパーサに制御が移ると、属性リストは無効になります。属性リストの持続的なコピーを保存するには、SAX1 の AttributeListImpl ヘルパークラスを使用します。

属性リストには、指定された属性または省略時属性だけが含まれます。#IMPLIED 属性は含まれません。

SAX アプリケーションが AttributeList から情報を取得する方法は 2 種類あります。まず、リスト全体で繰り返し処理を行うという方法があります。


 public void startElement (String name, AttributeList atts) {
   for (int i = 0; i < atts.getLength(); i++) {
     String name = atts.getName(i);
     String type = atts.getType(i);
     String value = atts.getValue(i);
     [...]
   }
 }
 

属性が存在しない場合、getLength() の結果はゼロになります。

次に、アプリケーションから特定の属性の値または型を要求するという方法があります。


 public void startElement (String name, AttributeList atts) {
   String identifier = atts.getValue("id");
   String label = atts.getValue("label");
   [...]
 }
 

導入されたバージョン:
SAX 1.0
関連項目:
startElement, AttributeListImpl

メソッドの概要
 int getLength()
          推奨されていません。 このリスト内にある属性の数を返します。
 String getName(int i)
          推奨されていません。 このリスト内の属性の名前 (位置によって) を返します。
 String getType(int i)
          推奨されていません。 このリスト内の属性の型 (位置によって) を返します。
 String getType(String name)
          推奨されていません。 リスト内の属性の型 (名前) を返します。
 String getValue(int i)
          推奨されていません。 リスト内の属性の値 (位置によって) を返します。
 String getValue(String name)
          推奨されていません。 リスト内の属性の値 (名前) を返します。
 

メソッドの詳細

getLength

int getLength()
推奨されていません。 
このリスト内にある属性の数を返します。

SAX パーサは、宣言された順序または指定された順序とは関係なく、任意の順序で属性を提供します。属性数がゼロの場合もあります。

戻り値:
リスト内の属性の数

getName

String getName(int i)
推奨されていません。 
このリスト内の属性の名前 (位置によって) を返します。

属性の名前は一意でなければいけません。SAX パーサに同じ属性を重複して含めることはできません。値を持たない属性 (開始タグに指定された値を使用しないで #IMPLIED を宣言した属性) はリストに記載されません。

属性名に名前空間接頭辞が付いていても、この接頭辞が削除されることはありません。

パラメータ:
i - リスト内の属性のインデックス(0 から始まる)
戻り値:
インデックス属性の名前。インデックスが範囲外の場合は null
関連項目:
getLength()

getType

String getType(int i)
推奨されていません。 
このリスト内の属性の型 (位置によって) を返します。

属性型は、「CDATA」、「ID」、「IDREF」、「IDREFS」、「NMTOKEN」、「NMTOKENS」、「ENTITY」、「ENTITIES」、「NOTATION」のどれか 1 つになります (常に大文字を使用)。

パーサが属性の宣言を読み取らず、属性型を報告しない場合、XML 1.0 勧告 (3.3.3「属性値の正規化」) に従って、値「CDATA」が返されます。

表記法以外の列挙型属性の型は「NMTOKEN」と報告されます。

パラメータ:
i - リスト内の属性のインデックス(0 から始まる)
戻り値:
属性型を示す文字列。インデックスが範囲外の場合は null
関連項目:
getLength(), getType(java.lang.String)

getValue

String getValue(int i)
推奨されていません。 
リスト内の属性の値 (位置によって) を返します。

属性値が IDREFS、ENTITIES、NMTOKENS のどれかのトークンのリストである場合、トークンは空白文字で区切られた単一の文字列に連結されます。

パラメータ:
i - リスト内の属性のインデックス(0 から始まる)
戻り値:
属性値を示す文字列。インデックスが範囲外の場合は null
関連項目:
getLength(), getValue(java.lang.String)

getType

String getType(String name)
推奨されていません。 
リスト内の属性の型 (名前) を返します。

戻り値は getType(int) の戻り値と同じです。

属性名に文書内の名前空間接頭辞が含まれている場合、アプリケーションはここに接頭辞を含める必要があります。

パラメータ:
name - 属性の名前
戻り値:
属性型を表す文字列。該当する属性が存在しない場合は null
関連項目:
getType(int)

getValue

String getValue(String name)
推奨されていません。 
リスト内の属性の値 (名前) を返します。

戻り値は getValue(int) の戻り値と同じです。

属性名に文書内の名前空間接頭辞が含まれている場合、アプリケーションはここに接頭辞を含める必要があります。

パラメータ:
name - 返す属性の名前
戻り値:
属性値を表す文字列。該当する属性が存在しない場合は null
関連項目:
getValue(int)

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 も参照してください。