| org.apache.xerces.xni.NamespaceContext
All known Subclasses: org.apache.xerces.util.JAXPNamespaceContextWrapper, org.apache.xerces.util.NamespaceSupport,
| NamespaceContext | | public interface NamespaceContext (Code) | | Represents an interface to query namespace information.
The prefix and namespace must be identical references for equal strings, thus
each string should be internalized (@see String.intern())
or added to the SymbolTable
See Also:
* org.apache.xerces.util.SymbolTable
author:
Andy Clark, IBM
version:
$Id: NamespaceContext.java 447247 2006-09-18 05:23:52Z mrglavas $ |
| Field Summary | |
| final public static String | XMLNS_URI
| | final public static String | XML_URI
The XML Namespace ("http://www.w3.org/XML/1998/namespace"). |
| Method Summary | |
| public boolean | declarePrefix(String prefix, String uri)
Declare a Namespace prefix.
This method declares a prefix in the current Namespace
context; the prefix will remain in force until this context
is popped, unless it is shadowed in a descendant context.
Note that to declare a default Namespace, use the empty string. | | public Enumeration | getAllPrefixes()
Return an enumeration of all prefixes whose declarations are active
in the current context. | | public String | getDeclaredPrefixAt(int index)
Returns the prefix at the specified index in the current context. | | public int | getDeclaredPrefixCount()
Return a count of locally declared prefixes, including
the default prefix if bound. | | public String | getPrefix(String uri)
Look up a namespace URI and get one of the mapped prefix.
This method looks up the namespace URI in the current context.
If more than one prefix is currently mapped to the same URI,
this method will make an arbitrary selection
If no mapping is found, this methods will continue lookup in the
parent context(s).
Parameters:
uri - The namespace URI to look up. | | public String | getURI(String prefix)
Look up a prefix and get the currently-mapped Namespace URI.
This method looks up the prefix in the current context. | | public void | popContext()
Revert to the previous Namespace context.
The context should be popped at the end of each
XML element. | | public void | pushContext()
Start a new Namespace context. | | public void | reset()
Reset this Namespace support object for reuse. |
| XMLNS_URI | | final public static String XMLNS_URI(Code) | | XML Information Set REC
all namespace attributes (including those named xmlns,
whose [prefix] property has no value) have a namespace URI of http://www.w3.org/2000/xmlns/
|
| XML_URI | | final public static String XML_URI(Code) | | The XML Namespace ("http://www.w3.org/XML/1998/namespace"). This is
the Namespace URI that is automatically mapped to the "xml" prefix.
|
| declarePrefix | | public boolean declarePrefix(String prefix, String uri)(Code) | | Declare a Namespace prefix.
This method declares a prefix in the current Namespace
context; the prefix will remain in force until this context
is popped, unless it is shadowed in a descendant context.
Note that to declare a default Namespace, use the empty string.
The prefixes "xml" and "xmlns" can't be rebound.
Note that you must not declare a prefix after
you've pushed and popped another Namespace.
Parameters:
prefix - The prefix to declare, or null for the emptystring.
Parameters:
uri - The Namespace URI to associate with the prefix. true if the prefix was legal, false otherwise
See Also: NamespaceContext.getURI
See Also: NamespaceContext.getDeclaredPrefixAt |
| getAllPrefixes | | public Enumeration getAllPrefixes()(Code) | | Return an enumeration of all prefixes whose declarations are active
in the current context. This includes declarations from parent contexts
that have not been overridden.
Enumeration |
| getDeclaredPrefixAt | | public String getDeclaredPrefixAt(int index)(Code) | | Returns the prefix at the specified index in the current context.
|
| getDeclaredPrefixCount | | public int getDeclaredPrefixCount()(Code) | | Return a count of locally declared prefixes, including
the default prefix if bound.
|
| getPrefix | | public String getPrefix(String uri)(Code) | | Look up a namespace URI and get one of the mapped prefix.
This method looks up the namespace URI in the current context.
If more than one prefix is currently mapped to the same URI,
this method will make an arbitrary selection
If no mapping is found, this methods will continue lookup in the
parent context(s).
Parameters:
uri - The namespace URI to look up. One of the associated prefixes, or null if the uridoes not map to any prefix.
See Also: NamespaceContext.getPrefix |
| getURI | | public String getURI(String prefix)(Code) | | Look up a prefix and get the currently-mapped Namespace URI.
This method looks up the prefix in the current context. If no mapping
is found, this methods will continue lookup in the parent context(s).
Use the empty string ("") for the default Namespace.
Parameters:
prefix - The prefix to look up. The associated Namespace URI, or null if the prefixis undeclared in this context. |
| popContext | | public void popContext()(Code) | | Revert to the previous Namespace context.
The context should be popped at the end of each
XML element. After popping the context, all Namespace prefix
mappings that were previously in force are restored.
Users must not attempt to declare additional Namespace
prefixes after popping a context, unless you push another
context first.
See Also: NamespaceContext.pushContext |
| pushContext | | public void pushContext()(Code) | | Start a new Namespace context.
A new context should be pushed at the beginning
of each XML element: the new context will automatically inherit
the declarations of its parent context, but it will also keep
track of which declarations were made within this context.
See Also: NamespaceContext.popContext |
| reset | | public void reset()(Code) | | Reset this Namespace support object for reuse.
It is necessary to invoke this method before reusing the
Namespace support object for a new session.
Note that implementations of this method need to ensure that
the declaration of the prefixes "xmlns" and "xml" are available.
|
|
|