Package org.apache.jackrabbit.oak.plugins.name

Class ReadOnlyNamespaceRegistry

java.lang.Object

org.apache.jackrabbit.oak.plugins.name.ReadOnlyNamespaceRegistry

All Implemented Interfaces:

NamespaceRegistry, NamespaceConstants

Direct Known Subclasses:

ReadWriteNamespaceRegistry

public class ReadOnlyNamespaceRegistry
extends Object
implements NamespaceRegistry, NamespaceConstants

Read-only namespace registry. Used mostly internally when access to the in-content registered namespaces is needed. See the ReadWriteNamespaceRegistry subclass for a more complete registry implementation that supports also namespace modifications and that's thus better suited for use in in implementing the full JCR API.

Field Summary

Fields inherited from interface org.apache.jackrabbit.oak.spi.namespace.NamespaceConstants

NAMESPACE_OAK, NAMESPACE_REP, NAMESPACE_SV, NAMESPACE_XMLNS, NAMESPACES_PATH, PREFIX_OAK, PREFIX_REP, PREFIX_SV, PREFIX_XMLNS, REP_NAMESPACES, REP_NSDATA, REP_PREFIXES, REP_URIS, RESERVED_PREFIXES, RESERVED_URIS

Fields inherited from interface javax.jcr.NamespaceRegistry

NAMESPACE_EMPTY, NAMESPACE_JCR, NAMESPACE_MIX, NAMESPACE_NT, NAMESPACE_XML, PREFIX_EMPTY, PREFIX_JCR, PREFIX_MIX, PREFIX_NT, PREFIX_XML

Constructor Summary

Constructors

Constructor	Description
ReadOnlyNamespaceRegistry(Root root)

Method Summary

Modifier and Type	Method	Description
@NotNull String	getPrefix(String uri)	Returns the prefix which is mapped to the given uri.
@NotNull String[]	getPrefixes()	Returns an array holding all currently registered prefixes.
@NotNull String	getURI(String prefix)	Returns the URI to which the given prefix is mapped.
@NotNull String[]	getURIs()	Returns an array holding all currently registered URIs.
void	registerNamespace(String prefix, String uri)	Sets a one-to-one mapping between prefix and uri in the global namespace registry of this repository.
void	unregisterNamespace(String prefix)	Removes a namespace mapping from the registry.

Methods inherited from class java.lang.Object

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

Constructor Details

ReadOnlyNamespaceRegistry

public ReadOnlyNamespaceRegistry(Root root)

Method Details

registerNamespace

public void registerNamespace(String prefix,
 String uri)
                       throws RepositoryException

Description copied from interface: NamespaceRegistry

Sets a one-to-one mapping between prefix and uri in the global namespace registry of this repository.

Assigning a new prefix to a URI that already exists in the namespace registry erases the old prefix. In general this can almost always be done, though an implementation is free to prevent particular remappings by throwing a NamespaceException.

On the other hand, taking a prefix that is already assigned to a URI and re-assigning it to a new URI in effect unregisters that URI. Therefore, the same restrictions apply to this operation as to NamespaceRegistry.unregisterNamespace.

Specified by:

registerNamespace in interface NamespaceRegistry

Parameters:

prefix - The prefix to be mapped.

uri - The URI to be mapped.

Throws:

RepositoryException - if another error occurs.

unregisterNamespace

public void unregisterNamespace(String prefix)
                         throws RepositoryException

Description copied from interface: NamespaceRegistry

Removes a namespace mapping from the registry.

Specified by:

unregisterNamespace in interface NamespaceRegistry

Parameters:

prefix - The prefix of the mapping to be removed.

Throws:

RepositoryException - if another error occurs.

getPrefixes

@NotNull
public @NotNull String[] getPrefixes()

Description copied from interface: NamespaceRegistry

Returns an array holding all currently registered prefixes.

Specified by:

getPrefixes in interface NamespaceRegistry

Returns:

a string array.

getURIs

@NotNull
public @NotNull String[] getURIs()

Description copied from interface: NamespaceRegistry

Returns an array holding all currently registered URIs.

Specified by:

getURIs in interface NamespaceRegistry

Returns:

a string array.

getURI

@NotNull
public @NotNull String getURI(String prefix)
                       throws NamespaceException

Description copied from interface: NamespaceRegistry

Returns the URI to which the given prefix is mapped.

Specified by:

getURI in interface NamespaceRegistry

Parameters:

prefix - a string.

Returns:

a string.

Throws:

NamespaceException - if a mapping with the specified prefix does not exist.

getPrefix

@NotNull
public @NotNull String getPrefix(String uri)
                          throws NamespaceException

Description copied from interface: NamespaceRegistry

Returns the prefix which is mapped to the given uri.

Specified by:

getPrefix in interface NamespaceRegistry

Parameters:

uri - a string.

Returns:

a string.

Throws:

NamespaceException - if a mapping with the specified uri does not exist.