Class LocalName

    • Constructor Detail

      • LocalName

        public LocalName​(CharSequence name)
        Constructs a local name from the specified string with no scope. If the specified name is an InternationalString, then the toString(null) method will be used in order to fetch an unlocalized name. Otherwise, the toString() method will be used.
        Parameters:
        name - The local name (never null).
    • 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 class GenericName
      • 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 interface GenericName
        Overrides:
        scope in class GenericName
        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 interface GenericName
        Specified by:
        depth in interface LocalName
        Overrides:
        depth in class GenericName
        Returns:
        The depth of this name.
        Since:
        2.3
      • head

        public LocalName head()
        Since this object is already a local name, this method always returns this.
        Specified by:
        head in interface GenericName
        Specified by:
        head in interface LocalName
        Overrides:
        head in class GenericName
        Returns:
        The first element of this name.
      • tip

        public LocalName tip()
        Since this object is already a local name, this method always returns this.
        Specified by:
        tip in interface GenericName
        Specified by:
        tip in interface LocalName
        Overrides:
        tip in class GenericName
        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 returns null.
        Specified by:
        toFullyQualifiedName in interface GenericName
        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 specified name with this. In pseudo-code, the following relationships must hold:

        Note: Those conditions can be understood in terms of the Java equals method instead of the Java identity comparator ==.

        Specified by:
        push in interface GenericName
        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 interface GenericName
        Specified by:
        toString in interface LocalName
        Overrides:
        toString in class GenericName
        Returns:
        A 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 interface Comparable<GenericName>
        Overrides:
        compareTo in class GenericName
        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 class GenericName
        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 class GenericName