分布式数据管理子系统JS API变更
OpenHarmony 3.1 Release版本相较于OpenHarmony 3.0 LTS版本，分布式数据管理子系统的API变更如下:
接口变更
| 模块名 | 类名 | 方法/属性/枚举/常量 | 变更类型 |
|---|---|---|---|
| ohos.data.rdb | RdbPredicates | inAllDevices(): RdbPredicates; | 新增 |
| ohos.data.rdb | RdbPredicates | inDevices(devices: Array<string>): RdbPredicates; | 新增 |
| ohos.data.rdb | RdbStore | off(event:'dataChange', type: SubscribeType, observer: Callback<Array<string>>): void; | 新增 |
| ohos.data.rdb | RdbStore | on(event: 'dataChange', type: SubscribeType, observer: Callback<Array<string>>): void; | 新增 |
| ohos.data.rdb | RdbStore | sync(mode: SyncMode, predicates: RdbPredicates, callback: AsyncCallback<Array<[string, number]>>): void; sync(mode: SyncMode, predicates: RdbPredicates): Promise<Array<[string, number]>>; | 新增 |
| ohos.data.rdb | RdbStore | obtainDistributedTableName(device: string, table: string, callback: AsyncCallback<string>): void; obtainDistributedTableName(device: string, table: string): Promise<string>; | 新增 |
| ohos.data.rdb | RdbStore | setDistributedTables(tables: Array<string>, callback: AsyncCallback<void>): void; setDistributedTables(tables: Array<string>): Promise<void>; | 新增 |
| ohos.data.rdb | RdbStore | rollBack():void; | 新增 |
| ohos.data.rdb | RdbStore | commit():void; | 新增 |
| ohos.data.rdb | RdbStore | beginTransaction():void; | 新增 |
| ohos.data.rdb | RdbStore | querySql(sql: string, bindArgs: Array<ValueType>, callback: AsyncCallback<ResultSet>): void; querySql(sql: string, bindArgs?: Array<ValueType>): Promise<ResultSet>; | 新增 |
| ohos.data.rdb | SubscribeType | SUBSCRIBE_TYPE_REMOTE = 0 | 新增 |
| ohos.data.rdb | SyncMode | SYNC_MODE_PULL = 1 | 新增 |
| ohos.data.rdb | SyncMode | SYNC_MODE_PUSH = 0 | 新增 |
| ohos.data.distributedDataObject | DistributedObject | off(type: 'status', callback?: Callback<{ sessionId: string, deviceId: string, status: 'online' |'offline' }>): void; | 新增 |
| ohos.data.distributedDataObject | DistributedObject | on(type: 'status', callback: Callback<{ sessionId: string, networkId: string, status: 'online' |'offline' }>): void; | 新增 |
| ohos.data.distributedDataObject | DistributedObject | off(type: 'change', callback?: Callback<{ sessionId: string, fields: Array<string> }>): void; | 新增 |
| ohos.data.distributedDataObject | DistributedObject | on(type: 'change', callback: Callback<{ sessionId: string, fields: Array<string> }>): void; | 新增 |
| ohos.data.distributedDataObject | DistributedObject | setSessionId(sessionId?: string): boolean; | 新增 |
| ohos.data.distributedDataObject | distributedDataObject | genSessionId(): string; | 新增 |
| ohos.data.distributedDataObject | distributedDataObject | createDistributedObject(source: object): DistributedObject; | 新增 |
| ohos.data.distributedData | KVManager | off(event: 'distributedDataServiceDie', deathCallback?: Callback<void>): void; | 新增 |
| ohos.data.distributedData | KVManager | on(event: 'distributedDataServiceDie', deathCallback: Callback<void>): void; | 新增 |
| ohos.data.distributedData | KVManager | getAllKVStoreId(appId: string, callback: AsyncCallback<string[]>): void; getAllKVStoreId(appId: string): Promise<string[]>; | 新增 |
| ohos.data.distributedData | KVManager | deleteKVStore(appId: string, storeId: string, callback: AsyncCallback<void>): void; deleteKVStore(appId: string, storeId: string): Promise<void>; | 新增 |
| ohos.data.distributedData | KVManager | closeKVStore(appId: string, storeId: string, kvStore: KVStore, callback: AsyncCallback<void>): void; closeKVStore(appId: string, storeId: string, kvStore: KVStore): Promise<void>; | 新增 |
| ohos.data.distributedData | DeviceKVStore | off(event: 'syncComplete', syncCallback?: Callback<Array<[string, number]>>): void; | 新增 |
| ohos.data.distributedData | DeviceKVStore | on(event: 'syncComplete', syncCallback: Callback<Array<[string, number]>>): void; | 新增 |
| ohos.data.distributedData | DeviceKVStore | sync(deviceIdList: string[], mode: SyncMode, allowedDelayMs?: number): void; | 新增 |
| ohos.data.distributedData | DeviceKVStore | removeDeviceData(deviceId: string, callback: AsyncCallback<void>): void; removeDeviceData(deviceId: string): Promise<void>; | 新增 |
| ohos.data.distributedData | DeviceKVStore | getResultSize(query: Query, callback: AsyncCallback<number>): void; getResultSize(query: Query): Promise<number>; getResultSize(deviceId: string, query: Query, callback: AsyncCallback<number>): void; getResultSize(deviceId: string, query: Query): Promise<number>; | 新增 |
| ohos.data.distributedData | DeviceKVStore | closeResultSet(resultSet: KvStoreResultSet, callback: AsyncCallback<void>): void; closeResultSet(resultSet: KvStoreResultSet): Promise<void>; | 新增 |
| ohos.data.distributedData | DeviceKVStore | getResultSet(deviceId: string, keyPrefix: string, callback: AsyncCallback<KvStoreResultSet>): void; getResultSet(deviceId: string, keyPrefix: string): Promise<KvStoreResultSet>; getResultSet(query: Query, callback: AsyncCallback<KvStoreResultSet>): void; getResultSet(query: Query): Promise<KvStoreResultSet>; getResultSet(deviceId: string, query: Query, callback: AsyncCallback<KvStoreResultSet>): void; getResultSet(deviceId: string, query: Query): Promise<KvStoreResultSet>; | 新增 |
| ohos.data.distributedData | DeviceKVStore | getEntries(deviceId: string, keyPrefix: string, callback: AsyncCallback<Entry[]>): void; getEntries(deviceId: string, keyPrefix: string): Promise<Entry[]>; getEntries(query: Query, callback: AsyncCallback<Entry[]>): void; getEntries(query: Query): Promise<Entry[]>; getEntries(deviceId: string, query: Query, callback: AsyncCallback<Entry[]>): void; getEntries(deviceId: string, query: Query): Promise<Entry[]>; | 新增 |
| ohos.data.distributedData | DeviceKVStore | get(deviceId: string, key: string, callback: AsyncCallback<boolean|string|number|Uint8Array>): void; get(deviceId: string, key: string): Promise<boolean|string|number|Uint8Array>; | 新增 |
| ohos.data.distributedData | SingleKVStore | getSecurityLevel(callback: AsyncCallback<SecurityLevel>): void; getSecurityLevel(): Promise<SecurityLevel>; | 新增 |
| ohos.data.distributedData | SingleKVStore | setSyncParam(defaultAllowedDelayMs: number, callback: AsyncCallback<void>): void; setSyncParam(defaultAllowedDelayMs: number): Promise<void>; | 新增 |
| ohos.data.distributedData | SingleKVStore | off(event: 'syncComplete', syncCallback?: Callback<Array<[string, number]>>): void; | 新增 |
| ohos.data.distributedData | SingleKVStore | on(event: 'syncComplete', syncCallback: Callback<Array<[string, number]>>): void; | 新增 |
| ohos.data.distributedData | SingleKVStore | removeDeviceData(deviceId: string, callback: AsyncCallback<void>): void; removeDeviceData(deviceId: string): Promise<void>; | 新增 |
| ohos.data.distributedData | SingleKVStore | getResultSize(query: Query, callback: AsyncCallback<number>): void; getResultSize(query: Query): Promise<number>; | 新增 |
| ohos.data.distributedData | SingleKVStore | closeResultSet(resultSet: KvStoreResultSet, callback: AsyncCallback<void>): void; closeResultSet(resultSet: KvStoreResultSet): Promise<void>; | 新增 |
| ohos.data.distributedData | SingleKVStore | getResultSet(keyPrefix: string, callback: AsyncCallback<KvStoreResultSet>): void; getResultSet(keyPrefix: string): Promise<KvStoreResultSet>; getResultSet(query: Query, callback: AsyncCallback<KvStoreResultSet>): void; getResultSet(query: Query): Promise<KvStoreResultSet>; | 新增 |
| ohos.data.distributedData | SingleKVStore | getEntries(keyPrefix: string, callback: AsyncCallback<Entry[]>): void; getEntries(keyPrefix: string): Promise<Entry[]>; getEntries(query: Query, callback: AsyncCallback<Entry[]>): void; getEntries(query: Query): Promise<Entry[]>; | 新增 |
| ohos.data.distributedData | KVStore | setSyncRange(localLabels: string[], remoteSupportLabels: string[], callback: AsyncCallback<void>): void; setSyncRange(localLabels: string[], remoteSupportLabels: string[]): Promise<void>; | 新增 |
| ohos.data.distributedData | KVStore | enableSync(enabled: boolean, callback: AsyncCallback<void>): void; enableSync(enabled: boolean): Promise<void>; | 新增 |
| ohos.data.distributedData | KVStore | rollback(callback: AsyncCallback<void>): void; rollback(): Promise<void>; | 新增 |
| ohos.data.distributedData | KVStore | commit(callback: AsyncCallback<void>): void; commit(): Promise<void>; | 新增 |
| ohos.data.distributedData | KVStore | startTransaction(callback: AsyncCallback<void>): void; startTransaction(): Promise<void>; | 新增 |
| ohos.data.distributedData | KVStore | deleteBatch(keys: string[], callback: AsyncCallback<void>): void; deleteBatch(keys: string[]): Promise<void>; | 新增 |
| ohos.data.distributedData | KVStore | putBatch(entries: Entry[], callback: AsyncCallback<void>): void; putBatch(entries: Entry[]): Promise<void>; | 新增 |
| ohos.data.distributedData | KVStore | off(event:'dataChange', observer?: Callback<ChangeNotification>): void; | 新增 |
| ohos.data.distributedData | Query | getSqlLike():string; | 新增 |
| ohos.data.distributedData | Query | deviceId(deviceId:string):Query; | 新增 |
| ohos.data.distributedData | Query | setSuggestIndex(index: string): Query; | 新增 |
| ohos.data.distributedData | Query | prefixKey(prefix: string): Query; | 新增 |
| ohos.data.distributedData | Query | endGroup(): Query; | 新增 |
| ohos.data.distributedData | Query | beginGroup(): Query; | 新增 |
| ohos.data.distributedData | Query | isNotNull(field: string): Query; | 新增 |
| ohos.data.distributedData | Query | limit(total: number, offset: number): Query; | 新增 |
| ohos.data.distributedData | Query | orderByDesc(field: string): Query; | 新增 |
| ohos.data.distributedData | Query | orderByAsc(field: string): Query; | 新增 |
| ohos.data.distributedData | Query | or(): Query; | 新增 |
| ohos.data.distributedData | Query | and(): Query; | 新增 |
| ohos.data.distributedData | Query | unlike(field: string, value: string): Query; | 新增 |
| ohos.data.distributedData | Query | like(field: string, value: string): Query; | 新增 |
| ohos.data.distributedData | Query | notInString(field: string, valueList: string[]): Query; | 新增 |
| ohos.data.distributedData | Query | notInNumber(field: string, valueList: number[]): Query; | 新增 |
| ohos.data.distributedData | Query | inString(field: string, valueList: string[]): Query; | 新增 |
| ohos.data.distributedData | Query | inNumber(field: string, valueList: number[]): Query; | 新增 |
| ohos.data.distributedData | Query | isNull(field: string): Query; | 新增 |
| ohos.data.distributedData | Query | lessThanOrEqualTo(field: string, value: number|string): Query; | 新增 |
| ohos.data.distributedData | Query | greaterThanOrEqualTo(field: string, value: number|string): Query; | 新增 |
| ohos.data.distributedData | Query | lessThan(field: string, value: number|string): Query; | 新增 |
| ohos.data.distributedData | Query | greaterThan(field: string, value: number|string|boolean): Query; | 新增 |
| ohos.data.distributedData | Query | notEqualTo(field: string, value: number|string|boolean): Query; | 新增 |
| ohos.data.distributedData | Query | equalTo(field: string, value: number|string|boolean): Query; | 新增 |
| ohos.data.distributedData | Query | reset(): Query; | 新增 |
| ohos.data.distributedData | Query | constructor() | 新增 |
| ohos.data.distributedData | KvStoreResultSet | getEntry(): Entry; | 新增 |
| ohos.data.distributedData | KvStoreResultSet | isAfterLast(): boolean; | 新增 |
| ohos.data.distributedData | KvStoreResultSet | isBeforeFirst(): boolean; | 新增 |
| ohos.data.distributedData | KvStoreResultSet | isLast(): boolean; | 新增 |
| ohos.data.distributedData | KvStoreResultSet | isFirst(): boolean; | 新增 |
| ohos.data.distributedData | KvStoreResultSet | moveToPosition(position: number): boolean; | 新增 |
| ohos.data.distributedData | KvStoreResultSet | move(offset: number): boolean; | 新增 |
| ohos.data.distributedData | KvStoreResultSet | moveToPrevious(): boolean; | 新增 |
| ohos.data.distributedData | KvStoreResultSet | moveToNext(): boolean; | 新增 |
| ohos.data.distributedData | KvStoreResultSet | moveToLast(): boolean; | 新增 |
| ohos.data.distributedData | KvStoreResultSet | moveToFirst(): boolean; | 新增 |
| ohos.data.distributedData | KvStoreResultSet | getPosition(): number; | 新增 |
| ohos.data.distributedData | KvStoreResultSet | getCount(): number; | 新增 |
| ohos.data.distributedData | FieldNode | type: number; | 新增 |
| ohos.data.distributedData | FieldNode | nullable: boolean; | 新增 |
| ohos.data.distributedData | FieldNode | default: string; | 新增 |
| ohos.data.distributedData | FieldNode | appendChild(child: FieldNode): boolean; | 新增 |
| ohos.data.distributedData | FieldNode | constructor(name: string) | 新增 |
| ohos.data.distributedData | Schema | skip: number; | 新增 |
| ohos.data.distributedData | Schema | mode: number; | 新增 |
| ohos.data.distributedData | Schema | indexes: Array<string>; | 新增 |
| ohos.data.distributedData | Schema | root: FieldNode; | 新增 |
| ohos.data.distributedData | Schema | constructor() | 新增 |
| ohos.data.distributedData | Options | schema?: Schema; | 新增 |