3月底發(fā)布的OpenAtom OpenHarmony（以下簡稱“OpenHarmony”）3.1 Release版本中，新增了分布式數(shù)據(jù)對象特性。什么是分布式數(shù)據(jù)對象呢？本期就讓我們一起來了解一下~

一、背景介紹

OpenHarmony 作為分布式操作系統(tǒng)，支持運(yùn)行在不同的終端設(shè)備上。這些終端設(shè)備通過跨端遷移和多端協(xié)同等，可以為用戶提供豐富、流暢的全場景體驗。在這種分布式場景下，不同設(shè)備之間需要進(jìn)行數(shù)據(jù)互通來實(shí)現(xiàn)設(shè)備間的配合。

下面先看以下這個分布式場景的示例：

示例：可觸屏和TV的協(xié)作

在 TV/PAD 上觀看視頻時，在可觸屏設(shè)備上控制 TV/PAD 上的播放狀態(tài)、進(jìn)度、音量和速度等，實(shí)現(xiàn)多端控制。

圖1 多端控制，解放設(shè)備限制

要實(shí)現(xiàn)上面這個示例的功能，首先必須實(shí)現(xiàn)設(shè)備之間的數(shù)據(jù)同步。傳統(tǒng)方式下，設(shè)備之間的數(shù)據(jù)同步，需要開發(fā)者完成消息處理邏輯，包括：建立通信鏈接、消息收發(fā)處理、錯誤重試、數(shù)據(jù)沖突解決等操作，工作量非常大。而且設(shè)備越多，調(diào)試復(fù)雜度將呈指數(shù)增長。是否有更簡單的實(shí)現(xiàn)方式？經(jīng)過分析，我們發(fā)現(xiàn)，示例中的播放狀態(tài)、進(jìn)度、音量和速度等其實(shí)都是變量。如果這些變量支持“全局”訪問，那么開發(fā)者跨設(shè)備訪問這些變量就能像操作本地變量一樣，數(shù)據(jù)就能夠自動高效、便捷地實(shí)現(xiàn)多端同步了。

為此，本次 OpenHarmony v3.1 Release 版本新增了分布式數(shù)據(jù)對象特性。分布式數(shù)據(jù)對象為開發(fā)者在分布式應(yīng)用場景下提供簡單易用的 JS 接口，輕松實(shí)現(xiàn)多設(shè)備間同應(yīng)用的數(shù)據(jù)協(xié)同，同時設(shè)備間可以監(jiān)聽對象的狀態(tài)和數(shù)據(jù)變更。與傳統(tǒng)方式相比，分布式數(shù)據(jù)對象大大減少了開發(fā)者的工作量。

（為方便描述，后文中“分布式數(shù)據(jù)對象”也簡稱為“對象”。）

二、原理解析

這么簡單高效的分布式數(shù)據(jù)對象技術(shù)具體如何實(shí)現(xiàn)的呢？讓我們來一一解析~

1.對象的數(shù)據(jù)同步

分布式數(shù)據(jù)對象，最重要的功能就是對象之間的數(shù)據(jù)同步?？尚沤M網(wǎng)內(nèi)的設(shè)備可以在本地創(chuàng)建分布式數(shù)據(jù)對象，并設(shè)置 sessionID。不同設(shè)備上的分布式數(shù)據(jù)對象，通過設(shè)置相同的 sessionID，建立對象之間的同步關(guān)系。

如圖 3 所示，設(shè)備 A 和設(shè)備 B 上的“分布式數(shù)據(jù)對象1”，其 sessionID 均為 session1，這兩個對象建立了 session1 的同步關(guān)系。

圖2對象的同步關(guān)系

一個同步關(guān)系中，一個設(shè)備只能有一個對象加入。比如圖 3 中，設(shè)備 A 的“分布式數(shù)據(jù)對象 1”已經(jīng)加入了 session1 的同步關(guān)系，所以，設(shè)備 A 的“分布式數(shù)據(jù)對象 2”就加入失敗了。

建立同步關(guān)系后，每個 session 有一份共享對象數(shù)據(jù)。加入了同一個 session 的對象，支持以下操作：

（1）讀取/修改 session 中的數(shù)據(jù)。

（2）監(jiān)聽數(shù)據(jù)變更，感知其他對象對共享對象數(shù)據(jù)的修改。

（3）監(jiān)聽狀態(tài)變更，感知其他對象的加入和離開。

關(guān)于分布式數(shù)據(jù)對象的數(shù)據(jù)同步，值得注意的是，同步的最小單位是“屬性”。比如，圖 4 中對象 1 包含三個屬性：name、age 和 parents。當(dāng)其中一個屬性變更時，則數(shù)據(jù)同步時只需同步此變更的屬性。

圖3數(shù)據(jù)視圖

2.對象的生命周期

接下來，我們從生命周期的角度來全面認(rèn)識一下分布式數(shù)據(jù)對象。

圖4生命周期

如圖 5 所示，對象包括三種狀態(tài)：未初始化、本地對象和分布式對象。這三種狀態(tài)說明如下：

圖5對象的三種狀態(tài)

