分布式数据管理Changelog

cl.distributeddatamgr.1 ValuesBucket由系统接口变更为公共接口

变更影响

基于此前版本开发的应用，仅支持系统应用使用ValuesBucket。现接口类型中的系统接口标识取消，支持第三方开发者使用。

关键接口/组件变更

修改前的接口原型：

   /**
    * Indicates possible value types
    *
    * @syscap SystemCapability.DistributedDataManager.DataShare.Core
    * @systemapi
    * @StageModelOnly
    * @since 9
    */
   export type ValueType = number | string | boolean;

修改后的接口原型：

   /**
    * Indicates possible value types
    *
    * @syscap SystemCapability.DistributedDataManager.DataShare.Core
    * @StageModelOnly
    * @since 10
    */
   export type ValueType = number | string | boolean;

cl.distributeddatamgr.2 dataSharePredicates部分谓词由系统接口变更为公共接口

变更影响

基于此前版本开发的应用，仅支持系统应用使用dataSharePredicates。现命名空间dataSharePredicates、类dataSharePredicates及类内部分谓词接口类型中的系统接口标识取消，支持第三方开发者使用。

关键接口/组件变更

部分谓词接口的系统接口说明取消，涉及的接口有：

• equalTo(field: string, value: ValueType): DataSharePredicates

• and(): DataSharePredicates

• orderByAsc(field: string): DataSharePredicates

• orderByDesc(field: string): DataSharePredicates

• limit(total: number, offset: number): DataSharePredicates

• in(field: string, value: Array[/topic/body/section/ul/li/p/valuetype {""}) ): DataSharePredicates (valuetype]

cl.distributeddatamgr.3 DataShareExtensionAbility的context属性取消可选标识符

@ohos.application.DataShareExtensionAbility的context属性取消可选标识，同时起始版本从API version 9变更为API version 10。

变更影响

基于此前版本开发的应用，使用context需切换SDK至API version 10。

关键接口/组件变更

删除的API version 9的接口原型：

   /**
    * Indicates datashare extension ability context.
    *
    * @type ?{ ExtensionContext }
    * @syscap SystemCapability.DistributedDataManager.DataShare.Provider
    * @systemapi
    * @StageModelOnly
    * @since 9
    */
   context?: ExtensionContext;

新增的API version 10的接口原型：

   /**
    * Indicates datashare extension ability context.
    *
    * @type { ExtensionContext }
    * @syscap SystemCapability.DistributedDataManager.DataShare.Provider
    * @systemapi
    * @StageModelOnly
    * @since 10
    */
   context: ExtensionContext;

cl.distributeddatamgr.4 OH_Predicates结构体的函数指针成员变量返回值类型由OH_Predicates变更为OH_Predicates *

变更影响

该变更为不兼容变更，用户使用OH_Predicates结构体中的函数指针变量时，需要按照新类型进行使用。

关键接口/组件变更

修改前的OH_Predicates成员变量原型：

   OH_Predicates (*equalTo)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject);
   OH_Predicates (*notEqualTo)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject);
   OH_Predicates (*beginWrap)(OH_Predicates *predicates);
   OH_Predicates (*endWrap)(OH_Predicates *predicates);
   OH_Predicates (*orOperate)(OH_Predicates *predicates);
   OH_Predicates (*andOperate)(OH_Predicates *predicates);
   OH_Predicates (*isNull)(OH_Predicates *predicates, const char *field);
   OH_Predicates (*isNotNull)(OH_Predicates *predicates, const char *field);
   OH_Predicates (*like)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject);
   OH_Predicates (*between)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject);
   OH_Predicates (*notBetween)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject);
   OH_Predicates (*greaterThan)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject);
   OH_Predicates (*lessThan)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject);
   OH_Predicates (*greaterThanOrEqualTo)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject);
   OH_Predicates (*lessThanOrEqualTo)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject);
   OH_Predicates (*orderBy)(OH_Predicates *predicates, const char *field, OH_OrderType type);
   OH_Predicates (*distinct)(OH_Predicates *predicates);
   OH_Predicates (*limit)(OH_Predicates *predicates, unsigned int value);
   OH_Predicates (*offset)(OH_Predicates *predicates, unsigned int rowOffset);
   OH_Predicates (*groupBy)(OH_Predicates *predicates, char const *const *fields, int length);
   OH_Predicates (*in)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject);
   OH_Predicates (*notIn)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject);
   OH_Predicates (*clear)(OH_Predicates *predicates);

