Package org.apache.sis.referencing.gazetteer

Class ReferencingByIdentifiers

java.lang.Object
org.apache.sis.io.wkt.FormattableObject
org.apache.sis.referencing.AbstractIdentifiedObject
org.apache.sis.referencing.AbstractReferenceSystem
org.apache.sis.referencing.gazetteer.ReferencingByIdentifiers
All Implemented Interfaces:
Serializable, Formattable, Deprecable, LenientComparable, org.opengis.referencing.IdentifiedObject, org.opengis.referencing.ReferenceSystem
Direct Known Subclasses:
GeohashReferenceSystem, MilitaryGridReferenceSystem
public abstract class ReferencingByIdentifiers extends AbstractReferenceSystem
Base class of reference systems that describe locations using geographic identifiers instead of coordinates.

Immutability and thread safety

This base class is immutable and thus thread-safe if the property values (not necessarily the map itself) given to the constructor are also immutable. Most SIS subclasses and related classes are immutable under similar conditions. This means that unless otherwise noted in the javadoc, ReferencingByIdentifiers instances created using only SIS factories and static constants can be shared by many objects and passed between threads without synchronization.
Since:
0.8
Version:
1.3
Author:
Martin Desruisseaux (Geomatys)
See Also:

  • Field Details

  • Constructor Details

  • Method Details

    • getTheme

      public org.opengis.util.InternationalString getTheme()
      Property used to characterize the spatial reference system.
      Returns:
      property used to characterize the spatial reference system.
      See Also:

    • getOverallOwner

      public AbstractParty getOverallOwner()
      Authority with overall responsibility for the spatial reference system.
      Upcoming API change — generalization
      in a future SIS version, the type of returned element may be generalized to the org.opengis.metadata.citation.Party interface. This change is pending GeoAPI revision for upgrade from ISO 19115:2003 to ISO 19115:2014.
      Returns:
      authority with overall responsibility for the spatial reference system.
      See Also:

    • getLocationTypes

      public List<? extends ModifiableLocationType> getLocationTypes()
      Description of location type(s) in the spatial reference system. The collection returned by this method is unmodifiable.
      Upcoming API change — generalization
      in a future SIS version, the type of elements type may be generalized to the org.opengis.referencing.gazetteer.Location interface. This change is pending GeoAPI revision.
      Returns:
      description of location type(s) in the spatial reference system.
      See Also:

    • createCoder

      public abstract ReferencingByIdentifiers.Coder createCoder()
      Returns a new object performing conversions between DirectPosition and identifiers. The returned object is not thread-safe; a new instance must be created for each thread, or synchronization must be applied by the caller.
      Returns:
      a new object performing conversions between DirectPosition and identifiers.
      Since:
      1.3

    • equals

      public boolean equals(Object object, ComparisonMode mode)
      Compares this reference system with the specified object for equality. If the mode argument value is STRICT or BY_CONTRACT, then all available properties are compared including the theme and the overall owner.
      Specified by:
      equals in interface LenientComparable
      Overrides:
      equals in class AbstractReferenceSystem
      Parameters:
      object - the object to compare to this.
      mode - STRICT for performing a strict comparison, or IGNORE_METADATA for comparing only properties relevant to location identifications.
      Returns:
      true if both objects are equal.
      See Also:

    • computeHashCode

      protected long computeHashCode()
      Invoked by hashCode() for computing the hash code when first needed. See AbstractIdentifiedObject.computeHashCode() for more information.
      Overrides:
      computeHashCode in class AbstractReferenceSystem
      Returns:
      the hash code value. This value may change in any future Apache SIS version.

    • formatTo

      @Debug protected String formatTo(Formatter formatter)
      Formats a pseudo-Well Known Text (WKT) representation for this object. The format produced by this method is non-standard and may change in any future Apache SIS version.
      Overrides:
      formatTo in class AbstractIdentifiedObject
      Parameters:
      formatter - the formatter where to format the inner content of this pseudo-WKT element.
      Returns:
      an arbitrary keyword for the pseudo-WKT element.
      See Also: