HarmonyOS开发篇—数据管理（分布式数据服务）_harony分布式数据(1)

2401_84851347

于 2024-05-10 06:38:05 发布

阅读量1k

点赞数 24

分类专栏：程序员文章标签：鸿蒙面试学习

本文链接：https://blog.csdn.net/2401_84851347/article/details/138644065

版权

程序员专栏收录该内容

110 篇文章 0 订阅

订阅专栏

深知大多数程序员，想要提升技能，往往是自己摸索成长，但自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，涵盖了95%以上鸿蒙开发知识点，真正体系化！

由于文件比较多，这里只是将部分目录截图出来，全套包含大厂面经、学习笔记、源码讲义、实战项目、大纲路线、讲解视频，并且后续会持续更新

需要这份系统化的资料的朋友，可以戳这里获取

**表1 **分布式数据服务关键API功能介绍

开发步骤

以单版本分布式数据库为例，说明开发步骤。

在config.json中添加permisssion权限。

// 添加在abilities同一目录层级
“reqPermissions”: [
{
“name”: “ohos.permission.DISTRIBUTED_DATASYNC”
}
]

应用启动时，需要弹出授权提示框，请求用户进行授权。

根据配置构造分布式数据库管理类实例。

根据应用上下文创建KvManagerConfig对象。
创建分布式数据库管理器实例。

以下为创建分布式数据库管理器的代码示例：

Context context = getApplicationContext();
…
KvManagerConfig config = new KvManagerConfig(context);
KvManager kvManager = KvManagerFactory.getInstance().createKvManager(config);

获取/创建单版本分布式数据库。

声明需要创建的单版本分布式数据库ID描述。
创建单版本分布式数据库，默认开启组网设备间自动同步功能，如果应用对性能比较敏感建议设置关闭自动同步功能setAutoSync(false)，主动调用sync接口同步。

以下为创建单版本分布式数据库的代码示例：

try {
Options options = new Options();
options.setCreateIfMissing(true).setEncrypt(false).setKvStoreType(KvStoreType.SINGLE_VERSION);
String storeId = “testApp”;
SingleKvStore singleKvStore = kvManager.getKvStore(options, storeId);
} catch (KvStoreException e) {
HiLog.warn(LABEL_LOG, “getKvStore:” + e.getKvStoreErrorCode());
}

说明

组网设备间同步数据的场景，建议在应用启动时打开分布式数据库，获取数据库的句柄。在该句柄（如上例中的singleKvStore）的生命周期内无需重复创建数据库，可直接使用句柄对数据库进行数据的插入等操作。

如果没有调用kvManager.closeKvStore()方法关闭句柄，则该句柄会一直存在直到程序结束。

订阅分布式数据变化。

客户端需要实现KvStoreObserver接口。
构造并注册KvStoreObserver实例。

以下为订阅单版本分布式数据库所有（本地及远端）数据变化通知的代码示例：

class KvStoreObserverClient implements KvStoreObserver {
@Override
public void onChange(ChangeNotification notification) {
List insertEntries = notification.getInsertEntries();
List updateEntries = notification.getUpdateEntries();
List deleteEntries = notification.getDeleteEntries();
}
}

KvStoreObserver kvStoreObserverClient = new KvStoreObserverClient();
singleKvStore.subscribe(SubscribeType.SUBSCRIBE_TYPE_ALL, kvStoreObserverClient);

将数据写入单版本分布式数据库。

构造需要写入单版本分布式数据库的Key(键)和Value(值)。
将键值数据写入单版本分布式数据库。

以下为将字符串类型键值数据写入单版本分布式数据库的代码示例：

try {
String key = “todayWeather”;
String value = “Sunny”;
singleKvStore.putString(key, value);
} catch (KvStoreException e) {
HiLog.warn(LABEL_LOG, “putString:” + e.getKvStoreErrorCode());
}

如果应用对性能比较敏感，建议使用批量写入接口putBatch。查询单版本分布式数据库数据。

构造需要从单版本分布式数据库快照中查询的Key(键)。
从单版本分布式数据库快照中获取数据，需要捕获KvStoreException。

以下为从单版本分布式数据库中查询字符串类型数据的代码示例：

try {
String key = “todayWeather”;
String value = singleKvStore.getString(key);
} catch (KvStoreException e) {
HiLog.warn(LABEL_LOG, “getString:” + e.getKvStoreErrorCode());
}

同步数据到其他设备。

获取已连接的设备列表。
选择同步方式进行数据同步。

以下为单版本分布式数据库进行数据同步的代码示例，其中同步方式为PUSH_ONLY：

List deviceInfoList = kvManager.getConnectedDevicesInfo(DeviceFilterStrategy.NO_FILTER);
List deviceIdList = new ArrayList<>();
for (DeviceInfo deviceInfo : deviceInfoList) {
deviceIdList.add(deviceInfo.getId());
}
singleKvStore.sync(deviceIdList, SyncMode.PUSH_ONLY);

关闭单版本分布式数据库。如果组网设备间不再需要同步数据并且本地也不再访问，就可以执行关闭数据库的操作。以下为关闭单版本分布式数据库的代码示例：

try {
kvManager.closeKvStore(singleKvStore);
} catch (KvStoreException e) {
HiLog.warn(LABEL_LOG, “closeKvStore:” + e.getKvStoreErrorCode());
}

删除单版本分布式数据库。以下为删除单版本分布式数据库的代码示例：

try {
kvManager.deleteKvStore(storeId);
} catch (KvStoreException e) {
HiLog.warn(LABEL_LOG, “deleteKvStore:” + e.getKvStoreErrorCode());
}

为了能让大家更好的学习鸿蒙 (OpenHarmony) 开发技术，这边特意整理了《鸿蒙 (OpenHarmony)开发学习手册》（共计890页），希望对大家有所帮助：https://qr21.cn/FV7h05