JavaTM 2 Platform
Standard Ed. 5.0

org.xml.sax.helpers
类 AttributeListImpl

java.lang.Object
  继承者 org.xml.sax.helpers.AttributeListImpl
所有已实现的接口:
AttributeList

已过时。 此类实现不推荐使用的接口 AttributeList;该接口已被 AttributesImpl 帮助器类中实现的 Attributes 取代。

public class AttributeListImpl
extends Object
implements AttributeList

AttributeList 的默认实现。

此模块(包括源代码和文档)位于公共域中,对该模块不提供担保有关更多信息,请参阅http://www.saxproject.org

AttributeList 实现不推荐使用的 SAX1 AttributeList 接口,它已被新的 SAX2 AttributesImpl 接口取代。

此类提供 SAX AttributeList 接口的有用实现。此实现对于 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 的实现;仅作为可选的便捷方法提供它。尤其是,鼓励解析器编写者发明更有效的实现。

从以下版本开始:
SAX 1.0
另请参见:
AttributeList, DocumentHandler.startElement(java.lang.String, org.xml.sax.AttributeList)

构造方法摘要
AttributeListImpl()
          已过时。 创建空的属性列表。
AttributeListImpl(AttributeList atts)
          已过时。 构造现有属性列表的持久副本。
 
方法摘要
 void addAttribute(String name, String type, String value)
          已过时。 向属性列表添加属性。
 void clear()
          已过时。 清除属性列表。
 int getLength()
          已过时。 返回列表中的属性个数。
 String getName(int i)
          已过时。 获取属性名称(按位置)。
 String getType(int i)
          已过时。 获取属性的类型(按位置)。
 String getType(String name)
          已过时。 获取属性的类型(按名称)。
 String getValue(int i)
          已过时。 获取属性的值(按位置)。
 String getValue(String name)
          已过时。 获取属性的值(按名称)。
 void removeAttribute(String name)
          已过时。 从列表移除属性。
 void setAttributeList(AttributeList atts)
          已过时。 设置属性列表,丢弃以前的内容。
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

构造方法详细信息

AttributeListImpl

public AttributeListImpl()
已过时。 
创建空的属性列表。

此构造方法对解析器编写者非常有用,解析器编写者将使用它创建单个的、可重用的属性列表,使用元素之间的 clear 方法可以重设该列表。

另请参见:
addAttribute(java.lang.String, java.lang.String, java.lang.String), clear()

AttributeListImpl

public AttributeListImpl(AttributeList atts)
已过时。 
构造现有属性列表的持久副本。

此构造方法对应用程序编写者非常有用,应用程序编写者将使用它创建现有属性列表的持久副本。

参数:
atts - 要复制的属性列表
另请参见:
DocumentHandler.startElement(java.lang.String, org.xml.sax.AttributeList)
方法详细信息

setAttributeList

public void setAttributeList(AttributeList atts)
已过时。 
设置属性列表,丢弃以前的内容。

此方法允许应用程序编写者容易地重用属性列表。

参数:
atts - 要复制的属性列表。

addAttribute

public void addAttribute(String name,
                         String type,
                         String value)
已过时。 
向属性列表添加属性。

为 SAX 解析器编写者提供此方法,以允许他们在将属性列表传递给应用程序之前以增量方式构建它。

参数:
name - 属性名称。
type - 属性类型(对于枚举为 "NMTOKEN")。
value - 属性值(不得为 null)。
另请参见:
removeAttribute(java.lang.String), DocumentHandler.startElement(java.lang.String, org.xml.sax.AttributeList)

removeAttribute

public void removeAttribute(String name)
已过时。 
从列表移除属性。

SAX 应用程序编写者可以使用此方法从 AttributeList 中过滤属性。注意,调用此方法会更改属性列表的长度和一些属性的索引。

如果请求的属性不在列表中,则这是无操作。

参数:
name - 属性名称。
另请参见:
addAttribute(java.lang.String, java.lang.String, java.lang.String)

clear

public void clear()
已过时。 
清除属性列表。

SAX 解析器编写者可以使用此方法重设 DocumentHandler.startElement 事件之间的属性列表。通常,重用同一 AttributeListImpl 对象,而不每次分配一个新对象是有意义的。

另请参见:
DocumentHandler.startElement(java.lang.String, org.xml.sax.AttributeList)

getLength

public int getLength()
已过时。 
返回列表中的属性个数。

指定者:
接口 AttributeList 中的 getLength
返回:
此列表中的属性个数。
另请参见:
AttributeList.getLength()

getName

public String getName(int i)
已过时。 
获取属性名称(按位置)。

指定者:
接口 AttributeList 中的 getName
参数:
i - 列表中属性的位置。
返回:
字符串形式的属性名称,如果在该位置没有属性,则返回 null。
另请参见:
AttributeList.getName(int)

getType

public String getType(int i)
已过时。 
获取属性的类型(按位置)。

指定者:
接口 AttributeList 中的 getType
参数:
i - 列表中属性的位置。
返回:
字符串形式的属性类型(对于枚举为“NMTOKEN”,如果没有读取声明,则为“CDATA”),如果在该位置没有属性,则返回 null。
另请参见:
AttributeList.getType(int)

getValue

public String getValue(int i)
已过时。 
获取属性的值(按位置)。

指定者:
接口 AttributeList 中的 getValue
参数:
i - 列表中属性的位置。
返回:
字符串形式的属性值,如果在该位置没有属性,则返回 null。
另请参见:
AttributeList.getValue(int)

getType

public String getType(String name)
已过时。 
获取属性的类型(按名称)。

指定者:
接口 AttributeList 中的 getType
参数:
name - 属性名称。
返回:
字符串形式的属性类型(对于枚举为“NMTOKEN”,如果没有读取声明,则为“CDATA”)。
另请参见:
AttributeList.getType(java.lang.String)

getValue

public String getValue(String name)
已过时。 
获取属性的值(按名称)。

指定者:
接口 AttributeList 中的 getValue
参数:
name - 属性名称。
返回:
字符串形式的属性值,如果不存在此类属性,则返回 null。
另请参见:
AttributeList.getValue(java.lang.String)

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策