made product validity time configurable

Author: ajungg

build.gradle

@@ -24,7 +24,7 @@ allprojects {
     }
 
     project.ext {
-        sdkVersion='0.11.0-alpha6'
+        sdkVersion='0.11.0-alpha7'
         versionCode=1
 
         compileSdkVersion=28

core/src/main/java/io/snabble/sdk/ProductDatabase.java

@@ -492,6 +492,11 @@ private Cursor rawQuery(String sql, String[] args, CancellationSignal cancellati
      * <p>
      * While updating, the database can still be queried for data, after the update completes calls to the database
      * return the updated data.
+     *
+     * Note that database updates are usually very cheap and do not transmit data that is already on your device.
+     *
+     * If the database is not present or schematic changes are done that can not be resolved via a delta update
+     * a full update is needed.
      */
     public void update() {
         update(null);
@@ -506,6 +511,11 @@ public void update() {
      * While updating, the database can still be queried for data, after the update completes calls to the database
      * return the updated data.
      *
+     * Note that database updates are usually very cheap and do not transmit data that is already on your device.
+     *
+     * If the database is not present or schematic changes are done that can not be resolved via a delta update
+     * a full update is needed.
+     *
      * @param callback A {@link UpdateCallback} that returns success when the operation is successfully completed.
      *                 Or error() in case a network error occurred.
      */
@@ -522,6 +532,11 @@ public void update(final UpdateCallback callback) {
      * While updating, the database can still be queried for data, after the update completes calls to the database
      * return the updated data.
      *
+     * Note that database updates are usually very cheap and do not transmit data that is already on your device.
+     *
+     * If the database is not present or schematic changes are done that can not be resolved via a delta update
+     * a full update is needed.
+     *
      * @param callback        A {@link UpdateCallback} that returns success when the operation is successfully completed.
      *                        Or error() in case a network error occurred. Can be null.
      * @param deltaUpdateOnly set to true if you want to only update when the update would be an delta update
@@ -869,7 +884,7 @@ public boolean isUpToDate() {
         if (lastUpdateDate != null) {
             long time = lastUpdateDate.getTime();
             long currentTime = new Date().getTime();
-            long t = time + TimeUnit.HOURS.toMillis(1);
+            long t = time + Snabble.getInstance().getConfig().productDbValidityTimeMs;
             return t > currentTime;
         }
 

core/src/main/java/io/snabble/sdk/Snabble.java

@@ -23,6 +23,7 @@
 import java.util.Locale;
 import java.util.concurrent.CopyOnWriteArrayList;
 import java.util.concurrent.CountDownLatch;
+import java.util.concurrent.TimeUnit;
 
 import javax.net.ssl.SSLSocketFactory;
 import javax.net.ssl.X509TrustManager;
@@ -490,6 +491,14 @@ public static class Config {
          */
         public boolean generateSearchIndex;
 
+        /**
+         * The time that the database is allowed to be out of date. After the specified time in
+         * milliseconds the database only uses online requests for asynchronous requests.
+         *
+         * Successfully calling {@link ProductDatabase#update()} resets the timer.
+         */
+        public long productDbValidityTimeMs = TimeUnit.HOURS.toMillis(1);
+
         /**
          * If set to true, downloads receipts automatically and stores them in the projects
          * internal storage folder.