Package org.iogp.gigs

Class Series3000<T>

Object
IntegrityTest
Series3000<T>
Type Parameters:
T - the type of objects to test.
Direct Known Subclasses:
Test3201, Test3202, Test3203, Test3204, Test3205, Test3206, Test3207, Test3208, Test3209, Test3210, Test3211, Test3212

public abstract class Series3000<T> extends IntegrityTest
Base class for tests of new CRS definitions (3000 series). The test procedures in this series evaluate the software’s capabilities for adding user-defined CRS and transformation definitions. The geodetic objects are created using one or many ObjectFactory sub-types.

Authority factory usage

In addition to the ObjectFactory to test, some test cases use also an AuthorityFactory. The authority factories are always optional in the 3000 series; providing null authority factories may disable some test cases, but not all of them. Sometimes the test cases exist in two variants: one creating the object fully using only ObjectFactory, and another variant creating the same object where some components are created using AuthorityFactory.
Since:
1.0
  • Field Details

    • properties

      public final Map<String,Object> properties
      The properties to be given in argument to a ObjectFactory.createXXX(String) method. This map contains at least the given entries: This map is populated by all test methods before to create and verify the T instance.
    • isFactoryPreservingUserValues

      protected boolean isFactoryPreservingUserValues
      Whether the objects created by the tested ObjectFactory use the specified values as-is. This flag should be set to false if the factory performs any of the following operations:
      • Convert numerical values from user-provided linear units to metres.
      • Convert numerical values from user-provided angular units to degrees.
      • Change ellipsoid second defining parameter (e.g. from semi-major axis length to an equivalent inverse flattening factor).
      • Change map projection parameters (e.g. from standard parallel to an equivalent scale factor).
      • Any other change that preserve numeric equivalence.
      If the factory does not perform any of the above conversions, then this flag can be true.
  • Method Details

    • getIdentifiedObject

      public abstract T getIdentifiedObject() throws FactoryException
      Returns the instance to be tested. When this method is invoked for the first time, it creates the instance to test by invoking a createXXX(String) method from the user-specified ObjectFactory with the current properties in argument. The created object is then cached and returned in subsequent invocations of this method.
      Returns:
      the instance to test.
      Throws:
      FactoryException - if an error occurred while creating the identified object.