关于TornadoFx和Android的全局配置工具类封装实现及思路解析

原文地址: 关于TornadoFx和Android的全局配置工具类封装实现及思路解析 - Stars-One的杂货小窝

目前个人开发软件存在设置页面,可以让用户自定义些设置,但我发现,存储数据的代码逻辑实在是有些繁琐(保存及APP打开的设置初始化)

于是便是花了些精力研究了些,封装了个简单的工具类,可以快捷实现存储数据的保存及初始化

目标

首先,我们知道,设置的选项值需要存放在本地,之后重新进入APP的时候,需要先从本地读取,若是本地读取不到,才赋予一个默认值

所以,确认下我们要达到的理想目标:

对于设置的某项数据,可以使用一个字段进行对应,而不用关心存储保存本地的更新操作和APP初始化读取数值的

实现步骤

先提及下思路,我们将数值保存的本地方法,其实无非就是使用File对象创建个文件,之后将数据写入文件接口实现配置

在TornadoFx中,提供了config对象供我们快速使用,而无需编写过多的关于文件流的操作的代码

PS:TornadoFx中,除了config,还有个Preference对象,但Preference是写入注册表的,所以这里我们不采用这种方式,详情可以看上一篇TornadoFx设置保存功能(config和preference使用) - Stars-One的杂货小窝

而在Android中,也是存在有个SharePreference的对象,可以存储写简单的数据

TornadoFx和Android的方法大同小异,我们以Android的方法为例讲解,后面会附有相关的源码,复制即可使用

1.实现本地存储数值

这里,由于是Android,使用了SharePreference对象来存储,由于SharePreference的使用需要Context参数,为了方便封装,用了个开源库,封装好了可以直接使用

以一个开关设置项为例(boolean数值),写个简单的类:

class GlobalDataConfig(val key:String) {     var flag = false      fun setValue(newVal: Boolean) {         flag = newVal         updateLocalStorage(newVal)     }      /**      *更新本地存储      *      * @param newVal      */     private fun updateLocalStorage(newVal: Boolean) {         SPUtils.getInstance().put(key, newVal)     } } 

上面这样写,调用的时候,我们需要新建个类,然后设置去的初始值,之后更新统一走setValue()方法,里面已经包含了数据存储在本地的逻辑

PS: SPUtilsAndroidUtilCode库的工具类,用于快速设置SharePreference

如果按照上面的来的话,每个设置项都得新建个类,使用极其不优雅,我们接下来进行优化

2.任意数值(泛型)

首先,我们需要可以自定义任意类型的(虽然说是任意类型,其实最终还是得看SharePreference支持存储上面数据),一般我们用基本数据类型存储即可(存储对象的话就会十分麻烦)

那这个时候有个问题摆在眼前,我们如何获取用户传递的数值类型?

这个时候,泛型就派上用场了

我们可以这样写:

