用google原文介绍是:Jetpack DataStore 是一种数据存储解决方案,允许您使用协议缓冲区存储键值对或类型化对象。DataStore 使用 Kotlin 协程和流程以异步、一致的事务方式存储数据。
2.为什么使用DataStore,SharedPreferences的缺点
说起SharedPreferences,每个android开发人员都不会陌生的,以键值对的形式存储在本地,使用非常简单! 但是我们也会常常在项目中遇到的一些问题:
1.getXXX(),会方法可能会导致主线程阻塞,在主线程调用 get 方法,必须等待 SP 加载完毕,会导致主线程阻塞
2.SP 不能保证类型安全,可能会出现 ClassCastException 异常,因为使用相同的 key 进行操作的时候,putXXX 方法可以使用不同类型的数据覆盖掉相同的 key。
3.SP 加载的数据会一直留在内存中,通过 getSharedPreferences() 方法加载的数据,最后会将数据存储在静态的成员变量中。
4.apply() 方法是异步的,可能会发生 ANR,
apply() 方法是异步的,本身是不会有任何问题,但是当生命周期处于 handleStopService() 、 handlePauseActivity() 、 handleStopActivity() 的时候会一直等待 apply() 方法将数据保存成功,否则会一直等待,从而阻塞主线程造成 ANR
5.SP 不能用于跨进程通信
相比SharedPreferences,DataStore优点有以下几点
-
DataStore 是基于 Flow 实现的,所以保证了在主线程的安全性
-
以事务方式处理更新数据,事务有四大特性(原子性、一致性、 隔离性、持久性)
-
没有 apply() 和 commit() 等等数据持久的方法
-
自动完成 SharedPreferences 迁移到 DataStore,保证数据一致性,不会造成数据损坏
-
可以监听到操作成功或者失败结果
再来看看 Google 分析的 SharedPreferences 和 DataStore 的区别的一张图吧:
3.DataStore的使用
Jetpack DataStore 有两种实现方式:
(1)Proto DataStore:存储类的对象(typed objects ),通过 protocol buffers 将对象序列化存储在本地
(2)Preferences DataStore:以键值对的形式存储在本地和 SharedPreferences 类似
同时Preferences DataStore 只支持 Int , Long , Boolean , Float , String 键值对数据,适合存储简单、小型的数据,并且不支持局部更新,如果修改了其中一个值,整个文件内容将会被重新序列化,
在项目中使用 Preferences DataStore
1.需要添加 Preferences DataStore 依赖
// Preferences DataStore
implementation “androidx.datastore:datastore-preferences:1.0.0-alpha01”
- 构建 DataStore
private val PREFERENCE_NAME = “DataStore”
var dataStore: DataStore = createDataStore(
name = PREFERENCE_NAME
)
3.从Preferences中存或读取数据
suspend fun saveDataLong(key: Preferences.Key, value: Long) {
dataStore.edit { mutablePreferences ->
mutablePreferences[key] = value
}
}
fun getDataLong(key: Preferences.Key): Flow<Long?> =
dataStore.data.catch {
if (it is IOException) {
it.printStackTrace()
emit(emptyPreferences())
} else {
throw it
}
}.map {
it[key] ?: -1L
}
fun getDataLongSyn(key: Preferences.Key): Long {
var value = -1L
runBlocking {
dataStore.data.first {
value = it[key] ?: -1
true
}
}
return value
}
4.迁移 SP 数据到 DataStore
我们来看看createDataStore的构造方法
fun Context.createDataStore(
name: String,
corruptionHandler: ReplaceFileCorruptionHandler? = null,
migrations: List<DataMigration> = listOf(),
scope: CoroutineScope = CoroutineScope(Dispatchers.IO + SupervisorJob())
): DataStore =
PreferenceDataStoreFactory.create(
produceFile = {
File(this.filesDir, “datastore/$name.preferences_pb”)
},
corruptionHandler = corruptionHandler,
migrations = migrations,
scope = scope
)
分析下构造方法中的几个参数
-
name:这个没啥好说的,就是 DataStore 的名字
-
corruptionHandler:如果数据存储在尝试读取数据时遇到 CorruptionException,则调用corruptionHandler。当数据无法反序列化时,序列化程序将引发CorruptionException
-
migrations:这个参数就是用来迁移 SP 的
-
scope:这个参数协程的作用域
迁移 SharedPreferences 到 DataStore
(1)传入一个SharedPreferencesMigration对象
(2)当 DataStore 对象构建完了之后,需要执行一次读取或者写入操作,即可完成 SharedPreferences 迁移到 DataStore,当迁移成功之后,会自动删除 SharedPreferences 使用的文件
有一点需要注意的是:迁移成功后会删除sp对应的xml文件,应该立即停止使用sp.
dataStore = context.createDataStore(
name = preferenceName,
migrations = listOf(
SharedPreferencesMigration(
context,
“你存储 SP 的 Name”
)
)
)
4.关于异步存取值
先看个demo例子
fun saveData() {
GlobalScope.launch {
saveDataInt(ketInt, 4)
saveDataLong(keyLong, 5)
saveDataString(keyString, “charles”)
saveDataBoolean(keyBoolean, true)
}
}
fun getData() {
//异步
GlobalScope.launch {
getDataInt(ketInt).collect {
Log.e(“Charles”, “ketInt==$it”)
}
getDataBoolean(keyBoolean).collect {
Log.e(“Charles”, “keyBoolean==$it”)
最后
自我介绍一下,小编13年上海交大毕业,曾经在小公司待过,也去过华为、OPPO等大厂,18年进入阿里一直到现在。
深知大多数初中级Android工程师,想要提升技能,往往是自己摸索成长,自己不成体系的自学效果低效漫长且无助。
因此我收集整理了一份《2024年Android移动开发全套学习资料》,初衷也很简单,就是希望能够帮助到想自学提升又不知道该从何学起的朋友,同时减轻大家的负担。
既有适合小白学习的零基础资料,也有适合3年以上经验的小伙伴深入学习提升的进阶课程,基本涵盖了95%以上Android开发知识点!不论你是刚入门Android开发的新手,还是希望在技术上不断提升的资深开发者,这些资料都将为你打开新的学习之门
如果你觉得这些内容对你有帮助,需要这份全套学习资料的朋友可以戳我获取!!
由于文件比较大,这里只是将部分目录截图出来,每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频,并且会持续更新!
转存中…(img-pIIbhXna-1715674452191)]
既有适合小白学习的零基础资料,也有适合3年以上经验的小伙伴深入学习提升的进阶课程,基本涵盖了95%以上Android开发知识点!不论你是刚入门Android开发的新手,还是希望在技术上不断提升的资深开发者,这些资料都将为你打开新的学习之门
如果你觉得这些内容对你有帮助,需要这份全套学习资料的朋友可以戳我获取!!
由于文件比较大,这里只是将部分目录截图出来,每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频,并且会持续更新!