【中工开发者】HarmonyOS数据存储--首选项存储、关系型数据存储
目次：首选项存储
关系型数据存储
数据存储是为了办理应用数据长期化题目，使得数据可以大概存储在外存中，到达保存或共享目标。
鸿蒙数据存储方式支持本地数据存储和分布式存储。
本地存储是把应用的数据存在本地，即应用所必要的数据存储在应用自己所在的设备上。
分布式存储是把应用的数据分布在多个设备上，应用可以在多个设备之间进行数据的共享和同步等。
本文章只讲解鸿蒙数据存储中的首选项存储、关系型数据存储两种数据存储。
一、首选项存储
概念及访问机制
首选项存储（Preferences）：提供了轻量级配置数据的长期化本领，并支持订阅数据变化的关照本领。仅支持本地存储，常用于保存应用配置信息、用户偏好设置等。
首选项数据存储也称为偏好数据存储或轻量级数据存储，得当于少量的数据存储，如：登录账户暗码、配置信息等。 首选项数据存储具有访问速率快，存取效率高的特点。 首选项数据存储数据最终是存储在操纵体系的文件中的，体系提供对底层文件读写的封装，并把底层文件映射成Preferences实例对象。
存储访问机制，每一个底层文件对应一个Preferences实例，应用可以借助Preferences提供的接口方法，进行读写数据。 首选项数据库存储的访问机制如图所示：
https://i-blog.csdnimg.cn/direct/9e91ae8332334c2fb7f16f064f8d1996.png
代码示例
下面部分代码示例展示了一个简单的首选项存储机制，允许用户自定义界面元素的样式，并将这些设置保存到本地存储中。
注明：DevEcoStudio版本
https://i-blog.csdnimg.cn/direct/6c032cb3c0cf4a5fa8f1a269b1c2a20a.pnghttps://i-blog.csdnimg.cn/direct/aaa3e8dedfa64e71864f108811c6bf34.png
这段代码是一个HarmonyOS应用中的首选项存储工具类PrefUtil，它利用@kit.ArkData模块中的preferences API来保存和读取应用的字体巨细和颜色设置
https://i-blog.csdnimg.cn/direct/cdab2699b95644b19026c519d7436c3b.pnghttps://i-blog.csdnimg.cn/direct/70d944bdbe3244a5b5a4e768483696b7.png
其存储数据可以在Device File Browser - data - preferences中检察
https://i-blog.csdnimg.cn/direct/07c739958be54b4f86c9227d90c97409.png
导入相应包
import { defaultColor } from'../pages/Index';
import { defaultSize } from '../pages/Index';
import { preferences as Pref } from '@kit.ArkData'; PreUtil.ets页面代码，该部分代码主要负责数据同步存储到本地。
const DB_NAME = 'myBb'; //存储名
const KEY_SIZE = 'keySize'; //键，存字体大小
const KEY_COLOR = 'keyColor'; //键，村字体颜色
class PrefUtil {
// 获得Preferecnes实例，这是与本地存储交互的接口
getFontPreferences(): Pref.Preferences {
let options: Pref.Options ={ name: DB_NAME };
//使用Pref.getPreferencesSync方法同步获取偏好设置
letpref:Pref.Preferences = Pref.getPreferencesSync( getContext(), options);
return pref;
}
// 保存样式，包括大小和颜色
saveFontStyle(fontSize: number, fontColor: string) {
const preferences: Pref.Preferences = this.getFontPreferences();
// 使用putSync方法同步写入数据，并调用flush方法确保数据被保存
preferences.putSync(KEY_SIZE, fontSize);
preferences.putSync(KEY_COLOR, fontColor);
preferences.flush();
}
// 异步获得字体大小
async getFontSize() {
//如果本地存储中没有值，则返回默认值defaultSize
let fontSize: number = defaultSize;
const preferences:Pref.Preferences =this.getFontPreferences();
fontSize = preferences.getSync(KEY_SIZE, fontSize) as number;
return fontSize;
}
// 异步获得字体颜色
async getFontColor() {
let fontColor: string = defaultColor;
const preferences:Pref.Preferences =this.getFontPreferences();
// 从数据库中获得颜色，如果无则使用默认值
fontColor =preferences.getSync(KEY_COLOR, fontColor) as string;
return fontColor;
}
}
export default new PrefUtil(); //导出对象 Index.ets页面代码，计划页面结构。
import PrefUtil from '../common/PrefUtil'
// 默认大小和颜色
export const defaultSize: number = 50
export const defaultColor: string = '0xFF0000'
@Entry
@Component
struct Index {
@State message: string = '首选项存储'
@State saveSize: number = defaultSize
@State saveColor: string = defaultColor
@State isSave: boolean = false
onPageShow() {
// 显示时加载已保存的值
PrefUtil.getFontSize().then((value) => {
this.saveSize = value
})
PrefUtil.getFontColor().then((value) => {
this.saveColor = value
})
}
build() {
Row() {
Column() {
Text(this.message)
.fontSize(40)
.fontWeight(FontWeight.Bold)
.margin(20)
Text('文本大小')
.fontSize(26)
TextInput({ text: '' + this.saveSize }).width('80%')
.onChange((v) => {
this.saveSize = Number(v)
this.isSave = false
})
Text('文本颜色')
.fontSize(26)
TextInput({ text: this.saveColor }).width('80%')
.onChange((v) => {
this.saveColor = v
this.isSave = false
})
Text(this.isSave ? '已保存数据' : '暂未保存').fontSize(20)
Button("保存")
.onClick(() => {
// 保存大小和颜色样式
PrefUtil.saveFontStyle(this.saveSize, this.saveColor)
this.isSave = true
}).width('60%').margin({ top: 10 })
Button("恢复默认值")
.onClick(() => {
this.saveSize = defaultSize
this.saveColor = defaultColor
this.isSave = false
}).width('60%').margin({ top: 10 })
Text('我是首选项存储文本')
.fontSize(this.saveSize)
.fontColor(Number(this.saveColor))
.margin({ top: 20 })
.textAlign(TextAlign.Center)
}
.width('100%')
}.alignItems(VerticalAlign.Top)
.height('100%')
}
} 二、关系型数据存储
概念及访问机制
关系型数据存储（RelationalStore）：提供了关系型数据库的增删改查、加密、备份以及订阅关照等，关系型数据库是以二维表的形式进行存储数据的。支持本地存储和分布式存储，通过请DatamgrService实现分布式跨设备数据同步。
关系型数据库（Relational Database，RDB）是基于关系模子组织管理数据的数据库。关系型数据库中一样平常包含若干个二维的数据表，每个表中以行和列的形式存储数据。 鸿蒙关系型数据存储底层利用SQLite作为长期化存储引擎，支持SQLite的全部数据库特性，包括事务、索引、视图、触发器、外键、参数化查询和预编译SQL语句等。
鸿蒙关系型数据存储框架实现了对底层SQLite数据进一步封装，对上层提供通用、美满且高效操纵接口，包括一系列的增、删、改、查等。访问机制如图所示：
https://i-blog.csdnimg.cn/direct/f5c42f246cab4fe892af10a5b058da62.png
代码示例
由于代码篇幅较大，下面附上代码所在。
源代码所在：https://github.com/Sandyroys/RDBDemo.git
https://i-blog.csdnimg.cn/direct/b98d2ebc364041e28fea2a2e7b4d93da.pnghttps://i-blog.csdnimg.cn/direct/a5c7d072ee43448ca7f6db19c285f163.pnghttps://i-blog.csdnimg.cn/direct/9a00499d8d324494b352b11c4ee278f7.png
部分：关键代码
class UserAPI {
//UserAPI 类初始化时，设置表名、列名、创建表的SQL语句，并创建 Rdb 实例来管理数据库连接。
private tableName: string = ''
private columns: Array<string> = []
private rdb: Rdb | null = null
private sql_create_table = ''
constructor( ) {
this.tableName = 'user'
this.columns = ['id', 'name', 'sex', 'age', 'tel']
this.sql_create_table = 'CREATE TABLE IF NOT EXISTS '
+ this.tableName + '('
+ 'id INTEGER PRIMARY KEY AUTOINCREMENT, '
+ 'name TEXT NOT NULL, '
+ 'sex TEXT, '
+ 'age INTEGER, '
+ 'tel TEXT)';
this.rdb = new Rdb(this.sql_create_table)
this.rdb.getRdbStore()
}
// 插入数据
insertUser(user:User) {
const valueBucket:relationalStore.ValuesBucket = JSON.parse(JSON.stringify(user));
if(this.rdb?.rdbStore!=null)
{
this.rdb.rdbStore.insert(this.tableName, valueBucket, (err, ret) => {
console.log('insert done: ' + ret);
promptAction.showToast({ message: '添加用户成功！' });
});
}
}
// 根据用户名查询用户信息
async queryUserByName(name:string) {
let resultList:ArrayList<User> | null = null;
let predicates = new relationalStore.RdbPredicates(this.tableName);
predicates.equalTo('name', name);
let ret = await this.queryFromDB(predicates);
if( ret!=null )
{
resultList = this.getListFromResultSet(ret);
}
return resultList;
}
// 查询全部用户信息
async queryUserAll() {
let resultList:ArrayList<User> | null = null;
let predicates = new relationalStore.RdbPredicates(this.tableName);
let ret:relationalStore.ResultSet | null = await this.queryFromDB(predicates);
if( ret!=null )
{
resultList = this.getListFromResultSet(ret);
console.info("=====>"+resultList.convertToArray().toString());
}
return resultList;
}
// 根据条件查询数据库
async queryFromDB( predicates:relationalStore.RdbPredicates ) {
let resultList:relationalStore.ResultSet | null = null;
if( this.rdb?.rdbStore!=null )
{
let promiseQuery = this.rdb.rdbStore.query(predicates, this.columns);
await promiseQuery.then((resultSet) => {
resultList = resultSet;
}).catch((err:object) => {
console.log("query err" + JSON.stringify(err));
});
}
return resultList;
}
// 将查询到的结果封装用户列表
getListFromResultSet( resultSet:relationalStore.ResultSet ) {
let userList:ArrayList<User> = new ArrayList<User>();
for (let i = 0; i < resultSet.rowCount; i++) {
resultSet.goToNextRow();
let user = new User(
resultSet.getString(resultSet.getColumnIndex('name')),
resultSet.getString(resultSet.getColumnIndex('sex')),
resultSet.getLong(resultSet.getColumnIndex('age')),
resultSet.getString(resultSet.getColumnIndex('tel')),
resultSet.getLong(resultSet.getColumnIndex('id')) );
userList.add(user);
}
return userList;
}
// 删除全部数据
async deleteAll() {
let result:number = 0;
let predicates = new relationalStore.RdbPredicates(this.tableName);
if(this.rdb?.rdbStore!=null)
{
await this.rdb.rdbStore.delete(predicates).then((rows) => {
result = rows;
promptAction.showToast({ message: '删除数据，rows:' + rows });
});
}
return result
}
} 三、总结
在鸿蒙开发中，首选项存储和关系型数据存储是两种紧张的数据长期化办理方案。以下是对这两种存储方式的总结：
首选项存储（Preferences）
[*] 功能特点：
[*]首选项存储提供轻量级配置数据的长期化本领，适用于保存应用配置信息和用户偏好设置等。
[*]它支持订阅数据变化的关照本领，但不支持分布式同步。
[*]数据以文本形式保存在设备中，全量加载到内存中，因此访问速率快、效率高。
[*]得当存储少量简单数据，不得当存储大量数据。
[*] 利用场景：
[*]适用于存储小型配置项数据，例如应用的用户个性化设置（字体巨细、是否开启夜间模式等）。
[*]发起存储的数据不凌驾一万条，以避免在内存方面产生较大的开销。
[*] 技术限定：
[*]Key键为string范例，长度不凌驾80个字节；Value值若为string范例，利用UTF-8编码格式，长度不凌驾8192个字节。
关系型数据存储（RelationalStore）
[*] 功能特点：
[*]提供关系型数据库的读写、加密、手动备份以及订阅关照的本领。
[*]可以运行自定义的SQL语句来满意复杂业务场景的必要。
[*]适用于存储复杂的数据结构，如应用内部的关系型数据。
[*] 利用场景：
[*]广泛用于应用中的关系型数据的处置处罚，包括增、删、改、查等操纵。
[*]得当必要数据完备性和一致性保障的场景。
[*] 技术细节：
[*]基于SQLite组件，提供了一套完备的对本地数据库进行管理的机制。
[*]支持基本数据范例：number、string、二进制范例数据、boolean。发起一条数据不要凌驾2M，超出该巨细大概导致插入乐成但读取失败。
总结来说，首选项存储得当轻量级的数据长期化需求，而关系型数据存储则适用于必要复杂查询和数据完备性保障的场景。开发者可以根据应用的具体需求选择合适的存储方案。
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。
页:
[1]