Attributes (Java Platform SE 8 )

All Known Subinterfaces:

Attributes2

所有已知实现类：

Attributes2Impl ， AttributesImpl
```
public interface Attributes
```
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.

此界面允许以三种不同的方式访问属性列表：
1. 按属性索引;
2. 通过命名空间限定名; 要么
3. 通过合格（前缀）名称。
该列表将不包含声明为#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接口，该接口不包含命名空间支持。除了支持Namespace，它还添加了getIndex方法（下面）。

列表中属性的顺序是未指定的，并且将根据实现而不同。
从以下版本开始：

SAX 2.0

另请参见：

AttributesImpl ， DeclHandler.attributeDecl(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String)

方法摘要

所有方法接口方法抽象方法
Modifier and Type	Method and Description
`int`	`getIndex(String qName)` 通过XML合格（前缀）名称查找属性的索引。
`int`	`getIndex(String uri, String localName)` 通过命名空间名称查找属性的索引。
`int`	`getLength()` 返回列表中的属性数。
`String`	`getLocalName(int index)` 通过索引查找属性的本地名称。
`String`	`getQName(int index)` 通过索引查找属性的XML限定（前缀）名称。
`String`	`getType(int index)` 通过索引查找属性的类型。
`String`	`getType(String qName)` 通过XML合格（前缀）名称查找属性的类型。
`String`	`getType(String uri, String localName)` 通过命名空间名称查找属性的类型。
`String`	`getURI(int index)` 通过索引查找属性的Namespace URI。
`String`	`getValue(int index)` 通过索引查找属性的值。
`String`	`getValue(String qName)` 通过XML限定（前缀）名称查找属性的值。
`String`	`getValue(String uri, String localName)` 通过命名空间名称查找属性的值。

- 方法详细信息
  - getLength
```
int getLength()
```
    返回列表中的属性数。
    一旦你知道属性的数量，你可以遍历列表。
    
    结果
    
    列表中的属性数。
    
    另请参见：
    
    getURI(int) ， getLocalName(int) ， getQName(int) ， getType(int) ， getValue(int)
  - getURI
```
String getURI(int index)
```
    通过索引查找属性的Namespace URI。
    
    参数
    
    index - 属性索引（从零开始）。
    
    结果
    
    命名空间URI，如果没有可用，则为空字符串，如果索引超出范围，则为空。
    
    另请参见：
    
    getLength()
  - getLocalName
```
String getLocalName(int index)
```
    通过索引查找属性的本地名称。
    
    参数
    
    index - 属性索引（从零开始）。
    
    结果
    
    如果未执行命名空间处理，则为本地名称或空字符串，如果索引超出范围，则为null。
    
    另请参见：
    
    getLength()
  - getQName
```
String getQName(int index)
```
    通过索引查找属性的XML限定（前缀）名称。
    
    参数
    
    index - 属性索引（从零开始）。
    
    结果
    
    XML限定名称，如果没有可用，则为空字符串;如果索引超出范围，则为null。
    
    另请参见：
    
    getLength()
  - getType
```
String getType(int index)
```
    通过索引查找属性的类型。
    属性类型是字符串“CDATA”，“ID”，“IDREF”，“IDREFS”，“NMTOKEN”，“NMTOKENS”，“ENTITY”，“ENTITIES”或“符号”（总是大写）。
    
    如果解析器没有读取属性的声明，或者解析器没有报告属性类型，那么它必须返回值为“CDATA”，如XML 1.0建议书（第3.3.3节“属性值归一化” ）。
    
    对于不是符号的枚举属性，解析器将将类型报告为“NMTOKEN”。
    
    参数
    
    index - 属性索引（从零开始）。
    
    结果
    
    属性的类型为字符串，如果索引超出范围，则为null。
    
    另请参见：
    
    getLength()
  - getValue
```
String getValue(int index)
```
    通过索引查找属性的值。
    如果属性值是令牌列表（IDREFS，ENTITIES或NMTOKENS），令牌将被连接成一个字符串，每个令牌由单个空格分隔。
    
    参数
    
    index - 属性索引（从零开始）。
    
    结果
    
    属性的值作为字符串，如果索引超出范围，则为null。
    
    另请参见：
    
    getLength()
  - getIndex
```
int getIndex(String uri,
             String localName)
```
    通过命名空间名称查找属性的索引。
    
    参数
    
    uri - 名称空间URI，如果名称没有命名空间URI，则为空字符串。
    
    localName - 属性的本地名称。
    
    结果
    
    属性的索引，如果没有出现在列表中，则为-1。
  - getIndex
```
int getIndex(String qName)
```
    通过XML合格（前缀）名称查找属性的索引。
    
    参数
    
    qName - 合格（前缀）名称。
    
    结果
    
    属性的索引，如果没有出现在列表中，则为-1。
  - getType
```
String getType(String uri,
               String localName)
```
    通过命名空间名称查找属性的类型。
    有关可能的类型的描述，请参阅getType(int) 。
    
    参数
    
    uri - 名称空间URI，如果名称没有命名空间URI，则为空字符串。
    
    localName - localName的本地名称。
    
    结果
    
    属性类型为字符串，如果属性不在列表中，则为空，或者如果未执行命名空间处理。
  - getType
```
String getType(String qName)
```
    通过XML合格（前缀）名称查找属性的类型。
    有关可能的类型的描述，请参阅getType(int) 。
    
    参数
    
    qName - XML限定名称。
    
    结果
    
    属性类型作为字符串，如果属性不在列表中，或者限定名称不可用，则为null。
  - getValue
```
String getValue(String uri,
                String localName)
```
    通过命名空间名称查找属性的值。
    有关可能的值的说明，请参见getValue(int) 。
    
    参数
    
    uri - 名称空间URI，如果名称没有命名空间URI，则为空字符串。
    
    localName - localName的本地名称。
    
    结果
    
    属性值作为字符串，如果属性不在列表中，则为null。
  - getValue
```
String getValue(String qName)
```
    通过XML限定（前缀）名称查找属性的值。
    有关可能值的说明，请参阅getValue(int) 。
    
    参数
    
    qName - XML限定名称。
    
    结果
    
    The attribute value as a string, or null if the attribute is not in the list or if qualified names are not available.

Interface Attributes

方法摘要

方法详细信息

getLength

getURI

getLocalName

getQName

getType

getValue

getIndex

getIndex

getType

getType

getValue

getValue