StartElement (Java EE 5)

The StartElement interface provides access to information about start elements. A StartElement is reported for each Start Tag in the document.

Version:

1.0

Author:

Copyright (c) 2003 by BEA Systems. All Rights Reserved.

public javax.xml.namespace.QName getName()
获取此事件的名称

return

此事件的限定名

英文文档：

getName

QName getName()

Get the name of this event

Returns:

the qualified name of this event

public java.util.Iterator<E> getAttributes()
返回在此 START_ELEMENT 上声明的已声明非名称空间属性的 Iterator；如果没有这样的属性，则返回空迭代器。迭代器必须只包含 javax.xml.stream.Attribute 接口的实现。属性是完全无序的，且不能以任意顺序报告。

return

可在 Attribute 接口上进行迭代的只读 Iterator，或者返回空迭代器

英文文档：

getAttributes

Iterator getAttributes()

Returns an Iterator of non-namespace declared attributes declared on this START_ELEMENT, returns an empty iterator if there are no attributes. The iterator must contain only implementations of the javax.xml.stream.Attribute interface. Attributes are fundamentally unordered and may not be reported in any order.

Returns:

a readonly Iterator over Attribute interfaces, or an empty iterator

public java.util.Iterator<E> getNamespaces()
返回在此元素上声明的名称空间的 Iterator。此 Iterator 不包含以前声明的名称空间，除非它们出现在当前 START_ELEMENT 中。因此该列表可能包含重新声明的名称空间和重复的名称空间声明。使用 getNamespaceContext() 方法获取名称空间声明的当前上下文。

迭代器只能包含 javax.xml.stream.Namespace 接口的实现。

名称空间是一个属性。可以以属性列表的方式在名称空间列表上进行迭代。但是，此方法只返回在此 START_ELEMENT 中声明的名称空间的列表，不包含在此 START_ELEMENT 中声明的属性。 如果没有名称空间，则返回空迭代器。

return

可在名称空间接口上进行迭代的只读 Iterator，或者返回空迭代器

英文文档：

getNamespaces

Iterator getNamespaces()

Returns an Iterator of namespaces declared on this element. This Iterator does not contain previously declared namespaces unless they appear on the current START_ELEMENT. Therefore this list may contain redeclared namespaces and duplicate namespace declarations. Use the getNamespaceContext() method to get the current context of namespace declarations.

The iterator must contain only implementations of the javax.xml.stream.Namespace interface.

A Namespace isA Attribute. One can iterate over a list of namespaces as a list of attributes. However this method returns only the list of namespaces declared on this START_ELEMENT and does not include the attributes declared on this START_ELEMENT. Returns an empty iterator if there are no namespaces.

Returns:

a readonly Iterator over Namespace interfaces, or an empty iterator

public Attribute getAttributeByName(javax.xml.namespace.QName name)
返回此名称引用的属性

name	所需名称的 qname
return	与名称值相对应的属性或 null

英文文档：

getAttributeByName

Attribute getAttributeByName(QName name)

Returns the attribute referred to by this name

Parameters:

name - the qname of the desired name

Returns:

the attribute corresponding to the name value or null

public javax.xml.namespace.NamespaceContext getNamespaceContext()
获取只读名称空间上下文。如果没有可用的上下文，此方法将返回空名称空间上下文。NamespaceContext 包含有关此 StartElement 的作用域中所有名称空间的信息。

return

当前名称空间上下文

英文文档：

getNamespaceContext

NamespaceContext getNamespaceContext()

Gets a read-only namespace context. If no context is available this method will return an empty namespace context. The NamespaceContext contains information about all namespaces in scope for this StartElement.

Returns:

the current namespace context

public String getNamespaceURI(String prefix)
获取绑定在此元素上下文中的前缀的值。如果前缀未绑定在此上下文中，则返回 null

prefix	要查找的前缀
return	绑定到前缀的 URI 或 null

英文文档：

getNamespaceURI

String getNamespaceURI(String prefix)

Gets the value that the prefix is bound to in the context of this element. Returns null if the prefix is not bound in this context

Parameters:

prefix - the prefix to lookup

Returns:

the uri bound to the prefix or null

Copyright 2007 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.