Additional Kotlin extensions

[greenrobot-team]

ObjectBox already provides some minimal Kotlin extensions:

// Regular
val box: Box<DataClassEntity> = store.boxFor(DataClassEntity::class.java)

// With extension
val box: Box<DataClassEntity> = store.boxFor()

// Regular
val query = box.query().`in`(property, array).build()

// With extension
val query = box.query().inValues(property, array).build()

This issue is to track what other Kotlin extensions may be added.

Some ground rules:

• should leverage features unique to Kotlin
• should not just be a shorter version of an existing method
• should not optimize fur just a single use case

Things to look out for:

• default args for methods
• builder pattern
• making util methods discoverable from the type they operate on
• destructuring

-ut

[greenrobot-team]

My suggestions:

• shipped with 2.0.0 beta Box query builder:

// Regular
val query = box.query().run {
    equal(property, value)
    order(property)
    build()
}

// With extension
val query = box.query {
    equal(property, value)
    order(property)
}

• shipped with 2.0.0 beta ToMany applyChangesToDb

// Regular
toMany.apply { 
    reset()
    add(entity)
    removeById(id)
    applyChangesToDb()
}

// With extension
toMany.applyChangesToDb(resetFirst = true) { // default is false
    add(entity)
    removeById(id)
}

• Discover ObjectBoxLiveData from Query autocomplete (note: this only works with objectbox-android, so add objectbox-android-ktx? ~~Or compileOnly objectbox-android?~~)

// Regular
val liveData = ObjectBoxLiveData(query)

// With extension
val liveData = query.toLiveData()

-ut

[greenrobot-team]

The first two suggestions are released as part of 2.0.0-beta. Also added docs for the existing extensions. -ut

[greenrobot-team]

An upcoming release will add extensions that are shortcuts for query methods that accept Long and Double. However, the shortcuts can be used with Int, Short and Float without having to call .toLong() or .toDouble():

// Regular
queryBuilder.equal(Model_.type, typeId.toLong())

// With extension
queryBuilder.equal(Model_.type, typeId)

-ut

[irvine752]

Could we also get "notIn" added for String Arrays or something the equivalent of not inValues for the Strings?

[greenrobot-team]

@irvine752 This issue is about Kotlin extension functions, not query conditions. Anyhow, not-in is not supported for String properties. Please thumbs up #941!

[HosseinKurd]

What about :

val query = box.query().notIn(User_.phone, stringListPhoneNumbers)

notIn usage Error:

None of the following functions can be called with the arguments supplied.

• notIn(Property<User!>!, IntArray!) defined in io.objectbox.query.QueryBuilder

• notIn(Property<User!>!, LongArray!) defined in io.objectbox.query.QueryBuilder

[greenrobot-team]

@HosseinKurd The notIn (or notOneOf using the new query API) conditions are only supported for integers (Integer and Long)! For Strings only in/oneOf is possible.

[HosseinKurd]

@HosseinKurd The notIn (or notOneOf using the new query API) conditions are only supported for integers (Integer and Long)! For Strings only in/oneOf is possible.

So how can I Reverse in/oneOf? there is not any not() function

[greenrobot-team]

@HosseinKurd You can't. Put differently: notIn is not supported for String. You'll have to find another way, e.g. by changing your model or writing custom filter code.