Examples of org.apache.sis.util.LenientComparable

org.apache.sis.util.LenientComparable
Indicates that this object can be compared for equality using different levels of strictness. For example {@link org.opengis.referencing.operation.MathTransform} implementations can becompared ignoring some properties (remarks, etc.) that are not relevant to the coordinates calculation. {@section Conditions for equality}
- {@link org.apache.sis.metadata.iso.ISOMetadata} subclasses
  1. {@link ComparisonMode#STRICT STRICT} – Objects must be of the same classand all attributes must be equal, including {@code xlink} and others{@linkplain org.apache.sis.metadata.iso.ISOMetadata#getIdentifiers() identifiers}.
  2. {@link ComparisonMode#BY_CONTRACT BY_CONTRACT} – The same attributes than the above{@code STRICT} mode must be equal, but the metadata object don't need to be implementedby the same class provided that they implement the same GeoAPI interface.
  3. {@link ComparisonMode#IGNORE_METADATA IGNORE_METADATA} – Only the attributes definedin the GeoAPI interfaces are compared. The above-cited identifiers and {@code xlinks}attributes are ignored.
  4. {@link ComparisonMode#APPROXIMATIVE APPROXIMATIVE} – The same attributes than the above{@code IGNORE_METADATA} mode are compared, but a slight (implementation dependant)difference is tolerated in floating point numbers.
- {@link org.apache.sis.referencing.AbstractIdentifiedObject} subclasses
  1. {@link ComparisonMode#STRICT STRICT} – Objects must be of the same classand all attributes must be equal.
  2. {@link ComparisonMode#BY_CONTRACT BY_CONTRACT} – The same attributes than the above{@code STRICT} mode must be equal, but the referencing object don't need to beimplemented by the same class provided that they implement the same GeoAPI interface.
  3. {@link ComparisonMode#IGNORE_METADATA IGNORE_METADATA} – The{@linkplain org.apache.sis.referencing.crs.AbstractCRS#getIdentifiers() identifiers}, {@linkplain org.apache.sis.referencing.crs.AbstractCRS#getAlias() aliases}, {@linkplain org.apache.sis.referencing.crs.AbstractCRS#getScope() scope}, {@linkplain org.apache.sis.referencing.crs.AbstractCRS#getDomainOfValidity() domain of validity} and{@linkplain org.apache.sis.referencing.crs.AbstractCRS#getRemarks() remarks}are ignored because they have no incidence on the coordinate values to be computed by {@linkplain org.opengis.referencing.operation.ConcatenatedOperation coordinate operations}. All other attributes that are relevant to coordinate calculations, must be equal.
  4. {@link ComparisonMode#APPROXIMATIVE APPROXIMATIVE} – The same attributes than the above{@code IGNORE_METADATA} mode are compared, but a slight (implementation dependant)difference is tolerated in floating point numbers.
- {@link org.apache.sis.referencing.operation.transform.AbstractMathTransform} subclassesexcept {@link org.apache.sis.referencing.operation.transform.LinearTransform}
  1. {@link ComparisonMode#STRICT STRICT} – Objects must be of the same class and allattributes must be equal, including the {@linkplain org.apache.sis.referencing.operation.transform.AbstractMathTransform#getParameterValues() parameter values}.
  2. {@link ComparisonMode#BY_CONTRACT BY_CONTRACT} – Synonymous to the {@code STRICT} mode,because there is no GeoAPI interfaces for the various kind of math transforms.
  3. {@link ComparisonMode#IGNORE_METADATA IGNORE_METADATA} – Objects must be of the sameclass, but the parameter values can be different if they are different way to formulate the same transform. For example a {@code "Mercator (2SP)"} projection with a{@linkplain org.apache.sis.referencing.operation.projection.UnitaryProjection.Parameters#standardParallels standard parallel} value of 60° produces the same results than a {@code "Mercator (1SP)"} projection with a{@linkplain org.apache.sis.referencing.operation.projection.UnitaryProjection.Parameters#scaleFactor scale factor} value of 0.5
  4. {@link ComparisonMode#APPROXIMATIVE APPROXIMATIVE} – The same attributes than the above{@code IGNORE_METADATA} mode are compared, but a slight (implementation dependant)difference is tolerated in floating point numbers.
- {@link org.apache.sis.referencing.operation.matrix.XMatrix} and{@link org.apache.sis.referencing.operation.transform.LinearTransform} implementations
  1. {@link ComparisonMode#STRICT STRICT} – Objects must be of the same class, matrixesmust have the same size and all matrix elements must be equal.
  2. {@link ComparisonMode#BY_CONTRACT BY_CONTRACT} – Matrixes must have the same sizeand all matrix elements must be equal, but the matrixes are not required to be the same implementation class (any {@link org.opengis.referencing.operation.Matrix} is okay).
  3. {@link ComparisonMode#IGNORE_METADATA IGNORE_METADATA} – Synonymous to the{@code BY_CONTRACT} mode, because matrixes don't have metadata.
  4. {@link ComparisonMode#APPROXIMATIVE APPROXIMATIVE} – The same attributes than the above{@code BY_CONTRACT} mode are compared, but a slight (implementation dependant)difference is tolerated in floating point numbers.
@author Martin Desruisseaux (Geomatys) @since 0.3 (derived from geotk-3.18) @version 0.3 @module

        assertFalse ("NilObject.hashCode()", e1.hashCode() == e2.hashCode());
        assertEquals("NilObject.equals(Object)", e1, e3);
        assertFalse ("NilObject.equals(Object)", e1.equals(e2));


        assertInstanceOf("e1", LenientComparable.class, e1);
        final LenientComparable c = (LenientComparable) e1;
        assertTrue (c.equals(e3, ComparisonMode.STRICT));
        assertFalse(c.equals(e2, ComparisonMode.STRICT));
        assertFalse(c.equals(e2, ComparisonMode.BY_CONTRACT));
        assertTrue (c.equals(e2, ComparisonMode.IGNORE_METADATA));
        assertTrue (c.equals(e2, ComparisonMode.APPROXIMATIVE));
        assertTrue (c.equals(e2, ComparisonMode.DEBUG));


        // Following object should alway be different because it does not implement the same interface.
        final ResponsibleParty r1 = NilReason.TEMPLATE.createNilObject(ResponsibleParty.class);
        assertFalse(c.equals(r1, ComparisonMode.STRICT));
        assertFalse(c.equals(r1, ComparisonMode.BY_CONTRACT));
        assertFalse(c.equals(r1, ComparisonMode.IGNORE_METADATA));
        assertFalse(c.equals(r1, ComparisonMode.APPROXIMATIVE));
        assertFalse(c.equals(r1, ComparisonMode.DEBUG));
    }

View Full Code Here

        assertFalse ("NilObject.hashCode()", e1.hashCode() == e2.hashCode());
        assertEquals("NilObject.equals(Object)", e1, e3);
        assertFalse ("NilObject.equals(Object)", e1.equals(e2));


        assertInstanceOf("e1", LenientComparable.class, e1);
        final LenientComparable c = (LenientComparable) e1;
        assertTrue (c.equals(e3, ComparisonMode.STRICT));
        assertFalse(c.equals(e2, ComparisonMode.STRICT));
        assertFalse(c.equals(e2, ComparisonMode.BY_CONTRACT));
        assertTrue (c.equals(e2, ComparisonMode.IGNORE_METADATA));
        assertTrue (c.equals(e2, ComparisonMode.APPROXIMATIVE));
        assertTrue (c.equals(e2, ComparisonMode.DEBUG));


        // Following object should alway be different because it does not implement the same interface.
        final ResponsibleParty r1 = NilReason.TEMPLATE.createNilObject(ResponsibleParty.class);
        assertFalse(c.equals(r1, ComparisonMode.STRICT));
        assertFalse(c.equals(r1, ComparisonMode.BY_CONTRACT));
        assertFalse(c.equals(r1, ComparisonMode.IGNORE_METADATA));
        assertFalse(c.equals(r1, ComparisonMode.APPROXIMATIVE));
        assertFalse(c.equals(r1, ComparisonMode.DEBUG));
    }

View Full Code Here

TOP

Related Classes of org.apache.sis.util.LenientComparable

org.apache.sis.xml.NilReasonTest

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.