public interface Attributes
| org.xml.sax.Attributes |
 Known Indirect Subclasses
|
用于XML属性列表的接口。
This module, both source code and documentation, is in the Public Domain, and comes with NO WARRANTY. See http://www.saxproject.org for further information.
该接口允许以三种不同的方式访问属性列表：
该列表将不包含已声明#IMPLIED但未在开始标记中指定的属性。 除非http://xml.org/sax/features/namespace-prefixes功能设置为true （默认为false ），否则它将不包含用作名称空间声明（xmlns *）的http://xml.org/sax/features/namespace-prefixes 。 由于SAX2符合原来的“XML中的命名空间”建议，它通常不会为命名空间声明属性提供名称空间URI。
某些SAX2解析器可能支持使用可选功能标志（ http://xml.org/sax/features/xmlns-uris ）来请求为这些属性提供URI，以符合该建议的稍后向后不兼容的修订。 （定义默认元素名称空间时，属性的“本地名称”将成为前缀或“xmlns”。）为便于携带，处理程序代码应始终解决该冲突，而不要求可更改该功能标志设置的解析器。
如果名称空间前缀功能（如上所述）为false ，则可能无法使用限定名称进行访问; 如果http://xml.org/sax/features/namespaces功能为false ，则通过名称空间限定名称的访问可能不可用。
此接口取代了现在不推荐使用的SAX1 AttributeList接口，该接口不包含名称空间支持。 除了命名空间支持外，它还添加了getIndex方法（见下文）。
列表中的属性顺序未指定，并且因实现而异。
Public methods |
|
|---|---|
abstract int |
getIndex(String qName) 通过XML限定（前缀）名称查找属性的索引。 |
abstract int |
getIndex(String uri, String localName) 按名称空间名称查找属性的索引。 |
abstract int |
getLength() 返回列表中的属性数量。 |
abstract String |
getLocalName(int index) 通过索引查找属性的本地名称。 |
abstract String |
getQName(int index) 按索引查找属性的XML限定（前缀）名称。 |
abstract String |
getType(String qName) 按XML限定（前缀）名称查找属性的类型。 |
abstract String |
getType(int index) 按索引查找属性的类型。 |
abstract String |
getType(String uri, String localName) 按名称空间名称查找属性的类型。 |
abstract String |
getURI(int index) 通过索引查找属性的名称空间URI。 |
abstract String |
getValue(String qName) 按XML限定（前缀）名称查找属性的值。 |
abstract String |
getValue(int index) 按索引查找属性值。 |
abstract String |
getValue(String uri, String localName) 按名称空间名称查找属性值。 |
int getIndex (String qName)
通过XML限定（前缀）名称查找属性的索引。
| Parameters | |
|---|---|
qName |
String: The qualified (prefixed) name. |
| Returns | |
|---|---|
int |
The index of the attribute, or -1 if it does not appear in the list. |
int getIndex (String uri, String localName)
按名称空间名称查找属性的索引。
| Parameters | |
|---|---|
uri |
String: The Namespace URI, or the empty string if the name has no Namespace URI. |
localName |
String: The attribute's local name. |
| Returns | |
|---|---|
int |
The index of the attribute, or -1 if it does not appear in the list. |
int getLength ()
返回列表中的属性数量。
一旦你知道了属性的数量，你可以迭代整个列表。
| Returns | |
|---|---|
int |
The number of attributes in the list. |
String getLocalName (int index)
通过索引查找属性的本地名称。
| Parameters | |
|---|---|
index |
int: The attribute index (zero-based). |
| Returns | |
|---|---|
String |
The local name, or the empty string if Namespace processing is not being performed, or null if the index is out of range. |
也可以看看：
String getQName (int index)
按索引查找属性的XML限定（前缀）名称。
| Parameters | |
|---|---|
index |
int: The attribute index (zero-based). |
| Returns | |
|---|---|
String |
The XML qualified name, or the empty string if none is available, or null if the index is out of range. |
也可以看看：
String getType (String qName)
按XML限定（前缀）名称查找属性的类型。
有关可能的类型的描述，请参阅 getType(int) 。
| Parameters | |
|---|---|
qName |
String: The XML qualified name. |
| Returns | |
|---|---|
String |
The attribute type as a string, or null if the attribute is not in the list or if qualified names are not available. |
String getType (int index)
按索引查找属性的类型。
属性类型是字符串“CDATA”，“ID”，“IDREF”，“IDREFS”，“NMTOKEN”，“NMTOKENS”，“ENTITY”，“ENTITIES”或“NOTATION”中的一个（始终为大写） 。
如果解析器没有读取属性声明，或者解析器没有报告属性类型，那么它必须按照XML 1.0建议书（第3.3.3节“属性值标准化”）中的规定返回值“CDATA” ）。
对于不是符号的枚举属性，解析器将报告类型为“NMTOKEN”。
| Parameters | |
|---|---|
index |
int: The attribute index (zero-based). |
| Returns | |
|---|---|
String |
The attribute's type as a string, or null if the index is out of range. |
也可以看看：
String getType (String uri, String localName)
按名称空间名称查找属性的类型。
See getType(int) for a description of the possible types.
| Parameters | |
|---|---|
uri |
String: The Namespace URI, or the empty String if the name has no Namespace URI. |
localName |
String: The local name of the attribute. |
| Returns | |
|---|---|
String |
The attribute type as a string, or null if the attribute is not in the list or if Namespace processing is not being performed. |
String getURI (int index)
通过索引查找属性的名称空间URI。
| Parameters | |
|---|---|
index |
int: The attribute index (zero-based). |
| Returns | |
|---|---|
String |
The Namespace URI, or the empty string if none is available, or null if the index is out of range. |
也可以看看：
String getValue (String qName)
按XML限定（前缀）名称查找属性的值。
有关可能的值的描述，请参阅 getValue(int) 。
| Parameters | |
|---|---|
qName |
String: The XML qualified name. |
| Returns | |
|---|---|
String |
The attribute value as a string, or null if the attribute is not in the list or if qualified names are not available. |
String getValue (int index)
按索引查找属性值。
如果属性值是标记列表（IDREFS，ENTITIES或NMTOKENS），则令牌将连接成单个字符串，每个令牌由一个空格分隔。
| Parameters | |
|---|---|
index |
int: The attribute index (zero-based). |
| Returns | |
|---|---|
String |
The attribute's value as a string, or null if the index is out of range. |
也可以看看：
String getValue (String uri, String localName)
按名称空间名称查找属性值。
请参阅 getValue(int)了解可能的值的描述。
| Parameters | |
|---|---|
uri |
String: The Namespace URI, or the empty String if the name has no Namespace URI. |
localName |
String: The local name of the attribute. |
| Returns | |
|---|---|
String |
The attribute value as a string, or null if the attribute is not in the list. |
Android开发手册