public class AttributesImpl
extends Object
implements Attributes
java.lang.Object | |
↳ | org.xml.sax.helpers.AttributesImpl |
Known Direct Subclasses |
Attributes接口的默认实现。
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.
该类提供了SAX2 Attributes
接口的默认实现,并增加了操纵器,以便可以修改或重用列表。
这个类有两种典型用途:
startElement
event; or此课程取代了现在不推荐使用的SAX1 AttributeListImpl
课程; 除了支持更新的属性接口而不是已弃用的AttributeList
接口外,它还包含使用单个数组而非一组矢量的更高效的实现。
Public constructors |
|
---|---|
AttributesImpl() 构造一个新的,空的AttributesImpl对象。 |
|
AttributesImpl(Attributes atts) 复制现有的属性对象。 |
Public methods |
|
---|---|
void |
addAttribute(String uri, String localName, String qName, String type, String value) 将一个属性添加到列表的末尾。 |
void |
clear() 清除要重用的属性列表。 |
int |
getIndex(String qName) 按合格(前缀)名称查找属性索引。 |
int |
getIndex(String uri, String localName) 按名称空间名称查找属性索引。 |
int |
getLength() 返回列表中的属性数量。 |
String |
getLocalName(int index) 返回属性的本地名称。 |
String |
getQName(int index) 返回属性的合格(前缀)名称。 |
String |
getType(String qName) 按限定(前缀)名称查找属性的类型。 |
String |
getType(int index) 按索引返回属性的类型。 |
String |
getType(String uri, String localName) 按名称空间限定的名称查找属性的类型。 |
String |
getURI(int index) 返回属性的名称空间URI。 |
String |
getValue(String qName) 按限定(前缀)名称查找属性值。 |
String |
getValue(String uri, String localName) 按名称空间限定的名称查找属性值。 |
String |
getValue(int index) 按索引返回属性值。 |
void |
removeAttribute(int index) 从列表中删除一个属性。 |
void |
setAttribute(int index, String uri, String localName, String qName, String type, String value) 在列表中设置一个属性。 |
void |
setAttributes(Attributes atts) 复制整个Attributes对象。 |
void |
setLocalName(int index, String localName) 设置特定属性的本地名称。 |
void |
setQName(int index, String qName) 设置特定属性的限定名称。 |
void |
setType(int index, String type) 设置特定属性的类型。 |
void |
setURI(int index, String uri) 设置特定属性的名称空间URI。 |
void |
setValue(int index, String value) 设置特定属性的值。 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
|
From interface org.xml.sax.Attributes
|
AttributesImpl (Attributes atts)
复制现有的属性对象。
这个构造函数在 startElement
事件中特别有用。
Parameters | |
---|---|
atts |
Attributes : The existing Attributes object. |
void addAttribute (String uri, String localName, String qName, String type, String value)
将一个属性添加到列表的末尾。
为了提高速度,此方法不检查属性是否已经在列表中:这是应用程序的责任。
Parameters | |
---|---|
uri |
String : The Namespace URI, or the empty string if none is available or Namespace processing is not being performed. |
localName |
String : The local name, or the empty string if Namespace processing is not being performed. |
qName |
String : The qualified (prefixed) name, or the empty string if qualified names are not available. |
type |
String : The attribute type as a string. |
value |
String : The attribute value. |
int getIndex (String qName)
按合格(前缀)名称查找属性索引。
Parameters | |
---|---|
qName |
String : The qualified name. |
Returns | |
---|---|
int |
The attribute's index, or -1 if none matches. |
也可以看看:
int getIndex (String uri, String localName)
按名称空间名称查找属性索引。
在许多情况下,查找一次名称并使用索引查询方法而不是重复使用名称查询方法会更有效。
Parameters | |
---|---|
uri |
String : The attribute's Namespace URI, or the empty string if none is available. |
localName |
String : The attribute's local name. |
Returns | |
---|---|
int |
The attribute's index, or -1 if none matches. |
int getLength ()
返回列表中的属性数量。
Returns | |
---|---|
int |
The number of attributes in the list. |
也可以看看:
String getLocalName (int index)
返回属性的本地名称。
Parameters | |
---|---|
index |
int : The attribute's index (zero-based). |
Returns | |
---|---|
String |
The attribute's local name, the empty string if none is available, or null if the index if out of range. |
也可以看看:
String getQName (int index)
返回属性的合格(前缀)名称。
Parameters | |
---|---|
index |
int : The attribute's index (zero-based). |
Returns | |
---|---|
String |
The attribute's qualified name, the empty string if none is available, or null if the index is out of bounds. |
也可以看看:
String getType (String qName)
按限定(前缀)名称查找属性的类型。
Parameters | |
---|---|
qName |
String : The qualified name. |
Returns | |
---|---|
String |
The attribute's type, or null if there is no matching attribute. |
也可以看看:
String getType (int index)
按索引返回属性的类型。
Parameters | |
---|---|
index |
int : The attribute's index (zero-based). |
Returns | |
---|---|
String |
The attribute's type, "CDATA" if the type is unknown, or null if the index is out of bounds. |
也可以看看:
String getType (String uri, String localName)
按名称空间限定的名称查找属性的类型。
Parameters | |
---|---|
uri |
String : The Namespace URI, or the empty string for a name with no explicit Namespace URI. |
localName |
String : The local name. |
Returns | |
---|---|
String |
The attribute's type, or null if there is no matching attribute. |
String getURI (int index)
返回属性的名称空间URI。
Parameters | |
---|---|
index |
int : The attribute's index (zero-based). |
Returns | |
---|---|
String |
The Namespace URI, the empty string if none is available, or null if the index is out of range. |
也可以看看:
String getValue (String qName)
按限定(前缀)名称查找属性值。
Parameters | |
---|---|
qName |
String : The qualified name. |
Returns | |
---|---|
String |
The attribute's value, or null if there is no matching attribute. |
也可以看看:
String getValue (String uri, String localName)
按名称空间限定的名称查找属性值。
Parameters | |
---|---|
uri |
String : The Namespace URI, or the empty string for a name with no explicit Namespace URI. |
localName |
String : The local name. |
Returns | |
---|---|
String |
The attribute's value, or null if there is no matching attribute. |
String getValue (int index)
按索引返回属性值。
Parameters | |
---|---|
index |
int : The attribute's index (zero-based). |
Returns | |
---|---|
String |
The attribute's value or null if the index is out of bounds. |
也可以看看:
void removeAttribute (int index)
从列表中删除一个属性。
Parameters | |
---|---|
index |
int : The index of the attribute (zero-based). |
Throws | |
---|---|
ArrayIndexOutOfBoundsException |
When the supplied index does not point to an attribute in the list. |
void setAttribute (int index, String uri, String localName, String qName, String type, String value)
在列表中设置一个属性。
为了提高速度,此方法不会检查名称冲突或格式良好:此类检查是应用程序的责任。
Parameters | |
---|---|
index |
int : The index of the attribute (zero-based). |
uri |
String : The Namespace URI, or the empty string if none is available or Namespace processing is not being performed. |
localName |
String : The local name, or the empty string if Namespace processing is not being performed. |
qName |
String : The qualified name, or the empty string if qualified names are not available. |
type |
String : The attribute type as a string. |
value |
String : The attribute value. |
Throws | |
---|---|
ArrayIndexOutOfBoundsException |
When the supplied index does not point to an attribute in the list. |
void setAttributes (Attributes atts)
复制整个Attributes对象。
重复使用现有对象而不是不断分配新对象可能更有效。
Parameters | |
---|---|
atts |
Attributes : The attributes to copy. |
void setLocalName (int index, String localName)
设置特定属性的本地名称。
Parameters | |
---|---|
index |
int : The index of the attribute (zero-based). |
localName |
String : The attribute's local name, or the empty string for none. |
Throws | |
---|---|
ArrayIndexOutOfBoundsException |
When the supplied index does not point to an attribute in the list. |
void setQName (int index, String qName)
设置特定属性的限定名称。
Parameters | |
---|---|
index |
int : The index of the attribute (zero-based). |
qName |
String : The attribute's qualified name, or the empty string for none. |
Throws | |
---|---|
ArrayIndexOutOfBoundsException |
When the supplied index does not point to an attribute in the list. |
void setType (int index, String type)
设置特定属性的类型。
Parameters | |
---|---|
index |
int : The index of the attribute (zero-based). |
type |
String : The attribute's type. |
Throws | |
---|---|
ArrayIndexOutOfBoundsException |
When the supplied index does not point to an attribute in the list. |
void setURI (int index, String uri)
设置特定属性的名称空间URI。
Parameters | |
---|---|
index |
int : The index of the attribute (zero-based). |
uri |
String : The attribute's Namespace URI, or the empty string for none. |
Throws | |
---|---|
ArrayIndexOutOfBoundsException |
When the supplied index does not point to an attribute in the list. |
void setValue (int index, String value)
设置特定属性的值。
Parameters | |
---|---|
index |
int : The index of the attribute (zero-based). |
value |
String : The attribute's value. |
Throws | |
---|---|
ArrayIndexOutOfBoundsException |
When the supplied index does not point to an attribute in the list. |