#星光计划2.0# OpenHarmony 源码解析之分布式数据库 原创 精华

├── BUILD.gn
├── figures
│   ├── en-us_image_0000001162536643.png
│   └── zh-cn_image_0000001162536643.png
├── frameworks
│   ├── innerkitsimpl
│   │   └── distributeddatafwk # 框架层实现
│   │       ├── include
│   │       ├── src
│   │       └── test
│   └── jskitsimpl
│       └── distributeddata    # JS接口实现
│           ├── include
│           └── src
├── interfaces
│   ├── innerkits                # 内部接口，主要是头文件
│   │   ├── app_distributeddata 
│   │   │   ├── BUILD.gn
│   │   │   └── include
│   │   └── distributeddata
│   │       ├── BUILD.gn
│   │       └── include
│   └── jskits                   # JS接口，BUILD用
│       └── distributeddata
│           └── BUILD.gn
├── LICENSE
├── OAT.xml
├── ohos.build
├── README.md
├── README_zh.md
├── services
│   └── distributeddataservice
│       ├── adapter              # 适配实现
│       │   ├── account          # 账号适配
│       │   ├── autils           # 实用库，包括任务、线程、目录等
│       │   ├── broadcaster      # 发送广播
│       │   ├── BUILD.gn
│       │   ├── communicator     # 通讯适配
│       │   ├── dfx              # 日志、统计、错误等相关处理
│       │   ├── include
│       │   ├── LICENSE
│       │   ├── permission        # 权限
│       │   ├── security          # 安全相关
│       │   ├── test
│       │   └── utils
│       ├── app                   # 用户程序实现
│       ├── libs
│       │   └── distributeddb
│       │       ├── BUILD.gn
│       │       ├── common
│       │       ├── communicator  # 设备间通讯
│       │       ├── include
│       │       ├── interfaces
│       │       ├── storage   # 存储实现，包括单版本KV、多版本KV、SQLITE3等
│       │       ├── syncer    # 同步
│       │       └── test
│       ├── sa_profile
│       └── test
└── test
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.
38.
39.
40.
41.
42.
43.
44.
45.
46.
47.
48.
49.
50.
51.
52.
53.
54.
55.
56.
57.
58.
59.

import distributedData from '@ohos.data.distributedData';
1.

distributedData.createKVManager
createKVManager(config: KVManagerConfig, callback: AsyncCallback<KVManager>): void
createKVManager(config: KVManagerConfig): Promise<KVManager>

1.
2.
3.
4.

let kvManager;
try {
    const kvManagerConfig = {
        bundleName : 'com.example.datamanagertest',
        userInfo : {
            userId : '0',
            userType : 0
        }
    }
    distributedData.createKVManager(kvManagerConfig).then((manager) => {
        console.log("createKVManager success");
        kvManager = manager;
    }).catch((err) => {
        console.log("createKVManager err: "  + JSON.stringify(err));
    });
} catch (e) {
    console.log("An unexpected error occurred. Error:" + e);
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.

kvManager.getKVStore
getKVStore<T extends KVStore>(storeId: string, options: Options): Promise<T>
1.
2.

let kvStore;
try {
    const options = {
        createIfMissing : true,
        encrypt : false,
        backup : false,
        autoSync : true, //手动同步、自动同步
        kvStoreType : 1, //当前只能使用0(默认)：表示多设备协同数据库，1：单版本数据库
        securityLevel : 3,
    };
    kvManager.getKVStore('storeId', options).then((store) => {
        console.log("getKVStore success");
        kvStore = store;
    }).catch((err) => {
        console.log("getKVStore err: "  + JSON.stringify(err));
    });
} catch (e) {
    console.log("An unexpected error occurred. Error:" + e);
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.

kvStore.put(key: string, value: Uint8Array | string | number | boolean): Promise<void>
kvStore.get(key: string): Promise<Uint8Array | string | boolean | number>
kvStore.delete(key: string): Promise<void>
kvStore.sync(deviceIdList: string[], mode: SyncMode, allowedDelayMs?: number): void
1.
2.
3.
4.

kvStore.on(event: 'dataChange', type: SubscribeType, observer: Callback<ChangeNotification>): void
kvStore.on(event: 'syncComplete', syncCallback: Callback<Array<[string, number]>>): void
1.
2.