sis-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From desruisse...@apache.org
Subject svn commit: r1718971 - in /sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/factory: ConcurrentAuthorityFactory.java GeodeticAuthorityFactory.java
Date Wed, 09 Dec 2015 21:32:44 GMT
Author: desruisseaux
Date: Wed Dec  9 21:32:44 2015
New Revision: 1718971

URL: http://svn.apache.org/viewvc?rev=1718971&view=rev
Log:
Removed the getBackingStoreDescription() method. Instead, suggest a location in the citation
returned by getAuthority().

Modified:
    sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/factory/ConcurrentAuthorityFactory.java
    sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/factory/GeodeticAuthorityFactory.java

Modified: sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/factory/ConcurrentAuthorityFactory.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/factory/ConcurrentAuthorityFactory.java?rev=1718971&r1=1718970&r2=1718971&view=diff
==============================================================================
--- sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/factory/ConcurrentAuthorityFactory.java
[UTF-8] (original)
+++ sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/factory/ConcurrentAuthorityFactory.java
[UTF-8] Wed Dec  9 21:32:44 2015
@@ -534,28 +534,6 @@ public abstract class ConcurrentAuthorit
     }
 
     /**
-     * Returns a description of the underlying backing store, or {@code null} if unknown.
-     * The default implementation performs the following steps:
-     * <ol>
-     *   <li>get an instance of the backing store,</li>
-     *   <li>delegate to its {@link GeodeticAuthorityFactory#getBackingStoreDescription()}
method,</li>
-     *   <li>release the backing store.</li>
-     * </ol>
-     *
-     * @return A description of the underlying backing store, or {@code null} if none.
-     * @throws FactoryException if a failure occurred while fetching the backing store description.
-     */
-    @Override
-    public InternationalString getBackingStoreDescription() throws FactoryException {
-        final GeodeticAuthorityFactory factory = getBackingStore();
-        try {
-            return factory.getBackingStoreDescription();
-        } finally {
-            release();
-        }
-    }
-
-    /**
      * Returns the set of authority codes for objects of the given type.
      * The default implementation performs the following steps:
      * <ol>

Modified: sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/factory/GeodeticAuthorityFactory.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/factory/GeodeticAuthorityFactory.java?rev=1718971&r1=1718970&r2=1718971&view=diff
==============================================================================
--- sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/factory/GeodeticAuthorityFactory.java
[UTF-8] (original)
+++ sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/referencing/factory/GeodeticAuthorityFactory.java
[UTF-8] Wed Dec  9 21:32:44 2015
@@ -31,7 +31,6 @@ import org.opengis.util.ScopedName;
 import org.opengis.util.GenericName;
 import org.opengis.util.NameFactory;
 import org.opengis.util.FactoryException;
-import org.opengis.util.InternationalString;
 import org.apache.sis.internal.util.Citations;
 import org.apache.sis.referencing.AbstractIdentifiedObject;
 import org.apache.sis.util.iso.AbstractFactory;
@@ -85,6 +84,25 @@ public abstract class GeodeticAuthorityF
      * This method may return {@code null} if it can not obtain this information, for example
because
      * the connection to a database is not available.
      *
+     * <div class="note"><b>Example</b>
+     * A factory that create coordinate reference system objects from EPSG codes could return
+     * a citation like below:
+     *
+     * {@preformat text
+     *   Citation
+     *    ├─ Title ……………………………………………………… EPSG
Geodetic Parameter Dataset
+     *    ├─ Identifier ………………………………………… EPSG
+     *    ├─ Online resource (1 of 2)
+     *    │   ├─ Linkage ……………………………………… http://epsg-registry.org/
+     *    │   └─ Function …………………………………… Browse
+     *    └─ Online resource (2 of 2)
+     *        ├─ Linkage ……………………………………… jdbc:derby:/my/path/to/SIS_DATA/Metadata
+     *        ├─ Description …………………………… EPSG dataset version 8.8
on “Apache Derby Embedded JDBC Driver” version 10.12.
+     *        └─ Function …………………………………… Connection
+     * }
+     *
+     * The online resource description with a “Connection” function is a SIS extension.</div>
+     *
      * @return The organization responsible for definition of the database, or {@code null}
if unknown.
      *
      * @see #getVendor()
@@ -93,19 +111,6 @@ public abstract class GeodeticAuthorityF
     public abstract Citation getAuthority();
 
     /**
-     * Returns a description of the underlying backing store, or {@code null} if unknown.
-     * This is for example the database software used for storing the data.
-     *
-     * <p>The default implementation returns always {@code null}.</p>
-     *
-     * @return A description of the underlying backing store, or {@code null} if none.
-     * @throws FactoryException if a failure occurred while fetching the backing store description.
-     */
-    public InternationalString getBackingStoreDescription() throws FactoryException {
-        return null;
-    }
-
-    /**
      * Returns an arbitrary object from a code. The returned object will typically be an
instance of {@link Datum},
      * {@link CoordinateSystem}, {@link CoordinateReferenceSystem} or {@link CoordinateOperation}.
      *



Mime
View raw message