001/*
002 *    GeoAPI - Java interfaces for OGC/ISO standards
003 *    Copyright © 2009-2023 Open Geospatial Consortium, Inc.
004 *    http://www.geoapi.org
005 *
006 *    Licensed under the Apache License, Version 2.0 (the "License");
007 *    you may not use this file except in compliance with the License.
008 *    You may obtain a copy of the License at
009 *
010 *        http://www.apache.org/licenses/LICENSE-2.0
011 *
012 *    Unless required by applicable law or agreed to in writing, software
013 *    distributed under the License is distributed on an "AS IS" BASIS,
014 *    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
015 *    See the License for the specific language governing permissions and
016 *    limitations under the License.
017 */
018package org.opengis.test.referencing;
019
020import org.opengis.referencing.crs.*;
021import org.opengis.util.FactoryException;
022import org.opengis.referencing.NoSuchAuthorityCodeException;
023
024import org.junit.jupiter.api.Test;
025
026
027/**
028 * Tests {@link CoordinateReferenceSystem} and related objects
029 * from the {@code org.opengis.referencing.crs} package.
030 * CRS instances are created using the authority factory given at construction time.
031 *
032 * <h2>Usage example:</h2>
033 * in order to specify their factories and run the tests in a JUnit framework, implementers can
034 * define a subclass in their own test suite as in the example below:
035 *
036 * {@snippet lang="java" :
037 * import org.opengis.test.referencing.CRSTest;
038 *
039 * public class MyTest extends CRSTest {
040 *     public MyTest() {
041 *         super(new MyCRSAuthorityFactory());
042 *     }
043 * }}
044 *
045 * @author  Cédric Briançon (Geomatys)
046 * @author  Martin Desruisseaux (Geomatys)
047 * @version 3.1
048 * @since   2.3
049 *
050 * @deprecated Renamed as {@link AuthorityFactoryTest}.
051 */
052@Deprecated
053@SuppressWarnings("strictfp")   // Because we still target Java 11.
054public strictfp class CRSTest extends ReferencingTestCase {
055    /**
056     * The authority factory for creating a {@link CoordinateReferenceSystem} from a code,
057     * or {@code null} if none.
058     */
059    protected final CRSAuthorityFactory factory;
060
061    /**
062     * Creates a new test using the given factory. If the given factory is {@code null},
063     * then the tests will be skipped.
064     *
065     * @param factory  factory for creating {@link CoordinateReferenceSystem} instances.
066     */
067    public CRSTest(final CRSAuthorityFactory factory) {
068        this.factory = factory;
069    }
070
071    /**
072     * Tests the creation of the WGS84 {@linkplain CoordinateReferenceSystem crs} from the
073     * EPSG code.
074     *
075     * @throws NoSuchAuthorityCodeException if the specified code is not found among the ones present in the database.
076     * @throws FactoryException if the creation of the {@link CoordinateReferenceSystem} failed for another reason.
077     */
078    @Test
079    public void testCRSAuthorityCreation() throws NoSuchAuthorityCodeException, FactoryException {
080        new AuthorityFactoryTest(factory, null, null).testWGS84();
081    }
082}