Transition before removal of a deprecated method.

Author: desruisseaux

geoapi-conformance/src/main/java/org/opengis/test/referencing/PseudoEpsgFactory.java

@@ -267,6 +267,25 @@ public IdentifiedObject createObject(final String code) throws FactoryException
         }
     }
 
+    /**
+     * Returns a description of the object corresponding to a code.
+     *
+     * @param  code  value allocated by authority.
+     * @return a description of the object, or {@code null} if the object
+     *         corresponding to the specified {@code code} has no description.
+     * @throws NoSuchAuthorityCodeException if the specified {@code code} was not found.
+     * @throws FactoryException if the query failed for some other reason.
+     *
+     * @deprecated This method is ambiguous because the EPSG geodetic registry may allocate
+     *             the same code to different kinds of object.
+     */
+    @Override
+    @SuppressWarnings("removal")
+    @Deprecated(since="3.1", forRemoval=true)
+    public org.opengis.util.InternationalString getDescriptionText(String code) throws FactoryException {
+        return getDescriptionText(CoordinateReferenceSystem.class, code).orElse(null);
+    }
+
 
 
 

geoapi/src/main/java/org/opengis/referencing/crs/CRSAuthorityFactory.java

@@ -314,4 +314,23 @@ default ProjectedCRS createProjectedCRS(final String code) throws FactoryExcepti
     default org.opengis.referencing.IdentifiedObject createObject(String code) throws FactoryException {
         return createCoordinateReferenceSystem(code);
     }
+
+    /**
+     * Returns a description of the object corresponding to a code.
+     *
+     * @param  code  value allocated by authority.
+     * @return a description of the object, or {@code null} if the object
+     *         corresponding to the specified {@code code} has no description.
+     * @throws NoSuchAuthorityCodeException if the specified {@code code} was not found.
+     * @throws FactoryException if the query failed for some other reason.
+     *
+     * @deprecated This method is ambiguous because the EPSG geodetic registry may allocate
+     *             the same code to different kinds of object.
+     */
+    @Override
+    @SuppressWarnings("removal")
+    @Deprecated(since="3.1", forRemoval=true)
+    default org.opengis.util.InternationalString getDescriptionText(String code) throws FactoryException {
+        return getDescriptionText(CoordinateReferenceSystem.class, code).orElse(null);
+    }
 }

geoapi/src/main/java/org/opengis/referencing/cs/CSAuthorityFactory.java

@@ -251,4 +251,23 @@ default ParametricCS createParametricCS(final String code) throws FactoryExcepti
     default org.opengis.referencing.IdentifiedObject createObject(String code) throws FactoryException {
         return createCoordinateSystem(code);
     }
+
+    /**
+     * Returns a description of the object corresponding to a code.
+     *
+     * @param  code  value allocated by authority.
+     * @return a description of the object, or {@code null} if the object
+     *         corresponding to the specified {@code code} has no description.
+     * @throws NoSuchAuthorityCodeException if the specified {@code code} was not found.
+     * @throws FactoryException if the query failed for some other reason.
+     *
+     * @deprecated This method is ambiguous because the EPSG geodetic registry may allocate
+     *             the same code to different kinds of object.
+     */
+    @Override
+    @SuppressWarnings("removal")
+    @Deprecated(since="3.1", forRemoval=true)
+    default org.opengis.util.InternationalString getDescriptionText(String code) throws FactoryException {
+        return getDescriptionText(CoordinateSystem.class, code).orElse(null);
+    }
 }

geoapi/src/main/java/org/opengis/referencing/datum/DatumAuthorityFactory.java

@@ -261,4 +261,23 @@ default DatumEnsemble<?> createDatumEnsemble(String code) throws FactoryExceptio
     default org.opengis.referencing.IdentifiedObject createObject(String code) throws FactoryException {
         return createDatum(code);
     }
+
+    /**
+     * Returns a description of the object corresponding to a code.
+     *
+     * @param  code  value allocated by authority.
+     * @return a description of the object, or {@code null} if the object
+     *         corresponding to the specified {@code code} has no description.
+     * @throws NoSuchAuthorityCodeException if the specified {@code code} was not found.
+     * @throws FactoryException if the query failed for some other reason.
+     *
+     * @deprecated This method is ambiguous because the EPSG geodetic registry may allocate
+     *             the same code to different kinds of object.
+     */
+    @Override
+    @SuppressWarnings("removal")
+    @Deprecated(since="3.1", forRemoval=true)
+    default org.opengis.util.InternationalString getDescriptionText(String code) throws FactoryException {
+        return getDescriptionText(Datum.class, code).orElse(null);
+    }
 }