Package org.geotools.util
Class LocalName
- Object
-
- GenericName
-
- LocalName
-
- All Implemented Interfaces:
Serializable
,Comparable<GenericName>
,GenericName
,LocalName
public class LocalName extends GenericName implements LocalName
Identifier within a name space for a local object. This could be the target object of theGenericName
, or a pointer to another name space (with a newGenericName
) one step closer to the target of the identifier.- Since:
- 2.1
- Author:
- Martin Desruisseaux (IRD)
- See Also:
NameFactory
, Serialized Form
-
-
Field Summary
-
Fields inherited from class GenericName
DEFAULT_SEPARATOR
-
-
Constructor Summary
Constructors Constructor Description LocalName(CharSequence name)
Constructs a local name from the specified string with no scope.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description int
compareTo(GenericName object)
Compares this name with the specified object for order.int
depth()
Returns the depth, which is always 1 for a local name.boolean
equals(Object object)
Compares this local name with the specified object for equality.protected GenericName
getInternalScope()
Returns the scope (name space) of this generic name.List<LocalName>
getParsedNames()
Returns the sequence of local name for this generic name.int
hashCode()
Returns a hash code value for this local name.LocalName
head()
Since this object is already a local name, this method always returnsthis
.ScopedName
push(GenericName scope)
Returns this name expanded with the specified scope.NameSpace
scope()
Returns the scope (name space) in which this name is local.LocalName
tip()
Since this object is already a local name, this method always returnsthis
.GenericName
toFullyQualifiedName()
Returns a view of this name as a fully-qualified name.InternationalString
toInternationalString()
Returns a local-dependent string representation of this locale name.String
toString()
Returns a locale-independant string representation of this local name.
-
-
-
Constructor Detail
-
LocalName
public LocalName(CharSequence name)
Constructs a local name from the specified string with no scope. If the specified name is anInternationalString
, then thetoString(null)
method will be used in order to fetch an unlocalized name. Otherwise, thetoString()
method will be used.- Parameters:
name
- The local name (nevernull
).
-
-
Method Detail
-
getInternalScope
protected GenericName getInternalScope()
Returns the scope (name space) of this generic name. This method is protected from overriding by the user.- Specified by:
getInternalScope
in classGenericName
-
scope
public NameSpace scope()
Returns the scope (name space) in which this name is local. The scope is set on creation and is not modifiable. The scope of a name determines where a name "starts". For instance, if a name has a depth of two ("util.GenericName"
) and is associated with a name space having the name"org.opengis"
, then the fully qualified name would be"org.geotools.api.util.GenericName"
.- Specified by:
scope
in interfaceGenericName
- Overrides:
scope
in classGenericName
- Returns:
- The name space.
- Since:
- 2.3
-
depth
public int depth()
Returns the depth, which is always 1 for a local name.- Specified by:
depth
in interfaceGenericName
- Specified by:
depth
in interfaceLocalName
- Overrides:
depth
in classGenericName
- Returns:
- The depth of this name.
- Since:
- 2.3
-
getParsedNames
public List<LocalName> getParsedNames()
Returns the sequence of local name for this generic name. Since this object is itself a locale name, this method always returns a singleton containing onlythis
.- Specified by:
getParsedNames
in interfaceGenericName
- Specified by:
getParsedNames
in interfaceLocalName
- Specified by:
getParsedNames
in classGenericName
- Returns:
- The sequence of local names.
-
head
public LocalName head()
Since this object is already a local name, this method always returnsthis
.- Specified by:
head
in interfaceGenericName
- Specified by:
head
in interfaceLocalName
- Overrides:
head
in classGenericName
- Returns:
- The first element of this name.
-
tip
public LocalName tip()
Since this object is already a local name, this method always returnsthis
.- Specified by:
tip
in interfaceGenericName
- Specified by:
tip
in interfaceLocalName
- Overrides:
tip
in classGenericName
- Returns:
- The last element of this name.
-
toFullyQualifiedName
public GenericName toFullyQualifiedName()
Returns a view of this name as a fully-qualified name. The scope of a fully qualified name must be global. This method never returnsnull
.- Specified by:
toFullyQualifiedName
in interfaceGenericName
- Returns:
- The fully-qualified name (never
null
). - Since:
- 2.3
-
push
public ScopedName push(GenericName scope)
Returns this name expanded with the specified scope. One may represent this operation as a concatenation of the specifiedname
withthis
. In pseudo-code, the following relationships must hold:push(name).getParsedList() == name.getParsedList().addAll(getParsedNames())
push(name).scope() == name.scope()
Note: Those conditions can be understood in terms of the Java
equals
method instead of the Java identity comparator==
.- Specified by:
push
in interfaceGenericName
- Parameters:
scope
- The name to use as prefix.- Returns:
- A concatenation of the given name with this name.
- Since:
- 2.3
-
toString
public String toString()
Returns a locale-independant string representation of this local name. This string do not includes the scope, which is consistent with the parsed names definition.- Specified by:
toString
in interfaceGenericName
- Specified by:
toString
in interfaceLocalName
- Overrides:
toString
in classGenericName
- Returns:
- A string representation of this name.
-
toInternationalString
public InternationalString toInternationalString()
Returns a local-dependent string representation of this locale name.- Specified by:
toInternationalString
in interfaceGenericName
- Overrides:
toInternationalString
in classGenericName
- Returns:
- A localizable string representation of this name.
-
compareTo
public int compareTo(GenericName object)
Compares this name with the specified object for order. Returns a negative integer, zero, or a positive integer as this name lexicographically precedes, is equals to, or follows the specified object. The comparaison is case-insensitive.- Specified by:
compareTo
in interfaceComparable<GenericName>
- Overrides:
compareTo
in classGenericName
- Parameters:
object
- The name to compare with this name.- Returns:
- -1 if this name precedes the given one, +1 if it follows, 0 if equals.
-
equals
public boolean equals(Object object)
Compares this local name with the specified object for equality.- Overrides:
equals
in classGenericName
- Parameters:
object
- The object to compare with this name.- Returns:
true
if the given object is equals to this one.
-
hashCode
public int hashCode()
Returns a hash code value for this local name.- Overrides:
hashCode
in classGenericName
-
-