A simple library for saving data in the cache and reading them.

The library is hosted on jcenter. To use it, add the following to your module level build.gradle file's dependencies:

dependencies {
    implementation 'com.github.pcpl2:simplecache:1.2.0'
}

To init instance of cache manager without filename:

val cacheManager = CacheManager.createInstance(context = appContext)

The cacheManager instance usage default cache file.

To init instance of cache manager with filename:

val cacheManager = CacheManager.createInstance(context = appContext, fileName = "filesCache")

The cacheManager instance usage cache with file name filesCache.

To init instance of cache manager without autosave:

val cacheManager = CacheManager.createInstance(context = appContext, autoSave = false)

If you have deactivated the automatic saving, you must remember to save the data using the save method.

The set function accepts 3 parameters: key: Stirng, value: Any, lifetime: Long.

The lifetime parameter is the lifetime in seconds and is optional, default set as 0 (no lifetime).

To add or update element to cache instance with set lifetime:

cacheManager.set("HelloWorldKey", "Hello World", 60)
cacheManager.set("IntValueKey", 255, 30)
cacheManager.set("BooleanKey", false, 60)
cacheManager.set("FloatKey", 5.55, 60)

To add or update element to cache instance without set lifetime:

cacheManager.set("HelloWorldKey", "Hello World")
cacheManager.set("IntValueKey", 255)
cacheManager.set("BooleanKey", false)
cacheManager.set("FloatKey", 5.55)

To save cache on disk (if autosave disabled):

cacheManager.save()

The get function accepts 4 parameters: key: Stirng, checkExpired: Boolean = true, success: (value: Any, type: Class<*>) -> Unit, error: (() -> Unit)? = null.

The checkExpired parameter is optional, default set as true.

Callback success return value from map and value type.

Callback error is optional and run if element with key do not exist or lifetime of element is ended.

To get element from cache instance with lifetime check:

cacheManager.get(key = "HelloWorldKey", success = { value, type ->
    Log.d("simpleCacheLog", value.toString())
})

cacheManager.get(key = "IntValueKey", success = { value, type ->
    Log.d("simpleCacheLog", value.toString())
})

cacheManager.get(key = "BooleanKey", success = { value, type ->
   Log.d("simpleCacheLog", value.toString())
}, error = { 
    Log.d("simpleCacheLog", "BooleanKey is empty.")
})

cacheManager.get(key = "FloatKey", success = { value, type ->
    Log.d("simpleCacheLog", value.toString())
}, error = { 
    Log.d("simpleCacheLog", "FloatKey is empty.")
})

To get element from cache instance without lifetime check:

cacheManager.get(key = "HelloWorldKey", checkExpired = false, success = { value, type ->
    Log.d("simpleCacheLog", value.toString())
})

cacheManager.get(key = "IntValueKey", checkExpired = false, success = { value, type ->
    Log.d("simpleCacheLog", value.toString())
})

cacheManager.get(key = "BooleanKey", checkExpired = false, success = { value, type ->
   Log.d("simpleCacheLog", value.toString())
}, error = { 
    Log.d("simpleCacheLog", "BooleanKey is empty.")
})

cacheManager.get(key = "FloatKey", checkExpired = false, success = { value, type ->
    Log.d("simpleCacheLog", value.toString())
}, error = { 
    Log.d("simpleCacheLog", "FloatKey is empty.")
})

The remove function accept 1 parameter: key: Stirng.

To remove element from cache instance:

cacheManager.remove("FloatKey")

The removeAllElements function cleans the entire cache.

To clear cache istance:

cacheManager.removeAllElements()

To remove all elements in cache istance:

cacheManager.removeAllElements()

The dispose function accept 1 parameter: save: Boolean = true.

The save parameter is optional, default set as true.

The getListOfCacheFiles function accept 1 parameter: ctx: Context and return list of exist cache files.

To get cache files:

CacheManager.getListOfCacheFiles(appContext)

The createGlobalInstance function accept 4 parameters: context: Context, instanceName: String, fileName: String = "CacheBase", autoSave: Boolean = true and return cache instance.

To create global instance:

CacheManager.createGlobalInstance(context = appContext, instanceName = "Instance1", fileName = "instanceFile1")

The getGlobalInstance function accept 1 parameter: instanceName: String and return cache instance.

To get global instance by name:

val globalInstance2 = CacheManager.getGlobalInstance(instanceName = "Instance1")

To get list of global instance names:

var listOfIInstancesNames = CacheManager.getListOfGlobalInstanceNames()

The removeGlobalInstance function accept 2 parameters: instanceName: String, save: Boolean = true.

The save parameter is optional, default set as true.

To remove global instance by name:

CacheManager.removeGlobalInstance(instanceName = "Instance1")

To remove all global instances:

CacheManager.removeAllGlobalInstances()

Please see the Changelog page to see what's recently changed.

Copyright 2018 Patryk Ławicki

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.