NamespaceContext (Java Platform SE 8 )

```
public interface NamespaceContext
```
只读XML接口名称空间上下文处理。

XML命名空间具有以下属性：
- 命名空间URI：命名空间名称，表示为前缀绑定到的URI
- 前缀：在语法上，这是在命名空间声明中的XMLConstants.XMLNS_ATTRIBUTE （“xmlns”）之后的属性名称的一部分
例如： <element xmlns:prefix="http://Namespace-name-URI">

所有get*(*)方法在当前范围内操作命名空间URI和前缀解析。

请注意，命名空间URI可以绑定到当前作用域中的多个前缀。当多个XMLConstants.XMLNS_ATTRIBUTE （“xmlns”）命名空间声明发生在同一起始标签中并引用相同的命名空间URI时，可能会发生这种情况。例如
```
  <element xmlns:prefix1="http://Namespace-name-URI"
          xmlns:prefix2="http://Namespace-name-URI"> 
```
当在逻辑父元素层次结构中的多个XMLConstants.XMLNS_ATTRIBUTE （“xmlns”）命名空间声明中使用相同的命名空间URI时，也会发生这种情况。例如
```
  <parent xmlns:prefix1="http://Namespace-name-URI">
   <child xmlns:prefix2="http://Namespace-name-URI">
     ...
   </child>
 </parent> 
```
前缀只能绑定到当前作用域中的单个命名空间URI。
从以下版本开始：

1.5

另请参见：

javax.xml.XMLConstants for declarations of common XML values ， XML Schema Part2: Datatypes ， Namespaces in XML ， Namespaces in XML Errata

方法摘要

所有方法接口方法抽象方法
Modifier and Type	Method and Description
`String`	`getNamespaceURI(String prefix)` 获取命名空间URI绑定到当前作用域中的前缀。
`String`	`getPrefix(String namespaceURI)` 获取前缀绑定到当前作用域中的命名空间URI。
`Iterator`	`getPrefixes(String namespaceURI)` 获取绑定到当前作用域中的命名空间URI的所有前缀。

- 方法详细信息
  - getNamespaceURI
```
String getNamespaceURI(String prefix)
```
    获取命名空间URI绑定到当前作用域中的前缀。
    
    当通过前缀请求命名空间URI时，下表描述了所有可能的前缀值返回的命名空间URI值：
    getNamespaceURI(prefix) return value for specified prefixes prefix parameter Namespace URI return value DEFAULT_NS_PREFIX ("") default Namespace URI in the current scope or XMLConstants.NULL_NS_URI("") when there is no default Namespace URI in the current scope bound prefix Namespace URI bound to prefix in current scope unbound prefix XMLConstants.NULL_NS_URI("") XMLConstants.XML_NS_PREFIX ("xml") XMLConstants.XML_NS_URI ("http://www.w3.org/XML/1998/namespace") XMLConstants.XMLNS_ATTRIBUTE ("xmlns") XMLConstants.XMLNS_ATTRIBUTE_NS_URI ("http://www.w3.org/2000/xmlns/") null IllegalArgumentException is thrown
    
    参数
    
    prefix - 前缀查找
    
    结果
    
    命名空间URI绑定到当前作用域中的前缀
    
    异常
    
    IllegalArgumentException - 当 prefix是 null
  - getPrefix
```
String getPrefix(String namespaceURI)
```
    获取前缀绑定到当前作用域中的命名空间URI。
    
    要获取绑定到当前作用域中的命名空间URI的所有前缀，请使用getPrefixes(String namespaceURI) 。
    
    当通过Namespace URI请求前缀时，下表描述了所有Namespace URI值返回的前缀值：
    getPrefix(namespaceURI) return value for specified Namespace URIs Namespace URI parameter prefix value returned <default Namespace URI> XMLConstants.DEFAULT_NS_PREFIX ("") bound Namespace URI prefix bound to Namespace URI in the current scope, if multiple prefixes are bound to the Namespace URI in the current scope, a single arbitrary prefix, whose choice is implementation dependent, is returned unbound Namespace URI null XMLConstants.XML_NS_URI ("http://www.w3.org/XML/1998/namespace") XMLConstants.XML_NS_PREFIX ("xml") XMLConstants.XMLNS_ATTRIBUTE_NS_URI ("http://www.w3.org/2000/xmlns/") XMLConstants.XMLNS_ATTRIBUTE ("xmlns") null IllegalArgumentException is thrown
    
    参数
    
    namespaceURI - 要查找的 namespaceURI URI
    
    结果
    
    前缀绑定到当前上下文中的命名空间URI
    
    异常
    
    IllegalArgumentException - 当 namespaceURI是 null
  - getPrefixes
```
Iterator getPrefixes(String namespaceURI)
```
    获取绑定到当前作用域中的命名空间URI的所有前缀。
    
    一个迭代器上的String元素以任意的， 依赖于实现的顺序返回。
    
    Iterator是不可修改的。 例如remove()方法会抛出UnsupportedOperationException 。
    
    当通过Namespace URI请求前缀时，下表描述了所有Namespace URI值返回的前缀值：
    getPrefixes(namespaceURI) return value for specified Namespace URIs Namespace URI parameter prefixes value returned bound Namespace URI, including the <default Namespace URI> Iterator over prefixes bound to Namespace URI in the current scope in an arbitrary, implementation dependent, order unbound Namespace URI empty Iterator XMLConstants.XML_NS_URI ("http://www.w3.org/XML/1998/namespace") Iterator with one element set to XMLConstants.XML_NS_PREFIX ("xml") XMLConstants.XMLNS_ATTRIBUTE_NS_URI ("http://www.w3.org/2000/xmlns/") Iterator with one element set to XMLConstants.XMLNS_ATTRIBUTE ("xmlns") null IllegalArgumentException is thrown
    
    参数
    
    namespaceURI - 要查找的 namespaceURI URI
    
    结果
    
    Iterator用于绑定到当前作用域中的命名空间URI的所有前缀
    
    异常
    
    IllegalArgumentException - 当时 namespaceURI是 null

Interface NamespaceContext

方法摘要

方法详细信息

getNamespaceURI

getPrefix

getPrefixes