Add to StorIO.LowLevel getter for underlying sqLiteOpenHelper

storio-sqlite/src/main/java/com/pushtorefresh/storio/sqlite/StorIOSQLite.java

@@ -2,6 +2,7 @@
 
 import android.content.ContentValues;
 import android.database.Cursor;
+import android.database.sqlite.SQLiteOpenHelper;
 import android.support.annotation.NonNull;
 import android.support.annotation.Nullable;
 import android.support.annotation.WorkerThread;
@@ -329,6 +330,21 @@ public static abstract class LowLevel {
          * how to use this and when transactions are committed and rolled back.
          */
         public abstract void endTransaction();
+
+        /**
+         * Returns {@link SQLiteOpenHelper} for the direct access to underlining database.
+         * It can be used in cases when {@link StorIOSQLite} APIs are not enough.
+         * <p>
+         * Notice: Database changes through the direct access
+         * to the {@link SQLiteOpenHelper} will not trigger notifications.
+         * If it possible you should use {@link StorIOSQLite} methods instead
+         * or call {@link #notifyAboutChanges(Changes)} manually.
+         *
+         * @return {@link SQLiteOpenHelper}.
+         */
+        @NonNull
+        public abstract SQLiteOpenHelper sqliteOpenHelper();
+
     }
 
     /**

storio-sqlite/src/main/java/com/pushtorefresh/storio/sqlite/impl/DefaultStorIOSQLite.java

@@ -493,6 +493,15 @@ public void endTransaction() {
             numberOfRunningTransactions.decrementAndGet();
             notifyAboutPendingChangesIfNotInTransaction();
         }
+
+        /**
+         * {@inheritDoc}
+         */
+        @NonNull
+        @Override
+        public SQLiteOpenHelper sqliteOpenHelper() {
+            return sqLiteOpenHelper;
+        }
     }
 
     /**

storio-sqlite/src/test/java/com/pushtorefresh/storio/sqlite/design/DesignTestStorIOSQLite.java

@@ -2,6 +2,7 @@
 
 import android.content.ContentValues;
 import android.database.Cursor;
+import android.database.sqlite.SQLiteOpenHelper;
 import android.support.annotation.NonNull;
 import android.support.annotation.Nullable;
 
@@ -94,6 +95,14 @@ public void setTransactionSuccessful() {
         public void endTransaction() {
             // no impl
         }
+
+        @NonNull
+        @Override
+        public SQLiteOpenHelper sqliteOpenHelper() {
+            // not required in design test
+            // noinspection ConstantConditions
+            return null;
+        }
     };
 
     @NonNull

storio-sqlite/src/test/java/com/pushtorefresh/storio/sqlite/impl/DefaultStorIOSQLiteTest.java

@@ -68,6 +68,15 @@ public void nullSQLiteOpenHelper() {
         builder.sqliteOpenHelper(null);
     }
 
+    @Test
+    public void lowLevelReturnsSameInstanceOfSQLiteOpenHelper() {
+        SQLiteOpenHelper sqLiteOpenHelper = mock(SQLiteOpenHelper.class);
+        DefaultStorIOSQLite storIOSQLite = DefaultStorIOSQLite.builder()
+                .sqliteOpenHelper(sqLiteOpenHelper)
+                .build();
+        assertThat(storIOSQLite.lowLevel().sqliteOpenHelper()).isSameAs(sqLiteOpenHelper);
+    }
+
     @Test
     public void addTypeMappingNullType() {
         DefaultStorIOSQLite.CompleteBuilder builder = DefaultStorIOSQLite.builder()