org.xml.sax.helpers
類別 AttributesImpl

java.lang.Object
  org.xml.sax.helpers.AttributesImpl

所有已實作的介面：

Attributes

直接已知子類別：

Attributes2Impl

public class AttributesImpl
extends Object
implements Attributes

Attributes 介面的預設實作。

此模組（包括源程式碼和文檔）位於公共域中，對該模組不提供擔保。有關更多資訊，請參閱http://www.saxproject.org。

此類別提供 SAX2 Attributes 介面的預設實作，並附帶操縱器，以便可以修改或重用列表。

此類別有兩種典型的用途：

1. 在 startElement 事件中捕獲 Attributes 物件的持久快照；或
2. 在 SAX2 驅動程序或過濾器中建構或修改 Attributes 物件。

此類別可以替換現已不推薦使用的 SAX1 AttributeListImpl 類別；除了支持更新的 Attributes 介面（而不是不推薦使用的 AttributeList 介面）外，它還包括使用單個陣列（而不是向量集）更加有效的實作。

從以下版本開始：

SAX 2.0

建構子摘要

AttributesImpl()
建構一個新的空 AttributesImpl 物件。

AttributesImpl(Attributes atts)
複製現有 Attributes 物件。

方法摘要

void	addAttribute(String uri, String localName, String qName, String type, String value) 將屬性添加到列表的末尾。
void	clear() 為了重用而清除屬性列表。
int	getIndex(String qName) 通過限定（加前綴的）名稱尋找屬性的索引。
int	getIndex(String uri, String localName) 通過名稱空間名稱尋找屬性的索引。
int	getLength() 返回列表中的屬性個數。
String	getLocalName(int index) 返回屬性的本地名稱。
String	getQName(int index) 返回屬性的限定（加前綴的）名稱。
String	getType(int index) 通過索引返回屬性的型別。
String	getType(String qName) 通過限定（加前綴的）名稱尋找屬性的型別。
String	getType(String uri, String localName) 通過限定名稱空間的名稱尋找屬性的型別。
String	getURI(int index) 返回屬性的名稱空間 URI。
String	getValue(int index) 通過索引返回屬性的值。
String	getValue(String qName) 通過限定（加前綴的）名稱尋找屬性的值。
String	getValue(String uri, String localName) 通過限定名稱空間的名稱尋找屬性的值。
void	removeAttribute(int index) 從列表移除屬性。
void	setAttribute(int index, String uri, String localName, String qName, String type, String value) 在列表中設置屬性。
void	setAttributes(Attributes atts) 複製整個 Attributes 物件。
void	setLocalName(int index, String localName) 設置特定屬性的本地名稱。
void	setQName(int index, String qName) 設置特定屬性的限定名稱。
void	setType(int index, String type) 設置特定屬性的型別。
void	setURI(int index, String uri) 設置特定屬性的名稱空間 URI。
void	setValue(int index, String value) 設置特定屬性的值。

從類別 java.lang.Object 繼承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

建構子詳細資訊

AttributesImpl

public AttributesImpl()

建構一個新的空 AttributesImpl 物件。

AttributesImpl

public AttributesImpl(Attributes atts)

複製現有 Attributes 物件。

在 startElement 事件中，此建構子特別有用。

參數：

atts - 現有 Attributes 物件。

方法詳細資訊

getLength

public int getLength()

返回列表中的屬性個數。

指定者：

介面 Attributes 中的 getLength

返回：

此列表中的屬性個數。

另請參見：

Attributes.getLength()

getURI

public String getURI(int index)

返回屬性的名稱空間 URI。

指定者：

介面 Attributes 中的 getURI

參數：

index - 屬性的索引（從零開始）。

返回：

名稱空間 URI，如果沒有可用的，則返回空字元串；如果索引超出範圍，則返回 null。

另請參見：

Attributes.getURI(int)

getLocalName

public String getLocalName(int index)

返回屬性的本地名稱。

指定者：

介面 Attributes 中的 getLocalName

參數：

index - 屬性的索引（從零開始）。

返回：

屬性的本地名稱，如果沒有，則返回空字元串；如果索引超出範圍，則返回 null。

另請參見：

Attributes.getLocalName(int)

getQName

public String getQName(int index)

返回屬性的限定（加前綴的）名稱。

指定者：

介面 Attributes 中的 getQName

參數：

index - 屬性的索引（從零開始）。

返回：

屬性的限定名稱，如果沒有可用的，則返回空字元串；如果索引超出範圍，則返回 null。

另請參見：

Attributes.getQName(int)

getType

public String getType(int index)

通過索引返回屬性的型別。

指定者：

介面 Attributes 中的 getType

參數：

index - 屬性的索引（從零開始）。

返回：

屬性的型別，如果型別是未知的，則返回 "CDATA"；如果索引超出範圍，則返回 null。

另請參見：

Attributes.getType(int)

getValue

public String getValue(int index)

通過索引返回屬性的值。

指定者：

介面 Attributes 中的 getValue

參數：

index - 屬性的索引（從零開始）。

返回：

屬性的值，如果索引超出範圍，則返回 null。

另請參見：

Attributes.getValue(int)

getIndex

public int getIndex(String uri,
                    String localName)

通過名稱空間名稱尋找屬性的索引。

在許多情況下，尋找一次名稱並使用索引查詢方法而不重複使用名稱查詢方法是非常有效的。

指定者：

介面 Attributes 中的 getIndex

參數：

