compact2, compact3

org.xml.sax

Interface Attributes

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. 合格（前缀）的名字。

列表不包含属性，被宣布#暗示但在开始标签不指定。它也将不包含作为命名空间声明的属性（xmlns *）除非http://xml.org/sax/features/namespace-prefixes功能设置为真正的（这是假默认）。因为SAX2符合原来的“XML命名空间”的建议，它通常不给属性的命名空间URI命名空间声明。

SAX2解析器可以支持一些使用一个可选的特征标志（http://xml.org/sax/features/xmlns-uris）要求这些属性被赋予的URI，符合后向后兼容的修改建议。（属性的本地名称”将前缀，或“xmlns”定义一个默认的元素的命名空间。当）携带，处理代码要解决冲突，而不是要求解析器可以改变特征标志的设置。

如果命名空间前缀特征（见上图）是假，由合格的名称访问可能不可用；如果http://xml.org/sax/features/namespaces特征是假，通过命名空间限定名来访问不可用。

这个接口取代了过时的SAX1 AttributeList接口，其中不包含命名空间的支持。除了命名空间支持，增加了getindex方法（下）。

列表中的属性的顺序是未指定的，并且将从实现到实现有所不同。

从以下版本开始：

萨克斯2

另请参见：

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) 看一个属性的命名空间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)

看一个属性的命名空间URI的指数。

参数

index -属性索引（从零开始）。

结果

命名空间URI，或空字符串，如果没有可用的，或null，如果索引超出范围。

另请参见：

getLength()

getLocalName

String getLocalName(int index)

用索引查找属性的本地名称。

参数

index -属性索引（从零开始）。

结果

如果没有执行命名空间处理的空字符串或空字符串，如果索引不在范围内，则为空。

另请参见：

getLength()

getQName

String getQName(int index)

看一个属性的XML合格（前缀）名称索引。

参数

index -属性索引（从零开始）。

结果

如果没有可用的XML限定的名称，或空字符串，或者如果索引不在范围内，则为null。

另请参见：

getLength()

getType

String getType(int index)

用索引查找属性的类型。

属性的类型是一个字符串“我”、“本我”、“象征”、“IDREFS”、“象征”、“这些”、“实体”，“实体”，或“符号”（大写）。

如果解析器未读的属性声明，或如果解析器不报告的属性类型，那么它必须返回值“是”作为XML 1推荐说明（第3.3.3，”属性值标准化”）。

对于一个枚举属性，不是一个符号，解析器将报告类型为“象征”。

参数

index -属性索引（从零开始）。

结果

属性的类型作为一个字符串，或空，如果索引是不在范围内。

另请参见：

getLength()

getValue

String getValue(int index)

用索引查找属性的值。

如果属性值是一个列表的标记（IDREFS，实体，或NMTOKENS），令牌将被连接成一个与每个标记用一个空格隔开单个字符串。

参数

index -属性索引（从零开始）。

结果

属性的值作为一个字符串，或为空，如果索引是不在范围内。

另请参见：

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 -属性的本地名称。

结果

如果属性不在列表中，或者如果不执行命名空间处理，则属性类型为字符串或为空。

getType

String getType(String qName)

查合格的XML属性的类型（前缀）的名字。

看到一个描述可能的类型getType(int)。

参数

qName - XML限定名。

结果

属性类型为字符串，或为空，如果属性不在列表中，或如果没有合格的名称。

getValue

String getValue(String uri,
                String localName)

通过命名空间名称查找属性的值。

看到一个描述可能的值getValue(int)。

参数

uri的命名空间URI或空字符串，如果名字没有命名空间URI。

localName -属性的本地名称。

结果

属性值作为字符串或属性值，如果属性不在列表中。

getValue

String getValue(String qName)

查一个属性的值由XML合格（前缀）的名字。

看到一个描述可能的值getValue(int)。

参数

qName - XML限定名。

结果

属性值为字符串，或为空，如果属性不在列表中，或如果没有合格的名称。