根據(jù)條件變化，對象在這三種狀態(tài)之間會來回切換：

最開始，對象處于未初始化狀態(tài)。實(shí)例化之后，對象就從未初始化狀態(tài)切換到本地對象狀態(tài)。給對象設(shè)置 sessionID，收到對端設(shè)備對象上線通知后，此時可以跨設(shè)備同步數(shù)據(jù)了，對象就進(jìn)入了分布式對象狀態(tài)。

本端或遠(yuǎn)端設(shè)備下線，或者 sessionID 被清除，那么對象又切回本地對象狀態(tài)。分布式對象實(shí)例和對應(yīng)的內(nèi)存數(shù)據(jù)庫都保存在應(yīng)用程序的進(jìn)程空間，當(dāng)應(yīng)用程序退出后，分布式對象和內(nèi)存數(shù)據(jù)庫也隨之銷毀，對象直接進(jìn)入未初始化狀態(tài)。

三、開發(fā)約束及案例

經(jīng)過上面的介紹，大家對分布式數(shù)據(jù)對象已經(jīng)有了充分的了解了，下面就要介紹開發(fā)者們最關(guān)心的“怎么用”的問題了。

在使用分布式數(shù)據(jù)對象之前，我們先說明一下相關(guān)的開發(fā)約束：

1. 單個應(yīng)用程序最多只能創(chuàng)建 16 個分布式數(shù)據(jù)對象實(shí)例。

2. 考慮到性能和用戶體驗，最多不超過 3 個設(shè)備進(jìn)行數(shù)據(jù)協(xié)同。

3. 考慮到性能和用戶體驗，分布式數(shù)據(jù)對象大小限制在 500KB 以內(nèi)。

4. 分布式數(shù)據(jù)對象的數(shù)據(jù)同步發(fā)生在同一個應(yīng)用程序下，且同 session ID 之間。

接下來，我們通過一個簡單的開發(fā)案例來講解如何使用分布式數(shù)據(jù)對象。此案例中，設(shè)備 A 和設(shè)備 B 分別創(chuàng)建一個包含 3 個屬性的對象，這兩個對象加入到同一個 session，建立同步關(guān)系。一個對象的屬性變更會自動同步到另一個對象，從而實(shí)現(xiàn)“全局變量”效果。

通過此案例，我們能夠掌握分布式數(shù)據(jù)對象的基本操作，包括：

1. 創(chuàng)建對象

2. 設(shè)置 sessionID

3. 設(shè)置監(jiān)聽對象變更的回調(diào)

4. 監(jiān)聽狀態(tài)變更

代碼示例如下：

1. 設(shè)備 A 的 JS 代碼示例：

import distributedObject from '@ohos.data.distributedDataObject'//創(chuàng)建對象，對象包含三個屬性：name、age和isVisvar g_object = distributedObject.createDistributedObject({name:"Amy", age:18, isVis:false});//設(shè)置sessionID為“123456”g_object.setSessionId("123456"); //設(shè)置監(jiān)聽對象變更的回調(diào)changeCallback : function (sessionId, changeData) { if (changeData != null && changeData != undefined) { changeData.forEach(element => { console.info("changed !" + element + " " + g_object[element]); }); }} g_object.on("change",this.changeCallback);

2. 設(shè)備 B 的 JS 代碼示例：

//創(chuàng)建對象，對象包含三個屬性：name、age和isVisvar g_object = distributedObject.createDistributedObject({name:"Amy", age:undefined, isVis:false});//設(shè)置sessionID為“123456”，這個session里已經(jīng)有設(shè)備A的對象g_object.setSessionId("123456"); //監(jiān)聽狀態(tài)變更statusCallback : function (sessionId, networkid, status) {//成功加入session并檢測到設(shè)備A上線if (status == "online" && networkid == networkid_A) {//此時設(shè)備A的age值是18，而本地age值是undefined，通過console.info自動同步設(shè)備A的age數(shù)據(jù)到本地。如果想使用本地數(shù)據(jù)，可以把a(bǔ)ge初始值改為有效值，像name一樣。 console.info ("age = {g_object.age}"); g_object.name = "jack"; //此時設(shè)備A的changeCallback收到對象變更的回調(diào)，打印出“changed !name jack”。//后續(xù)使用g_object.做的屬性修改都會自動同步給設(shè)備A，同時g_object.屬性訪問的數(shù)據(jù)都是session中的最新數(shù)據(jù)（也包括設(shè)備A上的修改）。設(shè)備A和B相當(dāng)于使用同一個全局變量g_object。 }}g_object.on("status",this.statusCallback);

本期，我們?yōu)榇蠹抑v解了分布式數(shù)據(jù)對象的產(chǎn)生背景、原理及開發(fā)案例。如果你想體驗更詳細(xì)的分布式數(shù)據(jù)對象，歡迎加入 OpenHarmony 開源項目，項目對應(yīng)分布式數(shù)據(jù)庫倉庫地址：

https://gitee.com/openharmony/distributeddatamgr_objectstore

后續(xù)倉庫還將陸續(xù)發(fā)出分布式數(shù)據(jù)對象的 sample 哦，敬請期待！

審核編輯 ：李倩