org.apache.xml.utils
Class Context2

java.lang.Object
  extended byorg.apache.xml.utils.Context2

final class Context2
extends Object

Internal class for a single Namespace context.

This module caches and reuses Namespace contexts, so the number allocated will be equal to the element depth of the document, not to the total number of elements (i.e. 5-10 rather than tens of thousands).


Field Summary
(package private)  Hashtable attributeNameTable
           
private  Context2 child
           
private  Vector declarations
           
(package private)  String defaultNS
           
(package private)  Hashtable elementNameTable
           
private static Enumeration EMPTY_ENUMERATION
          An empty enumeration.
private  Context2 parent
           
(package private)  Hashtable prefixTable
           
private  boolean tablesDirty
           
(package private)  Hashtable uriTable
           
 
Constructor Summary
(package private) Context2(Context2 parent)
          Create a new Namespace context.
 
Method Summary
private  void copyTables()
          Copy on write for the internal tables in this context.
(package private)  void declarePrefix(String prefix, String uri)
          Declare a Namespace prefix for this context.
(package private)  Context2 getChild()
           
(package private)  Enumeration getDeclaredPrefixes()
          Return an enumeration of prefixes declared in this context.
(package private)  Context2 getParent()
           
(package private)  String getPrefix(String uri)
          Look up one of the prefixes associated with a URI in this context.
(package private)  Enumeration getPrefixes()
          Return an enumeration of all prefixes currently in force.
(package private)  String getURI(String prefix)
          Look up the URI associated with a prefix in this context.
(package private)  String[] processName(String qName, boolean isAttribute)
          Process a raw XML 1.0 name in this context.
(package private)  void setParent(Context2 parent)
          (Re)set the parent of this Namespace context.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

EMPTY_ENUMERATION

private static final Enumeration EMPTY_ENUMERATION
An empty enumeration.


prefixTable

Hashtable prefixTable

uriTable

Hashtable uriTable

elementNameTable

Hashtable elementNameTable

attributeNameTable

Hashtable attributeNameTable

defaultNS

String defaultNS

declarations

private Vector declarations

tablesDirty

private boolean tablesDirty

parent

private Context2 parent

child

private Context2 child
Constructor Detail

Context2

Context2(Context2 parent)
Create a new Namespace context.

Method Detail

getChild

Context2 getChild()

getParent

Context2 getParent()

setParent

void setParent(Context2 parent)
(Re)set the parent of this Namespace context. This is separate from the c'tor because it's re-applied when a Context2 is reused by push-after-pop.


declarePrefix

void declarePrefix(String prefix,
                   String uri)
Declare a Namespace prefix for this context.

Parameters:
prefix - The prefix to declare.
uri - The associated Namespace URI.
See Also:
org.xml.sax.helpers.NamespaceSupport2#declarePrefix

processName

String[] processName(String qName,
                     boolean isAttribute)
Process a raw XML 1.0 name in this context.

Parameters:
qName - The raw XML 1.0 name.
isAttribute - true if this is an attribute name.
Returns:
An array of three strings containing the URI part (or empty string), the local part, and the raw name, all internalized, or null if there is an undeclared prefix.
See Also:
org.xml.sax.helpers.NamespaceSupport2#processName

getURI

String getURI(String prefix)
Look up the URI associated with a prefix in this context.

Parameters:
prefix - The prefix to look up.
Returns:
The associated Namespace URI, or null if none is declared.
See Also:
org.xml.sax.helpers.NamespaceSupport2#getURI

getPrefix

String getPrefix(String uri)
Look up one of the prefixes associated with a URI in this context.

Since many prefixes may be mapped to the same URI, the return value may be unreliable.

Parameters:
uri - The URI to look up.
Returns:
The associated prefix, or null if none is declared.
See Also:
org.xml.sax.helpers.NamespaceSupport2#getPrefix

getDeclaredPrefixes

Enumeration getDeclaredPrefixes()
Return an enumeration of prefixes declared in this context.

Returns:
An enumeration of prefixes (possibly empty).
See Also:
org.xml.sax.helpers.NamespaceSupport2#getDeclaredPrefixes

getPrefixes

Enumeration getPrefixes()
Return an enumeration of all prefixes currently in force.

The default prefix, if in force, is not returned, and will have to be checked for separately.

Returns:
An enumeration of prefixes (never empty).
See Also:
org.xml.sax.helpers.NamespaceSupport2#getPrefixes

copyTables

private void copyTables()
Copy on write for the internal tables in this context.

This class is optimized for the normal case where most elements do not contain Namespace declarations. In that case, the Context2 will share data structures with its parent. New tables are obtained only when new declarations are issued, so they can be popped off the stack.

JJK: **** Alternative: each Context2 might declare _only_ its local bindings, and delegate upward if not found.