關於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: SPUtils是AndroidUtilCode庫的工具類,用於快速設定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的有所區別