public class AttributeListImpl
extends Object
implements AttributeList
java.lang.Object | |
↳ | org.xml.sax.helpers.AttributeListImpl |
此类已在API级别1中弃用。
该类实现了不赞成使用的接口, AttributeList
; 该接口已由Attributes
取代,该接口在AttributesImpl
辅助类中实现。
AttributeList的默认实现。
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.
AttributeList实现了已弃用的SAX1 AttributeList
接口,并已被新的SAX2 AttributesImpl
接口所取代。
该类提供了SAX AttributeList
接口的便利实现。 这个实现对于SAX解析器编写者都是有用的,他们可以使用它为应用程序提供属性,对于SAX应用程序编写者来说,SAX编写者可以使用它来创建元素属性规范的永久拷贝:
private AttributeList myatts; public void startElement (String name, AttributeList atts) { // create a persistent copy of the attribute list // for use outside this method myatts = new AttributeListImpl(atts); [...] }
请注意,SAX解析器不需要使用这个类来提供AttributeList的实现; 它仅作为可选的便利提供。 特别是鼓励解析器编写者发明更高效的实现。
Public constructors |
|
---|---|
AttributeListImpl() 创建一个空属性列表。 |
|
AttributeListImpl(AttributeList atts) 构建现有属性列表的持久副本。 |
Public methods |
|
---|---|
void |
addAttribute(String name, String type, String value) 将属性添加到属性列表。 |
void |
clear() 清除属性列表。 |
int |
getLength() 返回列表中的属性数量。 |
String |
getName(int i) 获取属性的名称(按位置)。 |
String |
getType(String name) 获取属性的类型(按名称)。 |
String |
getType(int i) 获取属性的类型(按位置)。 |
String |
getValue(String name) 获取属性的值(按名称)。 |
String |
getValue(int i) 获取属性的值(按位置)。 |
void |
removeAttribute(String name) 从列表中删除一个属性。 |
void |
setAttributeList(AttributeList atts) 设置属性列表,放弃以前的内容。 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
|
From interface org.xml.sax.AttributeList
|
AttributeListImpl ()
创建一个空属性列表。
这个构造函数对解析器编写者非常有用,他们将使用它创建一个单一的可重用属性列表,该列表可以使用元素之间的clear方法进行重置。
AttributeListImpl (AttributeList atts)
构建现有属性列表的持久副本。
这个构造函数对于应用程序编写者来说最为有用,他们将使用它来创建现有属性列表的持久副本。
Parameters | |
---|---|
atts |
AttributeList : The attribute list to copy |
void addAttribute (String name, String type, String value)
将属性添加到属性列表。
这个方法是为SAX解析器编写者提供的,以允许他们在递交给应用程序之前递增地构建一个属性列表。
Parameters | |
---|---|
name |
String : The attribute name. |
type |
String : The attribute type ("NMTOKEN" for an enumeration). |
value |
String : The attribute value (must not be null). |
void clear ()
清除属性列表。
SAX parser writers can use this method to reset the attribute list between DocumentHandler.startElement events. Normally, it will make sense to reuse the same AttributeListImpl object rather than allocating a new one each time.
int getLength ()
返回列表中的属性数量。
Returns | |
---|---|
int |
The number of attributes in the list. |
也可以看看:
String getName (int i)
获取属性的名称(按位置)。
Parameters | |
---|---|
i |
int : The position of the attribute in the list. |
Returns | |
---|---|
String |
The attribute name as a string, or null if there is no attribute at that position. |
也可以看看:
String getType (String name)
获取属性的类型(按名称)。
Parameters | |
---|---|
name |
String : The attribute name. |
Returns | |
---|---|
String |
The attribute type as a string ("NMTOKEN" for an enumeration, and "CDATA" if no declaration was read). |
也可以看看:
String getType (int i)
获取属性的类型(按位置)。
Parameters | |
---|---|
i |
int : The position of the attribute in the list. |
Returns | |
---|---|
String |
The attribute type as a string ("NMTOKEN" for an enumeration, and "CDATA" if no declaration was read), or null if there is no attribute at that position. |
也可以看看:
String getValue (String name)
获取属性的值(按名称)。
Parameters | |
---|---|
name |
String : The attribute name. |
Returns | |
---|---|
String |
the named attribute's value or null, if the attribute does not exist. |
也可以看看:
String getValue (int i)
获取属性的值(按位置)。
Parameters | |
---|---|
i |
int : The position of the attribute in the list. |
Returns | |
---|---|
String |
The attribute value as a string, or null if there is no attribute at that position. |
也可以看看:
void removeAttribute (String name)
从列表中删除一个属性。
SAX应用程序编写者可以使用此方法从AttributeList中过滤属性。 请注意,调用此方法将更改属性列表的长度和某些属性的索引。
如果请求的属性不在列表中,则这是无操作。
Parameters | |
---|---|
name |
String : The attribute name. |
void setAttributeList (AttributeList atts)
设置属性列表,放弃以前的内容。
该方法允许应用程序编写者轻松地重用属性列表。
Parameters | |
---|---|
atts |
AttributeList : The attribute list to copy. |