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

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

AttributeListImpl

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

public interface AttributeList

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

このモジュールは、ソースコード、文書ともに公開ドメインに置かれています。したがって、内容に関する保証は一切提供されません。

これは、要素の属性を報告する 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

public int getLength()

推奨されていません。

このリスト内にある属性の数を返します。

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

戻り値:

リスト内の属性の数

getName

public String getName(int i)

推奨されていません。

このリスト内の属性の名前 (位置によって) を返します。

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

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

パラメータ:

i - リスト内の属性のインデックス。0 で始まる

戻り値:

インデックス属性の名前。インデックスが範囲外の場合は null

関連項目:

getLength()

getType

public String getType(int i)

推奨されていません。

このリスト内の属性の型 (位置によって) を返します。

属性型は、文字列 "CDATA"、"ID"、"IDREF"、"IDREFS"、"NMTOKEN"、"NMTOKENS"、"ENTITY"、"ENTITIES"、"NOTATION" のいずれかの型になります (常に大文字を使用)。

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

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

パラメータ:

i - リスト内の属性のインデックス。(0) で始まる

戻り値:

属性型を示す文字列。インデックスが範囲外の場合は null

関連項目:

getLength(), getType(java.lang.String)

getValue

public String getValue(int i)

推奨されていません。

リスト内の属性の値 (位置によって) を返します。

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

パラメータ:

i - リスト内の属性のインデックス。0 で始まる

戻り値:

属性値を示す文字列。インデックスが範囲外の場合は null

関連項目:

getLength(), getValue(java.lang.String)

getType

public String getType(String name)

推奨されていません。

リスト内の属性の型 (名前) を返します。

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

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

パラメータ:

name - 属性の名前

戻り値:

属性型を表す文字列。該当する属性が存在しない場合は null

関連項目:

getType(int)

getValue

public String getValue(String name)

推奨されていません。

リスト内の属性の値 (名前) を返します。

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

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

戻り値:

属性値を表す文字列。該当する属性が存在しない場合は null

関連項目:

getValue(int)