修改后的OH_Predicates成员变量原型：

  OH_Predicates *(*equalTo)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject);
  OH_Predicates *(*notEqualTo)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject);
  OH_Predicates *(*beginWrap)(OH_Predicates *predicates);
  OH_Predicates *(*endWrap)(OH_Predicates *predicates);
  OH_Predicates *(*orOperate)(OH_Predicates *predicates);
  OH_Predicates *(*andOperate)(OH_Predicates *predicates);
  OH_Predicates *(*isNull)(OH_Predicates *predicates, const char *field);
  OH_Predicates *(*isNotNull)(OH_Predicates *predicates, const char *field);
  OH_Predicates *(*like)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject);
  OH_Predicates *(*between)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject);
  OH_Predicates *(*notBetween)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject);
  OH_Predicates *(*greaterThan)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject);
  OH_Predicates *(*lessThan)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject);
  OH_Predicates *(*greaterThanOrEqualTo)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject);
  OH_Predicates *(*lessThanOrEqualTo)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject);
  OH_Predicates *(*orderBy)(OH_Predicates *predicates, const char *field, OH_OrderType type);
  OH_Predicates *(*distinct)(OH_Predicates *predicates);
  OH_Predicates *(*limit)(OH_Predicates *predicates, unsigned int value);
  OH_Predicates *(*offset)(OH_Predicates *predicates, unsigned int rowOffset);
  OH_Predicates *(*groupBy)(OH_Predicates *predicates, char const *const *fields, int length);
  OH_Predicates *(*in)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject);
  OH_Predicates *(*notIn)(OH_Predicates *predicates, const char *field, OH_VObject *valueObject);
  OH_Predicates *(*clear)(OH_Predicates *predicates);

适配指导

示例代码如下：

变更前代码示例：

predicates->beginWrap(predicates).equalTo(predicates, "data1", valueObject).orOperate(predicates);

变更后代码示例：

predicates->beginWrap(predicates)->equalTo(predicates, "data1", valueObject)->orOperate(predicates);

cl.distributeddatamgr.5 OH_Rdb_ErrCode结构体的错误码信息变更

变更影响

该变更主要为将 RDB_ERR_INVALID_ARGS， RDB_ERR_OK错误码更改为RDB_E_INVALID_ARGS和RDB_OK，并增加其他错误码。

关键接口/组件变更

修改前的OH_Rdb_ErrCode成员变量原型：

 RDB_ERR_INVALID_ARGS = -2,
 RDB_ERR = -1,
 RDB_ERR_OK = 0

