Merge pull request #1416 from Raizlabs/develop

4.1.0

Author: agrosner

README.md

@@ -1,6 +1,6 @@
 ![Image](https://github.com/agrosner/DBFlow/blob/develop/dbflow_banner.png?raw=true)
 
-[![JitPack.io](https://img.shields.io/badge/JitPack.io-4.0.5-red.svg?style=flat)](https://jitpack.io/#Raizlabs/DBFlow) [![Android Weekly](http://img.shields.io/badge/Android%20Weekly-%23129-2CB3E5.svg?style=flat)](http://androidweekly.net/issues/issue-129) [![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-DBFlow-brightgreen.svg?style=flat)](https://android-arsenal.com/details/1/1134)
+[![JitPack.io](https://img.shields.io/badge/JitPack.io-4.1.0-red.svg?style=flat)](https://jitpack.io/#Raizlabs/DBFlow) [![Android Weekly](http://img.shields.io/badge/Android%20Weekly-%23129-2CB3E5.svg?style=flat)](http://androidweekly.net/issues/issue-129) [![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-DBFlow-brightgreen.svg?style=flat)](https://android-arsenal.com/details/1/1134)
 
 A robust, powerful, and very simple ORM android database library with **annotation processing**.
 
@@ -41,14 +41,18 @@ Add the library to the project-level build.gradle, using the apt plugin to enabl
 
 ```groovy
 
-  def dbflow_version = "4.0.5"
+  apply plugin: 'kotlin-kapt' // required for kotlin.
+
+  def dbflow_version = "4.1.0"
   // or dbflow_version = "develop-SNAPSHOT" for grabbing latest dependency in your project on the develop branch
   // or 10-digit short-hash of a specific commit. (Useful for bugs fixed in develop, but not in a release yet)
 
   dependencies {
+
+    // if Java use this. If using Kotlin do NOT use this.
     annotationProcessor "com.github.Raizlabs.DBFlow:dbflow-processor:${dbflow_version}"
 
-    // use kapt for kotlin apt if you're a Kotlin user
+    // Use if Kotlin user.
     kapt "com.github.Raizlabs.DBFlow:dbflow-processor:${dbflow_version}"
 
     compile "com.github.Raizlabs.DBFlow:dbflow-core:${dbflow_version}"
@@ -75,10 +79,6 @@ Add the library to the project-level build.gradle, using the apt plugin to enabl
 
   }
 
-// if you're building with Kotlin
-  kapt {
-    generateStubs = true
-  }
 ```
 
 # Pull Requests

build.gradle

@@ -1,19 +1,21 @@
 buildscript {
-    ext.kotlin_version = '1.1.3-2'
+    ext.kotlin_version = '1.1.4-2'
     repositories {
         jcenter()
+        google()
     }
     dependencies {
-        classpath 'com.android.tools.build:gradle:2.3.3'
+        classpath 'com.android.tools.build:gradle:3.0.0-beta2'
         classpath 'com.github.dcendents:android-maven-gradle-plugin:1.5'
-        classpath 'com.getkeepsafe.dexcount:dexcount-gradle-plugin:0.6.2'
+        classpath 'com.getkeepsafe.dexcount:dexcount-gradle-plugin:0.7.3'
         classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
     }
 }
 
 allprojects {
     repositories {
         jcenter()
+        google()
         maven { url "https://www.jitpack.io" }
     }
 }

dbflow-core/src/main/java/com/raizlabs/android/dbflow/annotation/ColumnMap.java

@@ -0,0 +1,22 @@
+package com.raizlabs.android.dbflow.annotation;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * Description: Maps an arbitrary object and its corresponding fields into a set of columns. It is similar
+ * to {@link ForeignKey} except it's not represented in the DB hierarchy.
+ */
+@Retention(RetentionPolicy.CLASS)
+@Target(ElementType.FIELD)
+public @interface ColumnMap {
+
+    /**
+     * Defines explicit references for a composite {@link ColumnMap} definition.
+     *
+     * @return override explicit usage of all fields and provide custom references.
+     */
+    ColumnMapReference[] references() default {};
+}

dbflow-core/src/main/java/com/raizlabs/android/dbflow/annotation/ColumnMapReference.java

@@ -0,0 +1,30 @@
+package com.raizlabs.android.dbflow.annotation;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * Description: Allows a {@link ColumnMap} to specify a reference override for its fields. Anything not
+ * defined here will not be used.
+ */
+@Retention(RetentionPolicy.CLASS)
+@Target(ElementType.FIELD)
+public @interface ColumnMapReference {
+
+    /**
+     * @return The local column name that will be referenced in the DB
+     */
+    String columnName();
+
+    /**
+     * @return The column name in the referenced table
+     */
+    String columnMapFieldName();
+
+    /**
+     * @return Specify the {@link NotNull} annotation here and it will get pasted into the reference definition.
+     */
+    NotNull notNull() default @NotNull(onNullConflict = ConflictAction.NONE);
+}

dbflow-core/src/main/java/com/raizlabs/android/dbflow/annotation/Database.java

@@ -26,15 +26,23 @@
     int version();
 
     /**
-     * @return The name of the DB. Optional as it will default to the class name.
+     * @deprecated use DatabaseConfig.databaseName() to change the name.
      */
+    @Deprecated
     String name() default "";
 
     /**
-     * @return Specify the extension of the file name : {fileName}.{extension}. Default is ".db"
+     * @deprecated use DatabaseConfig.extension() to change the extension.
      */
+    @Deprecated
     String databaseExtension() default "";
 
+    /**
+     * @deprecated use DatabaseConfig.inMemoryBuilder() instead.
+     */
+    @Deprecated
+    boolean inMemory() default false;
+
     /**
      * @return If true, SQLite will throw exceptions when {@link ForeignKey} constraints are not respected.
      * Default is false and will not throw exceptions.
@@ -52,11 +60,6 @@
      */
     boolean backupEnabled() default false;
 
-    /**
-     * @return true if you want it to be in-memory, false if not.
-     */
-    boolean inMemory() default false;
-
     /**
      * @return Global default insert conflict that can be applied to any table when it leaves
      * its {@link ConflictAction} as NONE.
@@ -72,6 +75,8 @@
     /**
      * @return Marks all generated classes within this database with this character. For example
      * "TestTable" becomes "TestTable$Table" for a "$" separator.
+     * @deprecated Generated class files will become '_' only in next major release.
      */
+    @Deprecated
     String generatedClassSeparator() default "_";
 }

dbflow-core/src/main/java/com/raizlabs/android/dbflow/annotation/ForeignKeyReference.java

@@ -24,4 +24,8 @@
      */
     String foreignKeyColumnName();
 
+    /**
+     * @return Specify the {@link NotNull} annotation here and it will get pasted into the reference definition.
+     */
+    NotNull notNull() default @NotNull(onNullConflict = ConflictAction.NONE);
 }

dbflow-core/src/main/java/com/raizlabs/android/dbflow/annotation/OneToMany.java

@@ -55,7 +55,9 @@ enum Method {
     /**
      * @return If true, the underlying variable that we use is private, requiring us to provide
      * a setter for it.
+     * @deprecated has no effect on the visibility of the call since we now autodetect visibility.
      */
+    @Deprecated
     boolean isVariablePrivate() default false;
 
     /**

dbflow-core/src/main/java/com/raizlabs/android/dbflow/annotation/Table.java

@@ -73,6 +73,12 @@
      */
     boolean assignDefaultValuesFromCursor() default true;
 
+    /**
+     * @return When false, this table gets generated and associated with database, however it will not immediately
+     * get created upon startup. This is useful for keeping around legacy tables for migrations.
+     */
+    boolean createWithDatabase() default true;
+
     /**
      * @return The cache size for this Table.
      */

dbflow-kotlinextensions/build.gradle

@@ -26,12 +26,9 @@ android {
 }
 
 dependencies {
-    compile fileTree(dir: 'libs', include: ['*.jar'])
-    testCompile 'junit:junit:4.12'
-    compile "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
-
-    compile project("${dbflow_project_prefix}dbflow-core")
-    compile project("${dbflow_project_prefix}dbflow")
+    api "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
+    api project("${dbflow_project_prefix}dbflow-core")
+    api project("${dbflow_project_prefix}dbflow")
 }
 
 apply from: '../kotlin-artifacts.gradle'

dbflow-kotlinextensions/src/main/java/com/raizlabs/android/dbflow/kotlinextensions/OneToManyExtensions.kt

@@ -0,0 +1,27 @@
+package com.raizlabs.android.dbflow.kotlinextensions
+
+import com.raizlabs.android.dbflow.sql.queriable.ModelQueriable
+import kotlin.properties.ReadWriteProperty
+import kotlin.reflect.KProperty
+
+
+fun <T : Any> oneToMany(query: () -> ModelQueriable<T>) = OneToMany(query)
+
+/**
+ * Description: Wraps a [OneToMany] annotation getter into a concise property setter.
+ */
+class OneToMany<T : Any>(private val query: () -> ModelQueriable<T>) : ReadWriteProperty<Any, List<T>?> {
+
+    private var list: List<T>? = null
+
+    override fun getValue(thisRef: Any, property: KProperty<*>): List<T>? {
+        if (list?.isEmpty() ?: true) {
+            list = query().list
+        }
+        return list
+    }
+
+    override fun setValue(thisRef: Any, property: KProperty<*>, value: List<T>?) {
+        list = value
+    }
+}