org.apache.xerces.xinclude
Class MultipleScopeNamespaceSupport

java.lang.Object
  extended by org.apache.xerces.util.NamespaceSupport
      extended by org.apache.xerces.xinclude.MultipleScopeNamespaceSupport
All Implemented Interfaces:
NamespaceContext
Direct Known Subclasses:
XIncludeNamespaceSupport

public class MultipleScopeNamespaceSupport
extends NamespaceSupport

This implementation of NamespaceContext has the ability to maintain multiple scopes of namespace/prefix bindings. This is useful in situations when it is not always appropriate for elements to inherit the namespace bindings of their ancestors (such as included elements in XInclude). When searching for a URI to match a prefix, or a prefix to match a URI, it is searched for in the current context, then the ancestors of the current context, up to the beginning of the current scope. Other scopes are not searched.

Version:
$Id: MultipleScopeNamespaceSupport.java 447243 2006-09-18 05:15:27Z mrglavas $
Author:
Peter McCracken, IBM

Field Summary
 
Fields inherited from interface org.apache.xerces.xni.NamespaceContext
XML_URI, XMLNS_URI
 
Constructor Summary
MultipleScopeNamespaceSupport()
           
MultipleScopeNamespaceSupport(NamespaceContext context)
           
 
Method Summary
 java.util.Enumeration getAllPrefixes()
          Return an enumeration of all prefixes whose declarations are active in the current context.
 java.lang.String getPrefix(java.lang.String uri)
          Look up a namespace URI and get one of the mapped prefix.
 java.lang.String getPrefix(java.lang.String uri, int context)
           
 java.lang.String getPrefix(java.lang.String uri, int start, int end)
           
 int getScopeForContext(int context)
           
 java.lang.String getURI(java.lang.String prefix)
          Look up a prefix and get the currently-mapped Namespace URI.
 java.lang.String getURI(java.lang.String prefix, int context)
           
 java.lang.String getURI(java.lang.String prefix, int start, int end)
           
 void popScope()
          Pops the current scope.
 void pushScope()
          Begins a new scope.
 void reset()
          Only resets the current scope -- all namespaces defined in lower scopes remain valid after a call to reset.
 
Methods inherited from class org.apache.xerces.util.NamespaceSupport
containsPrefix, declarePrefix, getDeclaredPrefixAt, getDeclaredPrefixCount, popContext, pushContext
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

MultipleScopeNamespaceSupport

public MultipleScopeNamespaceSupport()

MultipleScopeNamespaceSupport

public MultipleScopeNamespaceSupport(NamespaceContext context)
Parameters:
context -
Method Detail

getAllPrefixes

public java.util.Enumeration getAllPrefixes()
Description copied from interface: NamespaceContext
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.

Specified by:
getAllPrefixes in interface NamespaceContext
Overrides:
getAllPrefixes in class NamespaceSupport
Returns:
Enumeration
See Also:
NamespaceContext.getAllPrefixes()

getScopeForContext

public int getScopeForContext(int context)

getPrefix

public java.lang.String getPrefix(java.lang.String uri)
Description copied from interface: NamespaceContext
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).

Specified by:
getPrefix in interface NamespaceContext
Overrides:
getPrefix in class NamespaceSupport
Parameters:
uri - The namespace URI to look up.
Returns:
One of the associated prefixes, or null if the uri does not map to any prefix.
See Also:
NamespaceContext.getPrefix(String)

getURI

public java.lang.String getURI(java.lang.String prefix)
Description copied from interface: NamespaceContext
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.

Specified by:
getURI in interface NamespaceContext
Overrides:
getURI in class NamespaceSupport
Parameters:
prefix - The prefix to look up.
Returns:
The associated Namespace URI, or null if the prefix is undeclared in this context.
See Also:
NamespaceContext.getURI(String)

getPrefix

public java.lang.String getPrefix(java.lang.String uri,
                                  int context)

getURI

public java.lang.String getURI(java.lang.String prefix,
                               int context)

getPrefix

public java.lang.String getPrefix(java.lang.String uri,
                                  int start,
                                  int end)

getURI

public java.lang.String getURI(java.lang.String prefix,
                               int start,
                               int end)

reset

public void reset()
Only resets the current scope -- all namespaces defined in lower scopes remain valid after a call to reset.

Specified by:
reset in interface NamespaceContext
Overrides:
reset in class NamespaceSupport
See Also:
NamespaceContext.reset()

pushScope

public void pushScope()
Begins a new scope. None of the previous namespace bindings will be used, until the new scope is popped with popScope()


popScope

public void popScope()
Pops the current scope. The namespace bindings from the new current scope are then used for searching for namespaces and prefixes.