修改后的OH_Predicates成员变量原型：

   RDB_ERR = -1,
   RDB_OK = 0,
   E_BASE = 14800000,
   RDB_E_NOT_SUPPORTED = 801,
   RDB_E_ERROR = E_BASE,
   RDB_E_INVALID_ARGS = (E_BASE + 1),
   RDB_E_CANNOT_UPDATE_READONLY = (E_BASE + 2),
   RDB_E_REMOVE_FILE = (E_BASE + 3),
   RDB_E_EMPTY_TABLE_NAME = (E_BASE + 5),
   RDB_E_EMPTY_VALUES_BUCKET = (E_BASE + 6),
   RDB_E_EXECUTE_IN_STEP_QUERY = (E_BASE + 7),
   RDB_E_INVALID_COLUMN_INDEX = (E_BASE + 8),
   RDB_E_INVALID_COLUMN_TYPE = (E_BASE + 9),
   RDB_E_EMPTY_FILE_NAME = (E_BASE + 10),
   RDB_E_INVALID_FILE_PATH = (E_BASE + 11),
   RDB_E_TRANSACTION_IN_EXECUTE = (E_BASE + 12),
   RDB_E_INVALID_STATEMENT = (E_BASE + 13),
   RDB_E_EXECUTE_WRITE_IN_READ_CONNECTION = (E_BASE + 14),
   RDB_E_BEGIN_TRANSACTION_IN_READ_CONNECTION = (E_BASE + 15),
   RDB_E_NO_TRANSACTION_IN_SESSION = (E_BASE + 16),
   RDB_E_MORE_STEP_QUERY_IN_ONE_SESSION = (E_BASE + 17),
   RDB_E_NO_ROW_IN_QUERY = (E_BASE + 18),
   RDB_E_INVALID_BIND_ARGS_COUNT = (E_BASE + 19),
   RDB_E_INVALID_OBJECT_TYPE = (E_BASE + 20),
   RDB_E_INVALID_CONFLICT_FLAG = (E_BASE + 21),
   RDB_E_HAVING_CLAUSE_NOT_IN_GROUP_BY = (E_BASE + 22),
   RDB_E_NOT_SUPPORTED_BY_STEP_RESULT_SET = (E_BASE + 23),
   RDB_E_STEP_RESULT_SET_CROSS_THREADS = (E_BASE + 24),
   RDB_E_STEP_RESULT_QUERY_NOT_EXECUTED = (E_BASE + 25),
   RDB_E_STEP_RESULT_IS_AFTER_LAST = (E_BASE + 26),
   RDB_E_STEP_RESULT_QUERY_EXCEEDED = (E_BASE + 27),
   RDB_E_STATEMENT_NOT_PREPARED = (E_BASE + 28),
   RDB_E_EXECUTE_RESULT_INCORRECT = (E_BASE + 29),
   RDB_E_STEP_RESULT_CLOSED = (E_BASE + 30),
   RDB_E_RELATIVE_PATH = (E_BASE + 31),
   RDB_E_EMPTY_NEW_ENCRYPT_KEY = (E_BASE + 32),
   RDB_E_CHANGE_UNENCRYPTED_TO_ENCRYPTED = (E_BASE + 33),
   RDB_E_CHANGE_ENCRYPT_KEY_IN_BUSY = (E_BASE + 34),
   RDB_E_STEP_STATEMENT_NOT_INIT = (E_BASE + 35),
   RDB_E_NOT_SUPPORTED_ATTACH_IN_WAL_MODE = (E_BASE + 36),
   RDB_E_CREATE_FOLDER_FAIL = (E_BASE + 37),
   RDB_E_SQLITE_SQL_BUILDER_NORMALIZE_FAIL = (E_BASE + 38),
   RDB_E_STORE_SESSION_NOT_GIVE_CONNECTION_TEMPORARILY = (E_BASE + 39),
   RDB_E_STORE_SESSION_NO_CURRENT_TRANSACTION = (E_BASE + 40),
   RDB_E_NOT_SUPPORT = (E_BASE + 41),
   RDB_E_INVALID_PARCEL = (E_BASE + 42),
   RDB_E_QUERY_IN_EXECUTE = (E_BASE + 43),
   RDB_E_SET_PERSIST_WAL = (E_BASE + 44),
   RDB_E_DB_NOT_EXIST = (E_BASE + 45),
   RDB_E_ARGS_READ_CON_OVERLOAD = (E_BASE + 46),
   RDB_E_WAL_SIZE_OVER_LIMIT = (E_BASE + 47),
   RDB_E_CON_OVER_LIMIT = (E_BASE + 48)

cl.distributeddatamgr.6 OH_Cursor结构体的函数指针成员变量int (close)(OH_Cursor cursor)变更为**int (*destroy)(OH_Cursor *cursor)

变更影响

该变更为不兼容变更，函数指针名称由close更改为destroy，入参及返回值均未更改。

关键接口/组件变更

修改前的OH_Cursor该成员变量原型：

int (*close)(OH_Cursor *cursor);

