1# 分布式数据管理子系统JS API变更 2 3OpenHarmony 3.1 Release版本相较于OpenHarmony 3.0 LTS版本，分布式数据管理子系统的API变更如下: 4 5## 接口变更 6 7| 模块名 | 类名 | 方法/属性/枚举/常量 | 变更类型 | 8|---|---|---|---| 9| ohos.data.rdb | RdbPredicates | inAllDevices(): RdbPredicates; | 新增 | 10| ohos.data.rdb | RdbPredicates | inDevices(devices: Array\<string>): RdbPredicates; | 新增 | 11| ohos.data.rdb | RdbStore | off(event:'dataChange', type: SubscribeType, observer: Callback\<Array\<string>>): void; | 新增 | 12| ohos.data.rdb | RdbStore | on(event: 'dataChange', type: SubscribeType, observer: Callback\<Array\<string>>): void; | 新增 | 13| ohos.data.rdb | RdbStore | sync(mode: SyncMode, predicates: RdbPredicates, callback: AsyncCallback\<Array\<[string, number]>>): void;<br>sync(mode: SyncMode, predicates: RdbPredicates): Promise\<Array\<[string, number]>>; | 新增 | 14| ohos.data.rdb | RdbStore | obtainDistributedTableName(device: string, table: string, callback: AsyncCallback\<string>): void;<br>obtainDistributedTableName(device: string, table: string): Promise\<string>; | 新增 | 15| ohos.data.rdb | RdbStore | setDistributedTables(tables: Array\<string>, callback: AsyncCallback\<void>): void;<br>setDistributedTables(tables: Array\<string>): Promise\<void>; | 新增 | 16| ohos.data.rdb | RdbStore | rollBack():void; | 新增 | 17| ohos.data.rdb | RdbStore | commit():void; | 新增 | 18| ohos.data.rdb | RdbStore | beginTransaction():void; | 新增 | 19| ohos.data.rdb | RdbStore | querySql(sql: string, bindArgs: Array\<ValueType>, callback: AsyncCallback\<ResultSet>): void;<br>querySql(sql: string, bindArgs?: Array\<ValueType>): Promise\<ResultSet>; | 新增 | 20| ohos.data.rdb | SubscribeType | SUBSCRIBE_TYPE_REMOTE = 0 | 新增 | 21| ohos.data.rdb | SyncMode | SYNC_MODE_PULL = 1 | 新增 | 22| ohos.data.rdb | SyncMode | SYNC_MODE_PUSH = 0 | 新增 | 23| ohos.data.distributedDataObject | DistributedObject | off(type: 'status', callback?: Callback\<{ sessionId: string, deviceId: string, status: 'online' \| 'offline' }>): void; | 新增 | 24| ohos.data.distributedDataObject | DistributedObject | on(type: 'status', callback: Callback\<{ sessionId: string, networkId: string, status: 'online' \| 'offline' }>): void; | 新增 | 25| ohos.data.distributedDataObject | DistributedObject | off(type: 'change', callback?: Callback\<{ sessionId: string, fields: Array\<string> }>): void; | 新增 | 26| ohos.data.distributedDataObject | DistributedObject | on(type: 'change', callback: Callback\<{ sessionId: string, fields: Array\<string> }>): void; | 新增 | 27| ohos.data.distributedDataObject | DistributedObject | setSessionId(sessionId?: string): boolean; | 新增 | 28| ohos.data.distributedDataObject | distributedDataObject | genSessionId(): string; | 新增 | 29| ohos.data.distributedDataObject | distributedDataObject | createDistributedObject(source: object): DistributedObject; | 新增 | 30| ohos.data.distributedData | KVManager | off(event: 'distributedDataServiceDie', deathCallback?: Callback\<void>): void; | 新增 | 31| ohos.data.distributedData | KVManager | on(event: 'distributedDataServiceDie', deathCallback: Callback\<void>): void; | 新增 | 32| ohos.data.distributedData | KVManager | getAllKVStoreId(appId: string, callback: AsyncCallback\<string[]>): void;<br>getAllKVStoreId(appId: string): Promise\<string[]>; | 新增 | 33| ohos.data.distributedData | KVManager | deleteKVStore(appId: string, storeId: string, callback: AsyncCallback\<void>): void;<br>deleteKVStore(appId: string, storeId: string): Promise\<void>; | 新增 | 34| ohos.data.distributedData | KVManager | closeKVStore(appId: string, storeId: string, kvStore: KVStore, callback: AsyncCallback\<void>): void;<br>closeKVStore(appId: string, storeId: string, kvStore: KVStore): Promise\<void>; | 新增 | 35| ohos.data.distributedData | DeviceKVStore | off(event: 'syncComplete', syncCallback?: Callback\<Array\<[string, number]>>): void; | 新增 | 36| ohos.data.distributedData | DeviceKVStore | on(event: 'syncComplete', syncCallback: Callback\<Array\<[string, number]>>): void; | 新增 | 37| ohos.data.distributedData | DeviceKVStore | sync(deviceIdList: string[], mode: SyncMode, allowedDelayMs?: number): void; | 新增 | 38| ohos.data.distributedData | DeviceKVStore | removeDeviceData(deviceId: string, callback: AsyncCallback\<void>): void;<br>removeDeviceData(deviceId: string): Promise\<void>; | 新增 | 39| ohos.data.distributedData | DeviceKVStore | getResultSize(query: Query, callback: AsyncCallback\<number>): void;<br>getResultSize(query: Query): Promise\<number>;<br>getResultSize(deviceId: string, query: Query, callback: AsyncCallback\<number>): void;<br>getResultSize(deviceId: string, query: Query): Promise\<number>; | 新增 | 40| ohos.data.distributedData | DeviceKVStore | closeResultSet(resultSet: KvStoreResultSet, callback: AsyncCallback\<void>): void;<br>closeResultSet(resultSet: KvStoreResultSet): Promise\<void>; | 新增 | 41| ohos.data.distributedData | DeviceKVStore | getResultSet(deviceId: string, keyPrefix: string, callback: AsyncCallback\<KvStoreResultSet>): void;<br>getResultSet(deviceId: string, keyPrefix: string): Promise\<KvStoreResultSet>;<br>getResultSet(query: Query, callback: AsyncCallback\<KvStoreResultSet>): void;<br>getResultSet(query: Query): Promise\<KvStoreResultSet>;<br>getResultSet(deviceId: string, query: Query, callback: AsyncCallback\<KvStoreResultSet>): void;<br>getResultSet(deviceId: string, query: Query): Promise\<KvStoreResultSet>; | 新增 | 42| ohos.data.distributedData | DeviceKVStore | getEntries(deviceId: string, keyPrefix: string, callback: AsyncCallback\<Entry[]>): void;<br>getEntries(deviceId: string, keyPrefix: string): Promise\<Entry[]>;<br>getEntries(query: Query, callback: AsyncCallback\<Entry[]>): void;<br>getEntries(query: Query): Promise\<Entry[]>;<br>getEntries(deviceId: string, query: Query, callback: AsyncCallback\<Entry[]>): void;<br>getEntries(deviceId: string, query: Query): Promise\<Entry[]>; | 新增 | 43| ohos.data.distributedData | DeviceKVStore | get(deviceId: string, key: string, callback: AsyncCallback\<boolean\|string\|number\|Uint8Array>): void;<br>get(deviceId: string, key: string): Promise\<boolean\|string\|number\|Uint8Array>; | 新增 | 44| ohos.data.distributedData | SingleKVStore | getSecurityLevel(callback: AsyncCallback\<SecurityLevel>): void;<br>getSecurityLevel(): Promise\<SecurityLevel>; | 新增 | 45| ohos.data.distributedData | SingleKVStore | setSyncParam(defaultAllowedDelayMs: number, callback: AsyncCallback\<void>): void;<br>setSyncParam(defaultAllowedDelayMs: number): Promise\<void>; | 新增 | 46| ohos.data.distributedData | SingleKVStore | off(event: 'syncComplete', syncCallback?: Callback\<Array\<[string, number]>>): void; | 新增 | 47| ohos.data.distributedData | SingleKVStore | on(event: 'syncComplete', syncCallback: Callback\<Array\<[string, number]>>): void; | 新增 | 48| ohos.data.distributedData | SingleKVStore | removeDeviceData(deviceId: string, callback: AsyncCallback\<void>): void;<br>removeDeviceData(deviceId: string): Promise\<void>; | 新增 | 49| ohos.data.distributedData | SingleKVStore | getResultSize(query: Query, callback: AsyncCallback\<number>): void;<br>getResultSize(query: Query): Promise\<number>; | 新增 | 50| ohos.data.distributedData | SingleKVStore | closeResultSet(resultSet: KvStoreResultSet, callback: AsyncCallback\<void>): void;<br>closeResultSet(resultSet: KvStoreResultSet): Promise\<void>; | 新增 | 51| ohos.data.distributedData | SingleKVStore | getResultSet(keyPrefix: string, callback: AsyncCallback\<KvStoreResultSet>): void;<br>getResultSet(keyPrefix: string): Promise\<KvStoreResultSet>;<br>getResultSet(query: Query, callback: AsyncCallback\<KvStoreResultSet>): void;<br>getResultSet(query: Query): Promise\<KvStoreResultSet>; | 新增 | 52| ohos.data.distributedData | SingleKVStore | getEntries(keyPrefix: string, callback: AsyncCallback\<Entry[]>): void;<br>getEntries(keyPrefix: string): Promise\<Entry[]>;<br>getEntries(query: Query, callback: AsyncCallback\<Entry[]>): void;<br>getEntries(query: Query): Promise\<Entry[]>; | 新增 | 53| ohos.data.distributedData | KVStore | setSyncRange(localLabels: string[], remoteSupportLabels: string[], callback: AsyncCallback\<void>): void;<br>setSyncRange(localLabels: string[], remoteSupportLabels: string[]): Promise\<void>; | 新增 | 54| ohos.data.distributedData | KVStore | enableSync(enabled: boolean, callback: AsyncCallback\<void>): void;<br>enableSync(enabled: boolean): Promise\<void>; | 新增 | 55| ohos.data.distributedData | KVStore | rollback(callback: AsyncCallback\<void>): void;<br>rollback(): Promise\<void>; | 新增 | 56| ohos.data.distributedData | KVStore | commit(callback: AsyncCallback\<void>): void;<br>commit(): Promise\<void>; | 新增 | 57| ohos.data.distributedData | KVStore | startTransaction(callback: AsyncCallback\<void>): void;<br>startTransaction(): Promise\<void>; | 新增 | 58| ohos.data.distributedData | KVStore | deleteBatch(keys: string[], callback: AsyncCallback\<void>): void;<br>deleteBatch(keys: string[]): Promise\<void>; | 新增 | 59| ohos.data.distributedData | KVStore | putBatch(entries: Entry[], callback: AsyncCallback\<void>): void;<br>putBatch(entries: Entry[]): Promise\<void>; | 新增 | 60| ohos.data.distributedData | KVStore | off(event:'dataChange', observer?: Callback\<ChangeNotification>): void; | 新增 | 61| ohos.data.distributedData | Query | getSqlLike():string; | 新增 | 62| ohos.data.distributedData | Query | deviceId(deviceId:string):Query; | 新增 | 63| ohos.data.distributedData | Query | setSuggestIndex(index: string): Query; | 新增 | 64| ohos.data.distributedData | Query | prefixKey(prefix: string): Query; | 新增 | 65| ohos.data.distributedData | Query | endGroup(): Query; | 新增 | 66| ohos.data.distributedData | Query | beginGroup(): Query; | 新增 | 67| ohos.data.distributedData | Query | isNotNull(field: string): Query; | 新增 | 68| ohos.data.distributedData | Query | limit(total: number, offset: number): Query; | 新增 | 69| ohos.data.distributedData | Query | orderByDesc(field: string): Query; | 新增 | 70| ohos.data.distributedData | Query | orderByAsc(field: string): Query; | 新增 | 71| ohos.data.distributedData | Query | or(): Query; | 新增 | 72| ohos.data.distributedData | Query | and(): Query; | 新增 | 73| ohos.data.distributedData | Query | unlike(field: string, value: string): Query; | 新增 | 74| ohos.data.distributedData | Query | like(field: string, value: string): Query; | 新增 | 75| ohos.data.distributedData | Query | notInString(field: string, valueList: string[]): Query; | 新增 | 76| ohos.data.distributedData | Query | notInNumber(field: string, valueList: number[]): Query; | 新增 | 77| ohos.data.distributedData | Query | inString(field: string, valueList: string[]): Query; | 新增 | 78| ohos.data.distributedData | Query | inNumber(field: string, valueList: number[]): Query; | 新增 | 79| ohos.data.distributedData | Query | isNull(field: string): Query; | 新增 | 80| ohos.data.distributedData | Query | lessThanOrEqualTo(field: string, value: number\|string): Query; | 新增 | 81| ohos.data.distributedData | Query | greaterThanOrEqualTo(field: string, value: number\|string): Query; | 新增 | 82| ohos.data.distributedData | Query | lessThan(field: string, value: number\|string): Query; | 新增 | 83| ohos.data.distributedData | Query | greaterThan(field: string, value: number\|string\|boolean): Query; | 新增 | 84| ohos.data.distributedData | Query | notEqualTo(field: string, value: number\|string\|boolean): Query; | 新增 | 85| ohos.data.distributedData | Query | equalTo(field: string, value: number\|string\|boolean): Query; | 新增 | 86| ohos.data.distributedData | Query | reset(): Query; | 新增 | 87| ohos.data.distributedData | Query | constructor() | 新增 | 88| ohos.data.distributedData | KvStoreResultSet | getEntry(): Entry; | 新增 | 89| ohos.data.distributedData | KvStoreResultSet | isAfterLast(): boolean; | 新增 | 90| ohos.data.distributedData | KvStoreResultSet | isBeforeFirst(): boolean; | 新增 | 91| ohos.data.distributedData | KvStoreResultSet | isLast(): boolean; | 新增 | 92| ohos.data.distributedData | KvStoreResultSet | isFirst(): boolean; | 新增 | 93| ohos.data.distributedData | KvStoreResultSet | moveToPosition(position: number): boolean; | 新增 | 94| ohos.data.distributedData | KvStoreResultSet | move(offset: number): boolean; | 新增 | 95| ohos.data.distributedData | KvStoreResultSet | moveToPrevious(): boolean; | 新增 | 96| ohos.data.distributedData | KvStoreResultSet | moveToNext(): boolean; | 新增 | 97| ohos.data.distributedData | KvStoreResultSet | moveToLast(): boolean; | 新增 | 98| ohos.data.distributedData | KvStoreResultSet | moveToFirst(): boolean; | 新增 | 99| ohos.data.distributedData | KvStoreResultSet | getPosition(): number; | 新增 | 100| ohos.data.distributedData | KvStoreResultSet | getCount(): number; | 新增 | 101| ohos.data.distributedData | FieldNode | type: number; | 新增 | 102| ohos.data.distributedData | FieldNode | nullable: boolean; | 新增 | 103| ohos.data.distributedData | FieldNode | default: string; | 新增 | 104| ohos.data.distributedData | FieldNode | appendChild(child: FieldNode): boolean; | 新增 | 105| ohos.data.distributedData | FieldNode | constructor(name: string) | 新增 | 106| ohos.data.distributedData | Schema | skip: number; | 新增 | 107| ohos.data.distributedData | Schema | mode: number; | 新增 | 108| ohos.data.distributedData | Schema | indexes: Array\<string>; | 新增 | 109| ohos.data.distributedData | Schema | root: FieldNode; | 新增 | 110| ohos.data.distributedData | Schema | constructor() | 新增 | 111| ohos.data.distributedData | Options | schema?: Schema; | 新增 | 112