Class AbstractReferenceSystem

All Implemented Interfaces:
Serializable, IdentifiedObject, ReferenceSystem
Direct Known Subclasses:
AbstractCRS

public class AbstractReferenceSystem extends AbstractIdentifiedObject implements ReferenceSystem
Description of a spatial and temporal reference system used by a dataset.

This class is conceptually abstract, even if it is technically possible to instantiate it. Typical applications should create instances of the most specific subclass with Default prefix instead. An exception to this rule may occurs when it is not possible to identify the exact type.

Since:
2.1
Author:
Martin Desruisseaux (IRD)
See Also:
  • Constructor Details

    • AbstractReferenceSystem

      public AbstractReferenceSystem(ReferenceSystem object)
      Constructs a new reference system with the same values than the specified one. This copy constructor provides a way to wrap an arbitrary implementation into a Geotools one or a user-defined one (as a subclass), usually in order to leverage some implementation-specific API. This constructor performs a shallow copy, i.e. the properties are not cloned.
      Parameters:
      object - The reference system to copy.
      Since:
      2.2
    • AbstractReferenceSystem

      public AbstractReferenceSystem(Map<String,?> properties)
      Constructs a reference system from a set of properties. The properties given in argument follow the same rules than for the super-class constructor. Additionally, the following properties are understood by this construtor:

      Property name Value type Value given to
       "domainOfValidity"   Extent   getDomainOfValidity()
       "scope"   String or InternationalString   getScope()
      Parameters:
      properties - The properties to be given to this object.
  • Method Details

    • getDomainOfValidity

      public Extent getDomainOfValidity()
      Area or region or timeframe in which this (coordinate) reference system is valid. Returns null if not available.
      Specified by:
      getDomainOfValidity in interface ReferenceSystem
      Returns:
      The reference system valid domain, or null if not available.
      Since:
      2.4
    • getScope

      public InternationalString getScope()
      Description of domain of usage, or limitations of usage, for which this (coordinate) reference system object is valid. Returns null if not available.
      Specified by:
      getScope in interface ReferenceSystem
      Returns:
      The domain of usage, or null if none.
    • equals

      public boolean equals(AbstractIdentifiedObject object, boolean compareMetadata)
      Compare this reference system with the specified object for equality. If compareMetadata is true, then all available properties are compared including getDomainOfValidity() valid area} and scope.
      Overrides:
      equals in class AbstractIdentifiedObject
      Parameters:
      object - The object to compare to this.
      compareMetadata - true for performing a strict comparaison, or false for comparing only properties relevant to transformations.
      Returns:
      true if both objects are equal.