javax.xml.namespace
Interface NamespaceContext

Namespace URI:
Namespace name expressed as a URI to which the prefix is bound

prefix: syntactically, this is the part of the attribute name
following the XMLConstants.XMLNS_ATTRIBUTE
("xmlns") in the Namespace declaration

example: <element xmlns:prefix="http://Namespace-name-URI">

All get*(*) methods operate in the current scope
for Namespace URI and prefix resolution.

Note that a Namespace URI can be bound to
multiple prefixes in the current scope. This can
occur when multiple XMLConstants.XMLNS_ATTRIBUTE
("xmlns") Namespace declarations occur in the same Start-Tag and
refer to the same Namespace URI. e.g.

When requesting a prefix by Namespace URI, the following
table describes the returned prefix value for all Namespace URI
values:

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

Parameters:

namespaceURI - URI of Namespace to lookup

Returns:

prefix bound to Namespace URI in current context

getPrefixes

public java.util.Iterator getPrefixes(java.lang.String namespaceURI)

Get all prefixes bound to a Namespace URI in the current
scope.

An Iterator over String elements is returned in an arbitrary, implementation dependent, order.

The Iterator is
not modifiable. e.g. the
remove() method will throw
UnsupportedOperationException.

When requesting prefixes by Namespace URI, the following
table describes the returned prefixes value for all Namespace
URI values:

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

Parameters:

namespaceURI - URI of Namespace to lookup

Returns:

Iterator for all prefixes bound to the
Namespace URI in the current scope