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)