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