org.apache.sis.util.iso

Class DefaultNameSpace

Object

DefaultNameSpace

All Implemented Interfaces:

Serializable, NameSpace

public class DefaultNameSpace
extends Object
implements NameSpace, Serializable

A domain in which names given by character strings are defined. This implementation does not support localization in order to avoid ambiguity when testing two namespaces for equality.

Default­Name­Space can be instantiated by any of the following methods:

• Default­Name­Factory.create­Name­Space(Generic­Name, Map)

Immutability and thread safety

This class is immutable and thus inherently thread-safe if the Name­Space and Char­Sequence arguments given to the constructor are also immutable. Subclasses shall make sure that any overridden methods remain safe to call from multiple threads and do not change any public Name­Space state.

Since:

0.3

See Also:

Default­Scoped­Name, Default­Local­Name, Default­Type­Name, Default­Member­Name, Default­Name­Factory, Serialized Form

Defined in the sis-utility module

Field Summary

Fields

Modifier and Type	Field and Description
static char	DEFAULT_SEPARATOR The default separator, which is ':'.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	DefaultNameSpace(DefaultNameSpace parent, CharSequence name, String headSeparator, String separator) Creates a new namespace with the given separator.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object object) Returns true if this namespace is equal to the given object.
int	hashCode() Returns a hash code value for this namespace.
boolean	isGlobal() Indicates whether this namespace is a "top level" namespace.
GenericName	name() Represents the identifier of this namespace.
String	toString() Returns a JCR-like lexical form representation of this namespace.

Methods inherited from class Object

clone, finalize, get­Class, notify, notify­All, wait, wait, wait

Field Detail

DEFAULT_SEPARATOR

public static final char DEFAULT_SEPARATOR

The default separator, which is ':'. The separator is inserted between the namespace and any generic name in that namespace.

See Also:

Constant Field Values

Constructor Detail

DefaultNameSpace

protected DefaultNameSpace(DefaultNameSpace parent,
                           CharSequence name,
                           String headSeparator,
                           String separator)

Creates a new namespace with the given separator.

Parameters:

parent - the parent namespace, or null if none.

name - the name of the new namespace, usually as a String or an International­String.

head­Separator - the separator to insert between the namespace and the head of any name in that namespace.

separator - the separator to insert between the parsed names of any name in that namespace.

Method Detail

isGlobal

public boolean isGlobal()

Indicates whether this namespace is a "top level" namespace. Global, or top-level namespaces are not contained within another namespace. The global namespace has no parent.

Specified by:

is­Global in interface Name­Space

Returns:

true if this namespace is the global namespace.

name

public GenericName name()

Represents the identifier of this namespace. Namespace identifiers shall be fully-qualified names where the following condition holds:

assert name.scope().isGlobal() == true;

Specified by:

name in interface Name­Space

Returns:

the identifier of this namespace.

toString

@Debug
public String toString()

Returns a JCR-like lexical form representation of this namespace. Following the Java Content Repository (JCR) convention, this method returns the string representation of name() between curly brackets.

Example: if the name of this namespace is “org.apache.sis”, then this method returns “{org.apache.sis}”.

Usage

With this convention, it would be possible to create an expanded form of a generic name (except for escaping of illegal characters) with a simple concatenation as in the following code example:

GenericName name = ...; // A name
println("Expanded form = " + name.scope() + name);

However the convention followed by this Default­Name­Space implementation is not specified in the Name­Space contract. This implementation follows the JCR convention for debugging convenience, but applications needing better guarantees should use Names.to­Expanded­String(Generic­Name) instead.

Overrides:

to­String in class Object

Returns:

a JCR-like lexical form of this namespace.

See Also:

Names.to­Expanded­String(Generic­Name)

equals

public boolean equals(Object object)

Returns true if this namespace is equal to the given object.

Overrides:

equals in class Object

Parameters:

object - the object to compare with this namespace.

Returns:

true if the given object is equal to this namespace.

hashCode

public int hashCode()

Returns a hash code value for this namespace.

Overrides:

hash­Code in class Object