修改后的OH_Predicates成员变量原型：

int (*destroy)(OH_Cursor *cursor);

适配指导

示例代码如下：

变更前代码示例：

cursor->close(cursor);

变更后代码示例：

cursor->destroy(cursor);

cl.distributeddatamgr.7 OH_Predicates结构体的函数指针成员变量int (*destroyPredicates)(OH_Predicates *predicates)变更为 int (*destroy)(OH_Predicates *predicates)

变更影响

该变更为不兼容变更，函数指针名称由destroyPredicates更改为destroy，入参及返回值均未更改。

关键接口/组件变更

修改前的OH_Predicates该成员变量原型：

int (*destroyPredicates)(OH_Predicates *predicates);

修改后的OH_Predicates成员变量原型：

int (*destroy)(OH_Predicates *predicates);

适配指导

示例代码如下：

变更前代码示例：

predicates->destroyPredicates(predicates);

变更后代码示例：

predicates->destroy(predicates);

cl.distributeddatamgr.8 OH_VObject结构体的函数指针成员变量int (*destroyValueObject)(OH_VObject *valueObject)变更为 int (*destroy)(OH_VObject *valueObject)

变更影响

该变更为不兼容变更，函数指针名称由destroyValueObject更改为destroy，入参及返回值均未更改。

关键接口/组件变更

修改前的OH_VObject该成员变量原型：

int (*destroyValueObject)(OH_VObject *valueObject);

修改后的OH_Predicates成员变量原型：

int (*destroy)(OH_VObject *valueObject);

适配指导

示例代码如下：

变更前代码示例：

valueObject->destroyValueObject(valueObject);

变更后代码示例：

valueObject->destroy(valueObject);

cl.distributeddatamgr.9 OH_VBucket结构体的函数指针成员变量int (*destroyValuesBucket)(OH_VBucket *bucket)变更为 int (*destroy)(OH_VBucket *bucket)

变更影响

该变更为不兼容变更，函数指针名称由destroyValuesBucket更改为destroy，入参及返回值均未更改。

关键接口/组件变更

修改前的OH_VBucket该成员变量原型：

int (*destroyValuesBucket)(OH_VBucket *bucket);

修改后的OH_Predicates成员变量原型：

int (*destroy)(OH_VBucket *bucket);

适配指导

示例代码如下：

变更前代码示例：

valueBucket->destroyValuesBucket(valueBucket);

变更后代码示例：

 valueBucket->destroy(valueBucket);

cl.distributeddatamgr.10 OH_Rdb_Config结构体成员变量变更

变更影响

该变更为不兼容变更，将成员变量securityLevel的类型由enum OH_Rdb_SecurityLevel改为in；删除成员变量path；并新增成员变量selfSize、dataBaseDir、storeName、bundleName、moduleName。

关键接口/组件变更

修改前的OH_Rdb_Config：

typedef struct {
   const char *path;
   bool isEncrypt;
   enum OH_Rdb_SecurityLevel securityLevel;
} OH_Rdb_Config;

修改后的OH_Rdb_Config：

typedef struct {
   int selfSize;
   const char *dataBaseDir;
   const char *storeName;
   const char *bundleName;
   const char *moduleName;
   bool isEncrypt;
   int securityLevel;
} OH_Rdb_Config;

适配指导

用户在利用OH_Rdb_Config创建数据库时，需要传入包名以及模块名等信息。

cl.distributeddatamgr.11 OH_Rdb_DeleteStore接口入参constchar pat变更为*const OH_Rdb_Config *config

变更影响

该变更为不兼容变更，函数入参由const char *path变更为const OH_Rdb_Config *config。

关键接口/组件变更

修改前OH_Rdb_DeleteStore接口：

int OH_Rdb_DeleteStore(const char *path);

修改后OH_Rdb_DeleteStore接口：

int OH_Rdb_DeleteStore(const OH_Rdb_Config *config);

适配指导

示例代码如下：

变更前代码示例：

OH_Rdb_DeleteStore(“”)

变更后代码示例：

OH_Rdb_DeleteStore(config)