DataCache

An adaptable cache that allows query-like operations.

classPerson(valid:Int, valage:Int, valname:String)
/** * Generates an object that tells caches how to handle this type. * Here we indicated that instances of MyType should be indexed on their `id` field.*/val description = description(Person::id) val cache =MapDataCache() //A `DataCache` that's backed by a ConcurrentMap. Every `DataCache` can support an arbitrary number of types.
cache.register(description) //Types need to be registered before a cache can use them, this provides an initial setup.
cache.put(Person(500, 24, "Test Dummy"))
val entry = cache.find<Person> { Person::id eq 500 }.single()
cache.find<Person>().update { it.copy(age = it.age +1) }
cache.find<Person>().remove() 

Cascading

DataCache supports cascading of entities linked by properties.

classUser(valid:Int, valname:String)
classMessage(valid:Int, valuserId:Int, valcontent:String)
val userDescription = description(User::id) {
link(User::id to Message::userId) //will remove messages with the same userId as the removed User's id.
}
val messageDescription = description(Message::id)
val cache =MapDataCache {
forType<Message> { lruHashMap(100) } //only keep the latest 100 messages
}
cache.register(userDescription, messageDescription)
cache.put(User(500, "Test Dummy"))
cache.put(Message(400, 500, "Hello world"))
cache.find<User> { User::id eq 500 }.remove()
val messages = cache.find<Message>().count()
assert(messages ==0)

Annotation processor

DataDescriptions can be automatically generated with the annotation-processor module.

//creates `userDescription` and `messageDescription`classUser(
@Identity
@Link(Message::class, "userId")
valid:Int, valname:String
)
classMessage(
@Identity
valid:Int, valuserId:Int, valcontent:String
)

Note that there is currently an issue with kapt relating to repeatable annotations. Because of that entities with multiple @Link annotations on the same property will not generate those links.