Class NamespaceSupport

Creates a new instance of NamespaceSupport.

This method is used to restore the namespace state after an element is created. It takes as input a state, as returned by getContext.
For any prefix, which was since saving the state, the prefix is returned and deleted from the internal list. In other words, a typical use looks like this:

   NamespaceSupport nss;
   ContentHandler h;
   int context = nss.getContext();
   h.startElement("foo", "bar", "f:bar", new AttributesImpl());
   ...
   h.endElement("foo", "bar", "f:bar");
   for (;;) {
     String prefix = nss.checkContext(context);
     if (prefix == null) {
       break;
     }
     h.endPrefixMapping(prefix);
   }
 

Declares a new prefix.

Returns a non-empty prefix currently mapped to the given URL or null, if there is no such mapping. This method may be used to find a possible prefix for an attributes namespace URI. For elements you should use getPrefix.

Parameters: pURI Thhe namespace URI in question

Throws: IllegalArgumentException The namespace URI is null.

Returns the current number of assigned prefixes. Note, that a prefix may be assigned in several nested elements, in which case every assignment is counted.
This method is typically called before invoking the method org.xml.sax.ContentHandler#startElement(String, String, String, org.xml.sax.Attributes). The return value is used as a saveable state. After invoking org.xml.sax.ContentHandler#endElement(String, String, String), the state is restored by calling NamespaceSupport.

Given a prefix, returns the URI to which the prefix is currently mapped or null, if there is no such mapping.

Note: This methods behaviour is precisely defined by NamespaceContext.

Parameters: pPrefix The prefix in question

Returns a prefix currently mapped to the given URI or null, if there is no such mapping. This method may be used to find a possible prefix for an elements namespace URI. For attributes you should use getAttributePrefix.

Note: This methods behaviour is precisely defined by getPrefix.

Parameters: pURI The namespace URI in question

Throws: IllegalArgumentException The namespace URI is null.

Returns a collection to all prefixes bound to the given namespace URI.

Note: This methods behaviour is precisely defined by getPrefixes.

Parameters: pURI The namespace prefix in question

Returns whether a given prefix is currently declared.

Resets the NamespaceSupport's state for reuse.

Removes a prefix declaration. Assumes that the prefix is the current prefix. If not, throws a IllegalStateException.