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:
    Serialized Form
    • Constructor Detail

      • 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 Detail

      • 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.