- java.lang.Object
-
- javax.xml.namespace.QName
-
- 实现的所有接口
-
Serializable
public class QName extends Object implements Serializable
QName
表示如XML规范中定义的限定名称 : XML Schema Part2: Datatypes specification , Namespaces in XML 。QName
的值包含名称空间URI , 本地部分和前缀 。前缀包括在
QName
保留词汇信息存在于一个时XML input source
。 前缀不用于QName.equals(Object)
或计算QName.hashCode()
。 仅使用Namespace URI和本地部分定义Equality和哈希码。如果未指定,则名称空间URI设置为
XMLConstants.NULL_NS_URI
。 如果未指定,则前缀设置为XMLConstants.DEFAULT_NS_PREFIX
。QName
是不可变的。- 从以下版本开始:
- 1.5
- 另请参见:
- XML Schema Part2: Datatypes specification , Namespaces in XML , Serialized Form
-
-
方法摘要
所有方法 静态方法 实例方法 具体的方法 变量和类型 方法 描述 boolean
equals(Object objectToTest)
测试此QName
是否与另一个Object
。String
getLocalPart()
获取此QName
的本地部分。String
getNamespaceURI()
获取此QName
的名称空间URI。String
getPrefix()
获取此QName
的前缀。int
hashCode()
生成此QName
的哈希码。String
toString()
String
表示这个QName
。static QName
valueOf(String qNameAsString)
QName
派生自解析格式化的String
。
-
-
-
构造方法详细信息
-
QName
public QName(String namespaceURI, String localPart)
QName
构造函数,指定名称空间URI和本地部分。如果名称空间URI为
null
,则将其设置为XMLConstants.NULL_NS_URI
。 此值表示Namespaces in XML规范未定义的显式定义的命名空间。 此操作保留与QName 1.0的兼容行为。 明确提供XMLConstants.NULL_NS_URI
值是首选的编码风格。如果本地部分是
null
,则抛出IllegalArgumentException
。 允许“”的本地部分保留与QName 1.0的兼容行为。使用此构造函数时,前缀设置为
XMLConstants.DEFAULT_NS_PREFIX
。名称空间URI未验证为URI reference 。 本地部分未经过验证,如Namespaces in XML中指定的NCName 。
- 参数
-
namespaceURI
-的的命名空间URIQName
-
localPart
-在当地的部分QName
- 异常
-
IllegalArgumentException
- 当localPart
是null
- 另请参见:
-
QName(String namespaceURI, String localPart, String prefix)
-
QName
public QName(String namespaceURI, String localPart, String prefix)
QName
构造函数,指定名称空间URI,本地部分和前缀。如果名称空间URI为
null
,则将其设置为XMLConstants.NULL_NS_URI
。 此值表示Namespaces in XML规范未定义的显式定义的命名空间。 此操作保留与QName 1.0的兼容行为。 明确提供XMLConstants.NULL_NS_URI
值是首选的编码风格。如果本地部分为
null
的IllegalArgumentException
异常。 允许“”的本地部分保留与QName 1.0的兼容行为。如果前缀为
null
,则抛出IllegalArgumentException
。 使用XMLConstants.DEFAULT_NS_PREFIX
明确指出不存在前缀或前缀不相关。名称空间URI未验证为URI reference 。 本地部分和前缀未经验证为NCName,如Namespaces in XML中所述 。
- 参数
-
namespaceURI
-的的命名空间URIQName
-
localPart
-在当地的部分QName
-
prefix
-的前缀QName
- 异常
-
IllegalArgumentException
- 当localPart
或prefix
是null
-
QName
public QName(String localPart)
QName
指定本地部分的构造函数。如果本地部分是
null
,则抛出IllegalArgumentException
。 允许“”的本地部分保留与QName 1.0的兼容行为。使用此构造函数时,名称空间URI设置为
XMLConstants.NULL_NS_URI
,前缀设置为XMLConstants.DEFAULT_NS_PREFIX
。在XML上下文中,所有元素和属性名称都存在于命名空间的上下文中。 在构造
QName
期间明确这QName
有助于防止难以诊断XML有效性错误。 构造函数QName(String namespaceURI, String localPart)
和QName(String namespaceURI, String localPart, String prefix)
是优选的。本地部分未经验证为5127159352809中指定的NCName 。
- 参数
-
localPart
-在当地的部分QName
- 异常
-
IllegalArgumentException
- 当localPart
是null
- 另请参见:
-
QName(String namespaceURI, String localPart)
,QName(String namespaceURI, String localPart, String prefix)
-
-
方法详细信息
-
getNamespaceURI
public String getNamespaceURI()
获取此
QName
的名称空间URI。- 结果
-
此
QName
名称空间URI
-
getLocalPart
public String getLocalPart()
获取此
QName
的本地部分。- 结果
-
本地部分
QName
-
getPrefix
public String getPrefix()
获取此
QName
的前缀。分配给一个前缀
QName
可能不是在不同的上下文中有效。 例如,可以在解析文档的上下文中为QName
分配前缀,但该前缀在不同文档的上下文中可能是无效的。- 结果
-
这个前缀
QName
-
equals
public final boolean equals(Object objectToTest)
测试此
QName
是否与另一个Object
。如果
Object
待测试不是QName
或是null
,则此方法返回false
。当且仅当命名空间URI和本地部分相等时,才认为两个
QName
是相等的。 此方法使用String.equals()
来检查名称空间URI和本地部分的相等性。 前缀不用于确定相等性。该方法满足
Object.equals(Object)
的总合同- 重写:
-
equals
在类Object
- 参数
-
objectToTest
-将Object
要测试其相等与此QName
- 结果
-
true
若给定Object
等于此QName
否则false
- 另请参见:
-
Object.hashCode()
,HashMap
-
hashCode
public final int hashCode()
- 重写:
-
hashCode
类Object
- 结果
-
此哈希码为
QName
Object
- 另请参见:
-
Object.equals(java.lang.Object)
,System.identityHashCode(java.lang.Object)
-
toString
public String toString()
String
代表作者QName
。代表普遍接受的方式
QName
为String
为defined由詹姆斯·克拉克。 虽然这不是标准规范,但它是常用的,例如Transformer.setParameter(String name, Object value)
。 此实现表示QName
:“{”+ Namespace URI +“}”+本地部分。 如果名称空间URI为.equals(XMLConstants.NULL_NS_URI)
,则仅返回本地部分。 适当使用此方法用于调试或记录供人食用。请注意,前缀值不会作为
String
表示的一部分返回。该方法满足
Object.toString()
的一般合同。
-
valueOf
public static QName valueOf(String qNameAsString)
QName
派生自解析格式化的String
。如果
String
是null
或不符合QName.toString()
格式,则抛出IllegalArgumentException
。String
必须采用QName.toString()
返回的格式 。代表普遍接受的方式
QName
为String
为defined由詹姆斯·克拉克。 虽然这不是标准规范,但它是常用的,例如Transformer.setParameter(String name, Object value)
。 此实现解析String
格式为:“{”+ Namespace URI +“}”+本地部分。 如果名称空间URI为.equals(XMLConstants.NULL_NS_URI)
,则只应提供本地部分。前缀值不能在
String
表示,并将设置为XMLConstants.DEFAULT_NS_PREFIX
。此方法不会对生成的
QName
进行完全验证。名称空间URI未验证为URI reference 。 本地部分未经过验证,如Namespaces in XML中指定的NCName 。
- 参数
-
qNameAsString
-String
表示的QName
- 结果
-
QName
对应于给定的String
- 异常
-
IllegalArgumentException
- 当qNameAsString
是null
或格式错误时 - 另请参见:
-
QName.toString()
-
-