sis-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From desruisse...@apache.org
Subject [sis] 01/02: Documentation and addition of ‱ as a legal symbol.
Date Thu, 19 Jul 2018 22:42:33 GMT
This is an automated email from the ASF dual-hosted git repository.

desruisseaux pushed a commit to branch geoapi-4.0
in repository https://gitbox.apache.org/repos/asf/sis.git

commit a95984223d78ae77010fdfcceb204c7922812c28
Author: Martin Desruisseaux <martin.desruisseaux@geomatys.com>
AuthorDate: Thu Jul 19 19:40:09 2018 +0200

    Documentation and addition of ‱ as a legal symbol.
---
 .../src/main/java/org/apache/sis/measure/AbstractUnit.java  |  4 ++--
 .../src/main/java/org/apache/sis/measure/Salinity.java      |  6 +++++-
 .../main/java/org/apache/sis/storage/sql/package-info.java  | 13 ++++++++++++-
 3 files changed, 19 insertions(+), 4 deletions(-)

diff --git a/core/sis-utility/src/main/java/org/apache/sis/measure/AbstractUnit.java b/core/sis-utility/src/main/java/org/apache/sis/measure/AbstractUnit.java
index 91f9c26..179e868 100644
--- a/core/sis-utility/src/main/java/org/apache/sis/measure/AbstractUnit.java
+++ b/core/sis-utility/src/main/java/org/apache/sis/measure/AbstractUnit.java
@@ -53,7 +53,7 @@ import org.apache.sis.util.resources.Errors;
  * All unit instances shall be immutable and thread-safe.
  *
  * @author  Martin Desruisseaux (MPO, Geomatys)
- * @version 0.8
+ * @version 1.0
  *
  * @param <Q>  the kind of quantity to be measured using this units.
  *
@@ -382,7 +382,7 @@ abstract class AbstractUnit<Q extends Quantity<Q>> implements
Unit<Q>, LenientCo
      * that class are known to be consistent with SI usage or with {@link UnitFormat} work.</p>
      */
     static boolean isSymbolChar(final int c) {
-        return Character.isLetter(c) || Characters.isSubScript(c) || "°'′’\"″%‰-_".indexOf(c)
>= 0;
+        return Character.isLetter(c) || Characters.isSubScript(c) || "°'′’\"″%‰‱-_".indexOf(c)
>= 0;
     }
 
     /**
diff --git a/core/sis-utility/src/main/java/org/apache/sis/measure/Salinity.java b/core/sis-utility/src/main/java/org/apache/sis/measure/Salinity.java
index 1c26c35..c688abd 100644
--- a/core/sis-utility/src/main/java/org/apache/sis/measure/Salinity.java
+++ b/core/sis-utility/src/main/java/org/apache/sis/measure/Salinity.java
@@ -25,6 +25,11 @@ import javax.measure.Quantity;
  * In principle, the unit of measurement associated to this quantity has no symbol.
  * However Apache SIS uses the "psu" symbol for avoiding confusion with other dimensionless
units.
  *
+ * <p>{@code Salinity} quantities should not be converted to quantities of other types.
+ * If nevertheless a conversion to {@link javax.measure.quantity.Dimensionless} is attempted,
+ * then Apache SIS implementation maps 1 psu to 1‰ for approximative correspondence with
legacy
+ * (before 1978) salinity measurements.</p>
+ *
  * <p>Most quantity types are defined in the {@link javax.measure.quantity}.
  * This {@code Salinity} type is an extension to the standard types.</p>
  *
@@ -34,7 +39,6 @@ import javax.measure.Quantity;
  * @module
  *
  * @see Units#PSU
- * @see AngularVelocity
  */
 public interface Salinity extends Quantity<Salinity> {
 }
diff --git a/storage/sis-sqlstore/src/main/java/org/apache/sis/storage/sql/package-info.java
b/storage/sis-sqlstore/src/main/java/org/apache/sis/storage/sql/package-info.java
index 4ab7e5f..29ce702 100644
--- a/storage/sis-sqlstore/src/main/java/org/apache/sis/storage/sql/package-info.java
+++ b/storage/sis-sqlstore/src/main/java/org/apache/sis/storage/sql/package-info.java
@@ -18,7 +18,18 @@
 
 /**
  * Data store capable to read and create features from a JDBC connection to a database.
- * An example of spatial database is PostGIS.
+ * {@link org.apache.sis.storage.sql.SQLStore} takes a one or more tables at construction
time.
+ * Each enumerated table is represented by a {@link org.opengis.feature.FeatureType}.
+ * Each relation defined by a foreigner key is represented by an {@link org.opengis.feature.FeatureAssociationRole}
+ * to another feature (with transitive dependencies automatically resolved), and the other
columns are represented
+ * by {@link org.opengis.feature.AttributeType}.
+ *
+ * <div class="section">Limitations</div>
+ * <ul>
+ *   <li>Current implementation does not yet map geometric objects (e.g. PostGIS types).</li>
+ *   <li>If a parent feature contains association to other features, those other features
are created
+ *       in same time than the parent feature (no lazy instantiation yet).</li>
+ * </ul>
  *
  * @author  Johann Sorel (Geomatys)
  * @author  Martin Desruisseaux (Geomatys)


Mime
View raw message