added in memory database and table indexes

Author: p-vincen-t

.idea/gradle.xml

@@ -22,7 +22,7 @@ android {
 dependencies {
      ...
      implementation 'com.github.android-promise:database:TAG'
-     implementation 'com.github.android-promise:commons:1.0'
+     implementation 'com.github.android-promise:commons:1.1-alpha03'
 }
 ```
 
@@ -31,14 +31,20 @@ Initialize Promise in your main application file, entry point
 
 ##### App.java
 ```java
-  ...
+public class App extends Application {
   @Override
   public void onCreate() {
     super.onCreate();
-    Promise.init(this);
-    ...
+    // 10 is the number of threads allowed to run in the background
+    AndroidPromise.init(this, 10, BuildConfig.DEBUG);
   }
-  ...
+
+  @Override
+  public void onTerminate() {
+    super.onTerminate();
+    AndroidPromise.instance().terminate();
+  }
+}
 ```
 
 ## Making your Record Class and Table
@@ -65,7 +71,19 @@ A table is a functional class that has methods that manipulate records in the da
 A sample [ComplexRecordTable class](https://github.com/android-promise/database/blob/master/dbapp/src/main/java/promise/dbapp/model/ComplexRecordTable.kt) will manipulate [ComplexRecord](https://github.com/android-promise/database/blob/master/dbapp/src/main/java/promise/dbapp/model/ComplexRecord.kt) within the database.
 ```kotlin
 
-@Table(tableName = "name_of_complex_model_table")
+@Table(
+    tableName = "name_of_complex_model_table",
+    indexes = [
+      Table.Index(
+          columnName = "int"
+      ),
+      Table.Index(
+          columnName = "double",
+          unique = true
+      )
+    ]
+)
+
 class ComplexRecordTable(database: FastDatabase) : FastTable<ComplexRecord>(database) {
 
   override fun onUpgrade(database: SQLiteDatabase, v1: Int, v2: Int) {
@@ -158,8 +176,6 @@ If you want to utilize rxJava in your queries, extend from [ReactiveFastDatabase
 ```kotlin
 
 @Database(
-    name = "complex_db_name",
-    version = 1,
     tables = [
       ComplexRecordTable::class
     ]
@@ -183,7 +199,10 @@ object AppDatabase {
     result.response(true)
   }
 
-  val instance = createDatabase(AppDatabase::class.java)
+  // can also use in memory database, no name and no migrations
+  val inMemoryDatabase = createInMemoryDatabase(AppDatabase::class.java)
+
+  val instance = createDatabase(AppDatabase::class.java, "db_name")
 
   val complexModelTable: ComplexRecordTable by lazy {
     instance.obtain<ComplexRecordTable>(ComplexRecordTable::class.java)
@@ -194,8 +213,6 @@ object AppDatabase {
 The tables are registered in the database annotation
 ```kotlin
 @Database(
-    name = "complex_db_name",
-    version = 1,
     tables = [
       ComplexRecordTable::class
     ]
@@ -255,7 +272,7 @@ We'll upgrade our database to version 2 and add the table in our database as thi
 ##### AppDatabase
 ```kotlin
 ...
-val instance = createDatabase(AppDatabase::class.java,
+val instance = createDatabase(AppDatabase::class.java, "db_name",
       object : Migration {
         override fun onMigrate(database: FastDatabase,
                                sqLiteDatabase: SQLiteDatabase,
@@ -273,7 +290,6 @@ Amd the update our new table in table registry so that new installs get the new
 ```kotlin
 ...
 @Database(
-    name = "complex_db_name",
     version = 2,
     tables = [
       ComplexRecordTable::class,
@@ -357,7 +373,7 @@ watch this repo to stay updated
 * Peter Vincent - <dev4vin@gmail.com>
 # Donations
 If you'd like to support this library development, you could buy me coffee here:
-* [![Become a Patreon]("https://c6.patreon.com/becomePatronButton.bundle.js")](https://www.patreon.com/bePatron?u=31165349)
+* [![Become a Patreon]("https://c6.patreon.com/becomePatronButton.bundle.js")](https://www.patreon.com/bePatron?u=31932751)
 
 Thank you very much in advance!
 

.idea/markdown-navigator-enh.xml

@@ -14,6 +14,7 @@
 apply plugin: 'com.android.application'
 apply plugin: 'kotlin-android'
 apply plugin: 'kotlin-android-extensions'
+
 android {
     compileSdkVersion 29
     buildToolsVersion "29.0.2"
@@ -46,7 +47,7 @@ android {
 
 dependencies {
     implementation project(path: ':promisedb')
-    implementation 'com.github.android-promise:commons:1.0'
+    implementation 'com.github.android-promise:commons:1.1-alpha03'
     implementation "com.android.support:recyclerview-v7:$supportLibVersion"
     implementation 'io.reactivex.rxjava2:rxjava:2.2.17'
     implementation 'io.reactivex.rxjava2:rxandroid:2.1.1'

.idea/markdown-navigator.xml

@@ -14,11 +14,11 @@
 package promise.dbapp
 
 import android.app.Application
-import promise.commons.Promise
+import promise.commons.AndroidPromise
 
 class App : Application() {
   override fun onCreate() {
     super.onCreate()
-    Promise.init(this)
+    AndroidPromise.init(this, BuildConfig.DEBUG)
   }
 }

README.md

@@ -16,13 +16,12 @@ package promise.dbapp
 import android.os.Bundle
 import androidx.appcompat.app.AppCompatActivity
 import com.google.android.material.snackbar.Snackbar
-import io.reactivex.android.schedulers.AndroidSchedulers
-import io.reactivex.schedulers.Schedulers
 import kotlinx.android.synthetic.main.activity_main.*
 import kotlinx.android.synthetic.main.content_main.*
-import promise.commons.model.Result
+import promise.commons.tx.PromiseResult
 import promise.dbapp.model.ComplexRecord
 import promise.dbapp.model.AppDatabase
+import promise.dbapp.model.NewRecord
 import promise.model.IdentifiableList
 
 class MainActivity : AppCompatActivity() {
@@ -41,24 +40,24 @@ class MainActivity : AppCompatActivity() {
   override fun onPostCreate(savedInstanceState: Bundle?) {
     super.onPostCreate(savedInstanceState)
 
-    AppDatabase.allComplexModels(Result<IdentifiableList<out ComplexRecord>, Throwable>()
-        .withCallBack {
+    AppDatabase.allComplexModels(PromiseResult<IdentifiableList<out ComplexRecord>, Throwable>()
+        .withCallback {
           if (it.isNotEmpty()) {
             complex_values_textview.text = it.toString()
           } else complex_values_textview.text = "empty list"
         }
-        .withErrorCallBack { complex_values_textview.text = it.message })
+        .withErrorCallback { complex_values_textview.text = it.message })
 
     clear_button.setOnClickListener {
       AppDatabase.instance.deleteAll()
       complex_values_textview.text = ""
     }
 
-    val complexRecordTable = AppDatabase.complexModelTable
-    var items = complexRecordTable.findAll()
+    val newRecordTable = AppDatabase.newRecordTable
+    var items = newRecordTable.findAll()
     if (items.isEmpty()) {
-      complexRecordTable.save(IdentifiableList(ComplexRecord.someModels()))
-      items = complexRecordTable.findAll()
+      newRecordTable.save(IdentifiableList(NewRecord.someModels()))
+      items = newRecordTable.findAll()
     }
     complex_values_textview.text = items.toString()
   }

dbapp/build.gradle

@@ -14,46 +14,40 @@
 package promise.dbapp.model
 
 import android.database.sqlite.SQLiteDatabase
-import io.reactivex.android.schedulers.AndroidSchedulers
-import io.reactivex.disposables.CompositeDisposable
-import io.reactivex.schedulers.Schedulers
-import promise.commons.Promise
-import promise.commons.data.log.LogUtil
-import promise.commons.model.Result
-import promise.db.FastDatabase
-import promise.db.Migration
+import promise.commons.tx.PromiseResult
 import promise.db.Database
+import promise.db.FastDatabase
 import promise.db.FastDatabase.Companion.createDatabase
+import promise.db.FastDatabase.Companion.createInMemoryDatabase
+import promise.db.Migration
 import promise.model.IdentifiableList
 
 @Database(
-    name = "complex_db_name",
-    version = 2,
     tables = [
       ComplexRecordTable::class,
       NewRecordTable::class
     ]
 )
 object AppDatabase {
 
-  fun allComplexModels(result: Result<IdentifiableList<out ComplexRecord>, Throwable>) {
+  fun allComplexModels(result: PromiseResult<IdentifiableList<out ComplexRecord>, Throwable>) {
     val items = complexModelTable.findAll()
-    if (items.isEmpty()) {
-      saveSomeComplexModels(Result<Boolean, Throwable>()
-          .withCallBack {
-            allComplexModels(result)
-          })
-      return
-    }
-    result.response(items)
-   }
+    if (items.isEmpty()) saveSomeComplexModels(PromiseResult<Boolean, Throwable>()
+        .withCallback {
+          allComplexModels(result)
+        })
+    else result.response(items)
+  }
 
-  private fun saveSomeComplexModels(result: Result<Boolean, Throwable>) {
+  private fun saveSomeComplexModels(result: PromiseResult<Boolean, Throwable>) {
     complexModelTable.save(IdentifiableList(ComplexRecord.someModels()))
     result.response(true)
   }
+  // can also use in memory database, no name and no migrations
+  val inMemoryDatabase = createInMemoryDatabase(AppDatabase::class.java)
 
   val instance = createDatabase(AppDatabase::class.java,
+      "db_name",
       object : Migration {
         override fun onMigrate(database: FastDatabase,
                                sqLiteDatabase: SQLiteDatabase,

dbapp/src/main/java/promise/dbapp/App.kt

@@ -22,7 +22,19 @@ import promise.db.FastDatabase
 import promise.db.FastTable
 import promise.db.Table
 
-@Table(tableName = "name_of_complex_model_table")
+@Table(
+    tableName = "name_of_complex_model_table",
+    indexes = [
+      Table.Index(
+          columnName = "int"
+      ),
+      Table.Index(
+          columnName = "double",
+          unique = true
+      )
+    ]
+)
+
 class ComplexRecordTable(database: FastDatabase) : FastTable<ComplexRecord>(database) {
 
   override fun onUpgrade(database: SQLiteDatabase, v1: Int, v2: Int) {

dbapp/src/main/java/promise/dbapp/MainActivity.kt

@@ -14,6 +14,7 @@
 package promise.dbapp.model
 
 import promise.commons.model.Identifiable
+import promise.commons.model.List
 
 // added when version of database is 1
 class NewRecord : Identifiable<Int> {
@@ -26,4 +27,15 @@ class NewRecord : Identifiable<Int> {
 
   var toDoName: String? = null
   var todoDesc: String? = null
+
+  companion object {
+
+    fun someModels(): List<NewRecord> = List.fromArray(NewRecord().apply {
+      toDoName = "toda name 1"
+      todoDesc = "desc 1"
+    }, NewRecord().apply {
+      toDoName = "toda name 2"
+      todoDesc = "desc 3"
+    })
+  }
 }