uri - 屬性的名稱空間 URI，如果沒有可用的，則為空字元串。

localName - 屬性的本地名稱。

返回：

屬性的索引，如果沒有任何內容相比對，則返回 -1。

另請參見：

Attributes.getIndex(java.lang.String,java.lang.String)

getIndex

public int getIndex(String qName)

通過限定（加前綴的）名稱尋找屬性的索引。

指定者：

介面 Attributes 中的 getIndex

參數：

qName - 限定的名稱。

返回：

屬性的索引，如果沒有任何內容相比對，則返回 -1。

另請參見：

Attributes.getIndex(java.lang.String)

getType

public String getType(String uri,
                      String localName)

通過限定名稱空間的名稱尋找屬性的型別。

指定者：

介面 Attributes 中的 getType

參數：

uri - 名稱空間 URI，對於不帶顯式的名稱空間 URI 的名稱，則為空字元串。

localName - 本地名稱。

返回：

屬性的型別，如果沒有任何比對的屬性，則為 null。

另請參見：

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

getType

public String getType(String qName)

通過限定（加前綴的）名稱尋找屬性的型別。

指定者：

介面 Attributes 中的 getType

參數：

qName - 限定的名稱。

返回：

屬性的型別，如果沒有任何比對的屬性，則為 null。

另請參見：

Attributes.getType(java.lang.String)

getValue

public String getValue(String uri,
                       String localName)

通過限定名稱空間的名稱尋找屬性的值。

指定者：

介面 Attributes 中的 getValue

參數：

uri - 名稱空間 URI，對於不帶顯式名稱空間 URI 的名稱，則為空字元串。

localName - 本地名稱。

返回：

屬性的值，如果沒有任何比對的屬性，則為 null。

另請參見：

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

getValue

public String getValue(String qName)

通過限定（加前綴的）名稱尋找屬性的值。

指定者：

介面 Attributes 中的 getValue

參數：

qName - 限定的名稱。

返回：

屬性的值，如果沒有任何比對的屬性，則為 null。

另請參見：

Attributes.getValue(java.lang.String)

clear

public void clear()

為了重用而清除屬性列表。

注意，此調用幾乎不釋放記憶體：保存當前陣列，以便重用。

setAttributes

public void setAttributes(Attributes atts)

複製整個 Attributes 物件。

重用現有對象比不斷分派新物件更高效。

參數：

atts - 要複製的屬性。

addAttribute

public void addAttribute(String uri,
                         String localName,
                         String qName,
                         String type,
                         String value)

將屬性添加到列表的末尾。

由於速度的原因，此方法將不進行檢查以查看屬性是否已在列表中：這由應用程序負責。

參數：

uri - 名稱空間 URI，如果沒有可用的，或不是正在執行名稱空間處理，則為空字元串。

localName - 本地名稱，如果不是正在執行名稱空間處理，則為空字元串。

qName - 限定（加前綴的）名稱，如果限定名稱不可用，則為空字元串。

type - 字元串形式的屬性型別。

value - 屬性值。

setAttribute

public void setAttribute(int index,
                         String uri,
                         String localName,
                         String qName,
                         String type,
                         String value)

在列表中設置屬性。

由於速度的原因，此方法不檢查名稱是否衝突或格式是否良好：此類別檢查由應用程序負責。

參數：

index - 屬性的索引（從零開始）。

uri - 名稱空間 URI，如果沒有，或不是正在執行名稱空間處理，則為空字元串。

localName - 本地名稱，如果不是正在執行名稱空間處理，則為空字元串。

qName - 限定的名稱，如果限定的名稱不可用，則為空字元串。

type - 字元串形式的屬性型別。

value - 屬性值。

拋出：

ArrayIndexOutOfBoundsException - 當提供的索引不指向列表中的屬性時。

removeAttribute

public void removeAttribute(int index)

從列表移除屬性。

參數：

index - 屬性的索引（從零開始）。

拋出：

ArrayIndexOutOfBoundsException - 當提供的索引不指向列表中的屬性時。

setURI

public void setURI(int index,
                   String uri)

設置特定屬性的名稱空間 URI。

參數：

index - 屬性的索引（從零開始）。

uri - 屬性的名稱空間 URI，如果沒有，則為空字元串。

拋出：

ArrayIndexOutOfBoundsException - 當提供的索引不指向列表中的屬性時。

setLocalName

public void setLocalName(int index,
                         String localName)

設置特定屬性的本地名稱。

參數：

index - 屬性的索引（從零開始）。

localName - 屬性的本地名稱，如果沒有，則為空字元串。

拋出：

ArrayIndexOutOfBoundsException - 當提供的索引不指向列表中的屬性時。

setQName

public void setQName(int index,
                     String qName)

設置特定屬性的限定名稱。

參數：

index - 屬性的索引（從零開始）。

qName - 屬性的限定名稱，如果沒有，則為空字元串。

拋出：

ArrayIndexOutOfBoundsException - 當提供的索引不指向列表中的屬性時。

setType

public void setType(int index,
                    String type)

設置特定屬性的型別。

參數：

index - 屬性的索引（從零開始）。

type - 屬性的型別。

拋出：

ArrayIndexOutOfBoundsException - 當提供的索引不指向列表中的屬性時。

setValue

public void setValue(int index,
                     String value)

設置特定屬性的值。

參數：

index - 屬性的索引（從零開始）。

value - 屬性的值。

拋出：

ArrayIndexOutOfBoundsException - 當提供的索引不指向列表中的屬性時。