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 之外的任何型別，則它必須已宣告。

從以下版本開始：

SAX 2.0 (extensions 1.1 alpha)

方法摘要

boolean	isDeclared(int index) 返回 false，除非在 DTD 中宣告了該屬性。
boolean	isDeclared(String qName) 返回 false，除非在 DTD 中宣告該屬性。
boolean	isDeclared(String uri, String localName) 返回 false，除非在 DTD 中宣告屬性。
boolean	isSpecified(int index) 返回 true，除非 DTD 預設提供屬性值。
boolean	isSpecified(String qName) 返回 true，除非由 DTD 預設提供屬性值。
boolean	isSpecified(String uri, String localName) 返回 true，除非由 DTD 預設提供屬性值。

從介面 org.xml.sax.Attributes 繼承的方法

getIndex, getIndex, getLength, getLocalName, getQName, getType, getType, getType, getURI, getValue, getValue, getValue

方法詳細資訊

isDeclared

boolean isDeclared(int index)

返回 false，除非在 DTD 中宣告了該屬性。這有助於區別 SAX 報告為 CDATA 的兩種屬性：宣告的屬性（因此，通常是有效的）和未宣告的屬性（永遠是無效的）。

參數：

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

返回：

如果在 DTD 中宣告屬性，則返回 true，否則返回 false。

拋出：

ArrayIndexOutOfBoundsException - 當提供的索引不標識屬性時。

isDeclared

boolean isDeclared(String qName)

返回 false，除非在 DTD 中宣告該屬性。這有助於區別 SAX 報告為 CDATA 的兩種屬性：宣告的屬性（因此，通常是有效的）和未宣告的屬性（永遠是無效的）。

參數：

qName - XML 限定（加前綴的)名稱。

返回：

如果在 DTD 中宣告屬性，則返回 true，否則返回 false。

拋出：

IllegalArgumentException - 當提供的名稱不標識屬性時。

isDeclared

boolean isDeclared(String uri,
                   String localName)

返回 false，除非在 DTD 中宣告屬性。這有助於區別 SAX 報告為 CDATA 的兩種屬性：宣告的屬性（因此，通常是有效的）和未宣告的屬性（永遠是無效的）。

請記住，由於 DTD 不能“理解”名稱空間，所以與屬性關聯的名稱空間 URI 不可以來自 DTD。該宣告將會應用於屬性的 qName。

參數：

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

localName - 屬性的本地名稱。

返回：

如果在 DTD 中宣告屬性，則返回 true，否則返回 false。

拋出：

IllegalArgumentException - 當提供的名稱不標識屬性時。

isSpecified

boolean isSpecified(int index)

返回 true，除非 DTD 預設提供屬性值。

參數：

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

返回：

如果在 XML 文本中找到該值，則返回 true，如果由 DTD 預設提供值，則返回 false。

拋出：

ArrayIndexOutOfBoundsException - 當提供的索引不標識屬性時。

isSpecified

boolean isSpecified(String uri,
                    String localName)

返回 true，除非由 DTD 預設提供屬性值。

請記住，由於 DTD 不能“理解”名稱空間，所以與屬性關聯的名稱空間 URI 不可以來自 DTD。該宣告將會應用於屬性的 qName。

參數：

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

localName - 屬性的本地名稱。

返回：

如果在 XML 文本中找到該值，則返回 true，如果由 DTD 預設提供值，則返回 false。

拋出：

IllegalArgumentException - 當提供的名稱不標識屬性時。

isSpecified

boolean isSpecified(String qName)

返回 true，除非由 DTD 預設提供屬性值。

參數：

qName - XML 限定（加前綴的)名稱。

返回：

如果在 XML 文本中找到該值，則返回 true，如果由 DTD 預設提供值，則返回 false。

拋出：

IllegalArgumentException - 當提供的名稱不標識屬性時。