class GlobalDataConfig<T>(val key:String,var currentValue:T) {      fun setValue(newVal: T) {         currentValue = newVal         updateLocalStorage(currentValue)     }      /**      *更新本地存储      *      * @param newVal      */     private fun updateLocalStorage(value: T) {         //各种类型的存储         if (value is Boolean) {             SPUtils.getInstance().put(key, value)         }         if (value is Float) {             SPUtils.getInstance().put(key, value)         }         if (value is String) {             SPUtils.getInstance().put(key, value)         }         if (value is Int) {             SPUtils.getInstance().put(key, value)         }         if (value is Long) {             SPUtils.getInstance().put(key, value)         }     } } 

这样,我们就可以通过构造函数来生成不同对象.来代表不同的数值项了

3.初始值

到了这步,我们还可以想到,进入APP的时候,配置项要进行初始化,这个时候应该是先从本地存储读取,若是读取不同,则是设置默认值

最初的想法是,使用个函数,用作初始化的数值读取,同时加个变量用来存储默认值(之后可以重置为默认值)

class GlobalDataConfig<T>(     val key:String,     var currentValue:T,     var defaultValue:T,     val lbd:((GlobalDataConfig<T>)->Unit) ) {      init{         lbd.invoke(this)     }      fun setValue(newVal: T) {         currentValue = newVal         updateLocalStorage(currentValue)     }      /**      *更新本地存储      *      * @param newVal      */     private fun updateLocalStorage(value: T) {         if (value is Boolean) {             SPUtils.getInstance().put(key, value)         }         if (value is Float) {             SPUtils.getInstance().put(key, value)         }         if (value is String) {             SPUtils.getInstance().put(key, value)         }         if (value is Int) {             SPUtils.getInstance().put(key, value)         }         if (value is Long) {             SPUtils.getInstance().put(key, value)         }     } } 

使用:

GlobalDataConfig("mykey",false,false){     it.currentValue = SPUtils.getInstance().getBoolean(key, it.defalutValue) } 

这样使用一看,发现,我们连最初的currentValue都不用设置了

所以构造参数还能再精简下,让currentValue默认等于defaultValue(这样设置起始没有毛病,因为之后每次都是会走初始化的步骤,从本地存储中读取数据的)

class GlobalDataConfig(     val key: String,     val defaultValue: T,     var currentValue: T = defaultValue,     val initLbd: (GlobalDataConfig) -> Unit ) {     init{         lbd.invoke(this)     }          fun setValue(newVal: T) {         currentValue = newVal         updateLocalStorage(currentValue)     }          /**      *更新本地存储      *      * @param newVal      */     private fun updateLocalStorage(value: T) {         if (value is Boolean) {             SPUtils.getInstance().put(key, value)         }         if (value is Float) {             SPUtils.getInstance().put(key, value)         }         if (value is String) {             SPUtils.getInstance().put(key, value)         }         if (value is Int) {             SPUtils.getInstance().put(key, value)         }         if (value is Long) {             SPUtils.getInstance().put(key, value)         }     } }

然后用起来就变成了这样:

GlobalDataConfig("mykey",false){     it.currentValue = SPUtils.getInstance().getBoolean(key, it.defalutValue) } 

但是,看起来还是有些繁琐,中间初始化的过程能否再优化呢?

刚开始我是没有思路的,因为currentValue在类里面是T类型,而我们通过getBoolean等方法,获得的都是Boolean,String等类型,与T类型不对应,IDE里会提示我们语法不对

然后,突然灵光一闪,我们可以强转类型嘛,如将GlobalDataConfig<T>转为GlobalDataConfig<Boolean>

代码最终即可以改为下面的样子

class GlobalDataConfig<T>(     val key: String,     val defaultValue: T,     var currentValue: T = defaultValue ) {     init {         when{             defaultValue is Boolean -> {                 val item = this as GlobalDataConfig<Boolean>                 item.setValue(SPUtils.getInstance().getBoolean(key,defaultValue))             }             defaultValue is String -> {                 val item = this as GlobalDataConfig<String>                 item.setValue(SPUtils.getInstance().getString(key,defaultValue))             }             defaultValue is Int -> {                 val item = this as GlobalDataConfig<Int>                 item.setValue(SPUtils.getInstance().getInt(key,defaultValue))             }             defaultValue is Double -> {                //SPUtils里面的似乎没有提供获取Double方法...             }             else -> kotlin.error("不支持的数据类型!!目前只支持string,boolean,intdouble四种类型")         }     }      /**      * 重置当前值为默认值      */     fun resetValue() {         setValue(defaultValue)     }      /**      * 更改数值      */     fun setValue(value: T) {         //更新内存的         currentValue = value          //更新本地存储的数据         updateLocalStorage(value)     }      /**      * 更新本地存储      */     private fun updateLocalStorage(value: T) {         if (value is Boolean) {             SPUtils.getInstance().put(key, value)         }         if (value is Float) {             SPUtils.getInstance().put(key, value)         }         if (value is String) {             SPUtils.getInstance().put(key, value)         }         if (value is Int) {             SPUtils.getInstance().put(key, value)         }         if (value is Long) {             SPUtils.getInstance().put(key, value)         }     } } 

使用上也很方便:

val openAutoRead =GlobalDataConfig("mykey",true) 

使用

稍微补充下使用说明吧

1.新建全局配置类

这里为了方便管理,是建了个Constants常量池

class GlobalData {     companion object {         //是否为VIP(默认不是)         val userStatus = GlobalDataConfig(Constants.SP_USER_STATUS, false)     } } 

2.读取数值

在你需要用的地方,获取数值

val result = GlobalData.userStatus.currentValue 

2.更新数值

GlobalData.userStatus.setValue(true) 

3.重置数值

GlobalData.userStatus.resetValue() 

源码-Android工具类

PS:这里其实还可以做个扩展,比如说加个回调方法列表,每次setValue方法后,执行所有回调方法,实现类似监听数值变动

限于实际情况,我就没有扩展了(各位可以参考下TornadoFx中的GlobalDataConfig的实现)

class GlobalDataConfig<T>(     val key: String,     val defaultValue: T,     var currentValue: T = defaultValue ) {     init {         when{             defaultValue is Boolean -> {                 val item = this as GlobalDataConfig<Boolean>                 item.setValue(SPUtils.getInstance().getBoolean(key,defaultValue))             }             defaultValue is String -> {                 val item = this as GlobalDataConfig<String>                 item.setValue(SPUtils.getInstance().getString(key,defaultValue))             }             defaultValue is Int -> {                 val item = this as GlobalDataConfig<Int>                 item.setValue(SPUtils.getInstance().getInt(key,defaultValue))             }             defaultValue is Double -> {                //SPUtils里面的似乎没有提供获取Double方法...             }             else -> kotlin.error("不支持的数据类型!!目前只支持string,boolean,intdouble四种类型")         }     }      /**      * 重置当前值为默认值      */     fun resetValue() {         setValue(defaultValue)     }      /**      * 更改数值      */     fun setValue(value: T) {         //更新内存的         currentValue = value          //更新本地存储的数据         updateLocalStorage(value)     }      /**      * 更新本地存储      */     private fun updateLocalStorage(value: T) {         if (value is Boolean) {             SPUtils.getInstance().put(key, value)         }         if (value is Float) {             SPUtils.getInstance().put(key, value)         }         if (value is String) {             SPUtils.getInstance().put(key, value)         }         if (value is Int) {             SPUtils.getInstance().put(key, value)         }         if (value is Long) {             SPUtils.getInstance().put(key, value)         }     } } 

源码-TornadoFx工具类

TornadoFx这边源码稍微有点多,就不放出来了,详情可以去我的Github库common-controls查阅,里面也含有详细的使用说明(文档的第7节)

TornadoFx这边有些特殊,是结合了JavaFx中提供的可观察对象一起连用,使用上与Android的有所区别

发表评论

相关文章