org.jboss.dna.graph.properties.basic
Class LocalNamespaceRegistry

java.lang.Object
  org.jboss.dna.graph.properties.basic.BasicNamespaceRegistry
      org.jboss.dna.graph.properties.basic.LocalNamespaceRegistry

All Implemented Interfaces:

NamespaceRegistry

@ThreadSafe
public class LocalNamespaceRegistry
extends BasicNamespaceRegistry

Author:

Randall Hauch

Nested Class Summary

Nested classes/interfaces inherited from interface org.jboss.dna.graph.properties.NamespaceRegistry

NamespaceRegistry.Namespace

Field Summary

Fields inherited from class org.jboss.dna.graph.properties.basic.BasicNamespaceRegistry

DEFAULT_NAMESPACE_URI, DEFAULT_PREFIX_NUMBER_FORMAT, DEFAULT_PREFIX_TEMPLATE

Constructor Summary

LocalNamespaceRegistry(NamespaceRegistry delegate)

LocalNamespaceRegistry(NamespaceRegistry delegate, String defaultNamespaceUri)

Method Summary

String	getDefaultNamespaceUri() Return the namespace URI that is currently mapped to the empty prefix, or null if there is no current default namespace.
String	getNamespaceForPrefix(String prefix) Get the namespace URI for the supplied prefix.
Set<NamespaceRegistry.Namespace>	getNamespaces() Obtain a snapshot of all of the namespaces registered at the time this method is called. The resulting set is immutable, and will not reflect changes made to the registry.
String	getPrefixForNamespaceUri(String namespaceUri, boolean generateIfMissing) Return the prefix used for the supplied namespace URI.
Set<String>	getRegisteredNamespaceUris() Obtain the set of namespaces that are registered.
boolean	isRegisteredNamespaceUri(String namespaceUri) Return whether there is a registered prefix for the supplied namespace URI.
String	register(String prefix, String namespaceUri) Register a new namespace using the supplied prefix, returning the namespace URI previously registered under that prefix.
boolean	unregister(String namespaceUri) Unregister the namespace with the supplied URI.

Methods inherited from class org.jboss.dna.graph.properties.basic.BasicNamespaceRegistry

getGeneratedPrefixTemplate, setGeneratedPrefixTemplate

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

LocalNamespaceRegistry

public LocalNamespaceRegistry(NamespaceRegistry delegate)

Parameters:

delegate - the namespace registry that this registry should delegate to if not found locally

LocalNamespaceRegistry

public LocalNamespaceRegistry(NamespaceRegistry delegate,
                              String defaultNamespaceUri)

Parameters:

delegate - the namespace registry that this registry should delegate to if not found locally

defaultNamespaceUri - the namespace URI to use for the default prefix

Method Detail

getDefaultNamespaceUri

public String getDefaultNamespaceUri()

Return the namespace URI that is currently mapped to the empty prefix, or null if there is no current default namespace.

Specified by:

getDefaultNamespaceUri in interface NamespaceRegistry

Overrides:

getDefaultNamespaceUri in class BasicNamespaceRegistry

Returns:

the namespace URI that represents the default namespace, or null if there is no default namespace

See Also:

BasicNamespaceRegistry.getDefaultNamespaceUri()

getNamespaceForPrefix

public String getNamespaceForPrefix(String prefix)

Get the namespace URI for the supplied prefix.

Specified by:

getNamespaceForPrefix in interface NamespaceRegistry

Overrides:

getNamespaceForPrefix in class BasicNamespaceRegistry

Parameters:

prefix - the namespace prefix

Returns:

the namespace URI for the supplied prefix, or null if there is no namespace currently registered to use that prefix

See Also:

BasicNamespaceRegistry.getNamespaceForPrefix(java.lang.String)

getNamespaces

public Set<NamespaceRegistry.Namespace> getNamespaces()

Obtain a snapshot of all of the namespaces registered at the time this method is called. The resulting set is immutable, and will not reflect changes made to the registry.

Specified by:

getNamespaces in interface NamespaceRegistry

Overrides:

getNamespaces in class BasicNamespaceRegistry

Returns:

an immutable set of NamespaceRegistry.Namespace objects reflecting a snapshot of the registry; never null

See Also:

BasicNamespaceRegistry.getNamespaces()

getPrefixForNamespaceUri

public String getPrefixForNamespaceUri(String namespaceUri,
                                       boolean generateIfMissing)

Return the prefix used for the supplied namespace URI.

Specified by:

getPrefixForNamespaceUri in interface NamespaceRegistry

Overrides:

getPrefixForNamespaceUri in class BasicNamespaceRegistry

Parameters:

namespaceUri - the namespace URI

generateIfMissing - true if the namespace URI has not already been registered and the method should auto-register the namespace with a generated prefix, or false if the method should never auto-register the namespace

Returns:

the prefix currently being used for the namespace, or null if the namespace has not been registered and generateIfMissing is false

See Also:

BasicNamespaceRegistry.getPrefixForNamespaceUri(java.lang.String, boolean)

getRegisteredNamespaceUris

public Set<String> getRegisteredNamespaceUris()

Obtain the set of namespaces that are registered.

Specified by:

getRegisteredNamespaceUris in interface NamespaceRegistry

Overrides:

getRegisteredNamespaceUris in class BasicNamespaceRegistry

Returns:

the set of

See Also:

BasicNamespaceRegistry.getRegisteredNamespaceUris()

isRegisteredNamespaceUri

public boolean isRegisteredNamespaceUri(String namespaceUri)

Return whether there is a registered prefix for the supplied namespace URI.

Specified by:

isRegisteredNamespaceUri in interface NamespaceRegistry

Overrides:

isRegisteredNamespaceUri in class BasicNamespaceRegistry

Parameters:

namespaceUri - the namespace URI

Returns:

true if the supplied namespace has been registered with a prefix, or false otherwise

See Also:

BasicNamespaceRegistry.isRegisteredNamespaceUri(java.lang.String)

register

public String register(String prefix,
                       String namespaceUri)

Register a new namespace using the supplied prefix, returning the namespace URI previously registered under that prefix.

Specified by:

register in interface NamespaceRegistry

Overrides:

register in class BasicNamespaceRegistry

Parameters:

prefix - the prefix for the namespace, or null if a namesapce prefix should be generated automatically

namespaceUri - the namespace URI

Returns:

the namespace URI that was previously registered with the supplied prefix, or null if the prefix was not previously bound to a namespace URI

See Also:

BasicNamespaceRegistry.register(java.lang.String, java.lang.String)

unregister

public boolean unregister(String namespaceUri)

Unregister the namespace with the supplied URI.

Specified by:

unregister in interface NamespaceRegistry

Overrides:

unregister in class BasicNamespaceRegistry

Parameters:

namespaceUri - the namespace URI

Returns:

true if the namespace was removed, or false if the namespace was not registered

See Also:

BasicNamespaceRegistry.unregister(java.lang.String)