毕设网站开发需要做什么,wordpress mysql 密码重置,史志网站建设方案,免费网站建设系统场景介绍
RelationalStore提供了一套完整的对本地数据库进行管理的机制#xff0c;对外提供了一系列的增、删、改、查等接口#xff0c;也可以直接运行用户输入的SQL语句来满足复杂的场景需要。
基本概念 谓词#xff1a;数据库中用来代表数据实体的性质、特征或者数据实体…场景介绍
RelationalStore提供了一套完整的对本地数据库进行管理的机制对外提供了一系列的增、删、改、查等接口也可以直接运行用户输入的SQL语句来满足复杂的场景需要。
基本概念 谓词数据库中用来代表数据实体的性质、特征或者数据实体之间关系的词项主要用来定义数据库的操作条件。 结果集指用户查询之后的结果集合可以对数据进行访问。结果集提供了灵活的数据访问方式可以更方便地拿到用户想要的数据。
约束限制 系统默认日志方式是WALWrite Ahead Log模式系统默认落盘方式是FULL模式。 数据库中连接池的最大数量是4个用以管理用户的读操作。 为保证数据的准确性数据库同一时间只能支持一个写操作。 当应用被卸载完成后设备上的相关数据库文件及临时文件会被自动清除。 使用API11新增的端云同步等接口时需要确保已实现云服务功能。
接口说明
接口名称描述OH_Rdb_GetOrOpen(const OH_Rdb_Config *config, int *errCode)获得一个相关的OH_Rdb_Store实例操作关系型数据库。OH_Rdb_Execute(OH_Rdb_Store *store, const char *sql)执行包含指定参数但不返回值的SQL语句。OH_Rdb_Insert(OH_Rdb_Store *store, const char *table, OH_VBucket *valuesBucket)向目标表中插入一行数据。OH_Rdb_Update(OH_Rdb_Store *store, OH_VBucket *valuesBucket, OH_Predicates *predicates)根据OH_Predicates的指定实例对象更新数据库中的数据。OH_Rdb_Delete(OH_Rdb_Store *store, OH_Predicates *predicates)根据OH_Predicates的指定实例对象从数据库中删除数据。OH_Rdb_Query(OH_Rdb_Store *store, OH_Predicates *predicates, const char *const *columnNames, int length)根据指定条件查询数据库中的数据。OH_Rdb_DeleteStore(const OH_Rdb_Config *config)删除数据库。OH_VBucket_PutAsset(OH_VBucket *bucket, const char *field, Rdb_Asset *value)把Rdb_Asset类型的数据放到指定的OH_VBucket对象中。OH_VBucket_PutAssets(OH_VBucket *bucket, const char *field, Rdb_Asset *value, uint32_t count)把Rdb_Asset数组类型的数据放到指定的OH_VBucket对象中。OH_Rdb_SetDistributedTables(OH_Rdb_Store *store, const char *tables[], uint32_t count, Rdb_DistributedType type, const Rdb_DistributedConfig *config)设置分布式数据库表。OH_Rdb_FindModifyTime(OH_Rdb_Store *store, const char *tableName, const char *columnName, OH_VObject *values)获取数据库指定表中指定列的数据的最后修改时间。OH_Rdb_CloudSync(OH_Rdb_Store *store, Rdb_SyncMode mode, const char *tables[], uint32_t count, const Rdb_ProgressObserver *observer)手动执行对指定表的端云同步使用该接口需要实现云服务功能。int OH_Data_Asset_SetName(Data_Asset *asset, const char *name)为资产类型数据设置名称。int OH_Data_Asset_SetUri(Data_Asset *asset, const char *uri)为资产类型数据设置绝对路径。int OH_Data_Asset_SetPath(Data_Asset *asset, const char *path)为资产类型数据设置应用沙箱里的相对路径。int OH_Data_Asset_SetCreateTime(Data_Asset *asset, int64_t createTime)为资产类型数据设置创建时间。int OH_Data_Asset_SetModifyTime(Data_Asset *asset, int64_t modifyTime)为资产类型数据设置最后修改时间。int OH_Data_Asset_SetSize(Data_Asset *asset, size_t size)为资产类型数据设置占用空间大小。int OH_Data_Asset_SetStatus(Data_Asset *asset, Data_AssetStatus status)为资产类型数据设置状态码。int OH_Data_Asset_GetName(Data_Asset *asset, char *name, size_t *length)获取资产类型数据的名称。int OH_Data_Asset_GetUri(Data_Asset *asset, char *uri, size_t *length)获取资产类型数据的绝对路径。int OH_Data_Asset_GetPath(Data_Asset *asset, char *path, size_t *length)获取资产类型数据在应用沙箱内的相对路径。int OH_Data_Asset_GetCreateTime(Data_Asset *asset, int64_t *createTime)获取资产类型数据的创建时间。int OH_Data_Asset_GetModifyTime(Data_Asset *asset, int64_t *modifyTime)获取资产类型数据的最后修改时间。int OH_Data_Asset_GetSize(Data_Asset *asset, size_t *size)获取资产类型数据的占用空间大小。int OH_Data_Asset_GetStatus(Data_Asset *asset, Data_AssetStatus *status)获取资产类型数据的状态码。Data_Asset *OH_Data_Asset_CreateOne()创造一个资产类型实例。使用完毕后需要调用OH_Data_Asset_DestroyOne释放内存。int OH_Data_Asset_DestroyOne(Data_Asset *asset)销毁一个资产类型实例并回收内存。Data_Asset **OH_Data_Asset_CreateMultiple(uint32_t count)创造指定数量的资产类型实例。使用完毕后需要调用OH_Data_Asset_DestroyMultiple释放内存。int OH_Data_Asset_DestroyMultiple(Data_Asset **assets, uint32_t count)销毁指定数量的资产类型实例并回收内存。int OH_Rdb_Subscribe(OH_Rdb_Store *store, Rdb_SubscribeType type, const Rdb_DataObserver *observer)为数据库注册观察者, 当分布式数据库中的数据发生更改时将调用回调。int OH_Rdb_Unsubscribe(OH_Rdb_Store *store, Rdb_SubscribeType type, const Rdb_DataObserver *observer)从数据库中删除指定类型的指定观察者。int OH_Rdb_SubscribeAutoSyncProgress(OH_Rdb_Store *store, const Rdb_ProgressObserver *observer)订阅RDB存储的自动同步进程, 当收到自动同步进度的通知时将调用回调。int OH_Rdb_UnsubscribeAutoSyncProgress(OH_Rdb_Store *store, const Rdb_ProgressObserver *observer)取消订阅RDB存储的自动同步进程。
开发步骤
添加动态链接库
CMakeLists.txt中添加以下lib。
libnative_rdb_ndk.z.so头文件
#include database/data/data_asset.h
#include database/rdb/oh_cursor.h
#include database/rdb/oh_predicates.h
#include database/rdb/oh_value_object.h
#include database/rdb/oh_values_bucket.h
#include database/rdb/relational_store.h
#include database/rdb/relational_store_error_code.h获取OH_Rdb_Store实例创建数据库文件。其中dataBaseDir变量为应用沙箱路径Stage模式下建议使用数据库目录参考 Context 的databaseDir属性。FA模式下由于没有接口获取数据库沙箱路径可使用应用程序的文件目录可参考 Context 的getFilesDir接口。area为数据库文件存放的安全区域详见 contextConstant 开发时需要实现由AreaMode枚举值对Rdb_SecurityArea枚举值的转换。示例代码如下所示 // 创建OH_Rdb_Config对象
OH_Rdb_Config config;
// 该路径为应用沙箱路径
config.dataBaseDir xxx;
// 数据库文件名
config.storeName RdbTest.db;
// 应用包名
config.bundleName xxx;
// 应用模块名
config.moduleName xxx;
// 数据库文件安全等级
config.securityLevel OH_Rdb_SecurityLevel::S1;
// 数据库是否加密
config.isEncrypt false;
// config所占内存大小
config.selfSize sizeof(OH_Rdb_Config);
// 数据库文件存放的安全区域
config.area RDB_SECURITY_AREA_EL1;int errCode 0;
// 获取获取OH_Rdb_Store实例
OH_Rdb_Store *store_ OH_Rdb_GetOrOpen(config, errCode);获取到OH_Rdb_Store后调用OH_Rdb_Execute接口创建表并调用OH_Rdb_Insert接口插入数据。示例代码如下所示 char createTableSql[] CREATE TABLE IF NOT EXISTS EMPLOYEE (ID INTEGER PRIMARY KEY AUTOINCREMENT, NAME TEXT NOT NULL, AGE INTEGER, SALARY REAL, CODES BLOB);
// 执行建表语句
OH_Rdb_Execute(store_, createTableSql);// 创建键值对实例
OH_VBucket *valueBucket OH_Rdb_CreateValuesBucket();
valueBucket-putText(valueBucket, NAME, Lisa);
valueBucket-putInt64(valueBucket, AGE, 18);
valueBucket-putReal(valueBucket, SALARY, 100.5);
uint8_t arr[] {1, 2, 3, 4, 5};
int len sizeof(arr) / sizeof(arr[0]);
valueBucket-putBlob(valueBucket, CODES, arr, len);
// 插入数据
int rowId OH_Rdb_Insert(store_, EMPLOYEE, valueBucket);
// 销毁键值对实例
valueBucket-destroy(valueBucket);说明 关系型数据库没有显式的flush操作实现持久化数据插入即保存在持久化文件。 根据谓词指定的实例对象对数据进行修改或删除。 调用OH_Rdb_Update方法修改数据调用OH_Rdb_Delete方法删除数据。示例代码如下所示 // 修改数据
OH_VBucket *valueBucket OH_Rdb_CreateValuesBucket();
valueBucket-putText(valueBucket, NAME, Rose);
valueBucket-putInt64(valueBucket, AGE, 22);
valueBucket-putReal(valueBucket, SALARY, 200.5);
uint8_t arr[] {1, 2, 3, 4, 5};
int len sizeof(arr) / sizeof(arr[0]);
valueBucket-putBlob(valueBucket, CODES, arr, len);OH_Predicates *predicates OH_Rdb_CreatePredicates(EMPLOYEE);
OH_VObject *valueObject OH_Rdb_CreateValueObject();
const char *name Lisa;
valueObject-putText(valueObject, name);
predicates-equalTo(predicates, NAME, valueObject)-andOperate(predicates);
uint32_t count 1;
double salary 100.5;
valueObject-putDouble(valueObject, salary, count);
predicates-equalTo(predicates, SALARY, valueObject);int changeRows OH_Rdb_Update(store_, valueBucket, predicates);
valueObject-destroy(valueObject);
valueBucket-destroy(valueBucket);
predicates-destroy(predicates);// 删除数据
OH_Predicates *predicates OH_Rdb_CreatePredicates(EMPLOYEE);
OH_VObject *valueObject OH_Rdb_CreateValueObject();
const char *name Lisa;
valueObject-putText(valueObject, name);
predicates-equalTo(predicates, NAME, valueObject);
int deleteRows OH_Rdb_Delete(store_, predicates);
valueObject-destroy(valueObject);
predicates-destroy(predicates);根据谓词指定的查询条件查找数据。 调用OH_Rdb_Query方法查找数据返回一个OH_Cursor结果集。示例代码如下所示 OH_Predicates *predicates OH_Rdb_CreatePredicates(EMPLOYEE);const char *columnNames[] {NAME, AGE};
int len sizeof(columnNames) / sizeof(columnNames[0]);
OH_Cursor *cursor OH_Rdb_Query(store_, predicates, columnNames, len);int columnCount 0;
cursor-getColumnCount(cursor, columnCount);// OH_Cursor是一个数据集合的游标默认指向第-1个记录有效的数据从0开始
int64_t age;
while (cursor-goToNextRow(cursor) OH_Rdb_ErrCode::RDB_OK) {cursor-getInt64(cursor, 1, age);
}// 释放谓词实例
predicates-destroy(predicates);
// 释放结果集
cursor-destroy(cursor);向数据库表中插入资产类型数据。 // 列的属性为单个资产类型时sql语句中应指定为asset多个资产类型应指定为assets。
char createAssetTableSql[] CREATE TABLE IF NOT EXISTS asset_table (id INTEGER PRIMARY KEY AUTOINCREMENT, data1 asset, data2 assets );;
errCode OH_Rdb_Execute(storeTestRdbStore_, createAssetTableSql);
Data_Asset *asset OH_Data_Asset_CreateOne();
OH_Data_Asset_SetName(asset, name0);
OH_Data_Asset_SetUri(asset, uri0);
OH_Data_Asset_SetPath(asset, path0);
OH_Data_Asset_SetCreateTime(asset, 1);
OH_Data_Asset_SetModifyTime(asset, 1);
OH_Data_Asset_SetSize(asset, 1);
OH_Data_Asset_SetStatus(asset, Data_AssetStatus::ASSET_NORMAL);
errCode OH_VBucket_PutAsset(valueBucket, data1, asset);Data_Asset **assets OH_Data_Asset_CreateMultiple(2);OH_Data_Asset_SetName(assets[0], name0);
OH_Data_Asset_SetUri(assets[0], uri0);
OH_Data_Asset_SetPath(assets[0], path0);
OH_Data_Asset_SetCreateTime(assets[0], 1);
OH_Data_Asset_SetModifyTime(assets[0], 1);
OH_Data_Asset_SetSize(assets[0], 1);
OH_Data_Asset_SetStatus(assets[0], Data_AssetStatus::ASSET_NORMAL);OH_Data_Asset_SetName(assets[1], name1);
OH_Data_Asset_SetUri(assets[1], uri1);
OH_Data_Asset_SetPath(assets[1], path1);
OH_Data_Asset_SetCreateTime(assets[1], 1);
OH_Data_Asset_SetModifyTime(assets[1], 1);
OH_Data_Asset_SetSize(assets[1], 1);
OH_Data_Asset_SetStatus(assets[1], Data_AssetStatus::ASSET_NORMAL);errCode OH_VBucket_PutAssets(valueBucket, data2, assets, assetsCount);
int rowID OH_Rdb_Insert(cursorTestRdbStore_, table, valueBucket);
// 释放Data_Asset*和Data_Asset**
OH_Data_Asset_DestroyMultiple(assets, 2);
OH_Data_Asset_DestroyOne(asset);从结果集中读取资产类型数据。 OH_Predicates *predicates OH_Rdb_CreatePredicates(asset_table);OH_Cursor *cursor OH_Rdb_Query(cursorTestRdbStore_, predicates, NULL, 0);
cursor-goToNextRow(cursor);uint32_t assetCount 0;
// assetCount作为出参获取该列资产类型数据的数量
errCode cursor-getAssets(cursor, 2, nullptr, assetCount);
Data_Asset **assets OH_Data_Asset_CreateMultiple(assetCount);
errCode cursor-getAssets(cursor, 2, assets, assetCount);
Data_Asset *asset assets[1];char name[10] ;
size_t nameLength 10;
errCode OH_Data_Asset_GetName(asset, name, nameLength);char uri[10] ;
size_t uriLength 10;
errCode OH_Data_Asset_GetUri(asset, uri, uriLength);char path[10] ;
size_t pathLength 10;
errCode OH_Data_Asset_GetPath(asset, path, pathLength);int64_t createTime 0;
errCode OH_Data_Asset_GetCreateTime(asset, createTime);int64_t modifyTime 0;
errCode OH_Data_Asset_GetModifyTime(asset, modifyTime);size_t size 0;
errCode OH_Data_Asset_GetSize(asset, size);Data_AssetStatus status Data_AssetStatus::ASSET_NULL;
errCode OH_Data_Asset_GetStatus(asset, status);predicates-destroy(predicates);
OH_Data_Asset_DestroyMultiple(assets, assetCount);
cursor-destroy(cursor);查询数据的最后修改时间。调用OH_Rdb_FindModifyTime查询指定表中指定列的数据的最后修改时间该接口返回一个有两列数据的OH_Cursor对象第一列为传入的主键/RowId第二列为最后修改时间。示例代码如下所示 OH_VObject *values OH_Rdb_CreateValueObject();
int64_t keys[] { 1 };
values-putInt64(values, keys, 1);
OH_Cursor *cursor;
cursor OH_Rdb_FindModifyTime(storeTestRdbStore_, EMPLOYEE, ROWID, values);创建分布式表。调用OH_Rdb_Execute接口创建表之后可以将已创建的表设置成分布式表并配置相关的分布式选项。使用该接口需要实现云服务功能。示例代码如下所示 constexpr int TABLE_COUNT 1;
const char *table[TABLE_COUNT];
table[0] EMPLOYEE;
int errcode OH_Rdb_SetDistributedTables(storeTestRdbStore_, table, TABLE_COUNT, Rdb_DistributedType::DISTRIBUTED_CLOUD, config);对分布式表手动执行端云同步。调用OH_Rdb_SetDistributedTables创建分布式表之后可以对该表进行手动端云同步。使用该接口需要实现云服务功能。示例代码如下所示 // 定义回调函数
void CloudSyncObserverCallback(void *context, Rdb_ProgressDetails *progressDetails)
{
// do something
}
const Rdb_ProgressObserver observer { .context nullptr, .callback CloudSyncObserverCallback };
OH_Rdb_CloudSync(storeTestRdbStore_, Rdb_SyncMode::SYNC_MODE_TIME_FIRST, table, TABLE_COUNT, observer);将数据观察者注册到指定的存储对象(store)上并订阅指定类型(type)的事件。在数据发生变化时系统会调用相应的回调函数来处理进度观察。调用OH_Rdb_Subscribe接口订阅数据变化事件。使用该接口需要实现云服务功能。示例代码如下所示 // 定义回调函数
void RdbSubscribeBriefCallback(void *context, const char *values[], uint32_t count)
{
// do something
}
Rdb_BriefObserver briefObserver;
const Rdb_BriefObserver briefObserver { .context nullptr, .callback RdbSubscribeBriefCallback };
OH_Rdb_Subscribe(storeTestRdbStore_, Rdb_SubscribeType::RDB_SUBSCRIBE_TYPE_CLOUD, briefObserver);从指定的存储对象(store)中取消对指定类型(type)的事件的订阅。取消后系统将不再调用相应的回调函数来处理进度观察。调用OH_Rdb_Unsubscribe接口取消订阅数据变化事件。使用该接口需要实现云服务功能。示例代码如下所示 // 定义回调函数
void RdbSubscribeBriefCallback(void *context, const char *values[], uint32_t count)
{
// do something
}
Rdb_BriefObserver briefObserver RdbSubscribeBriefCallback;
const Rdb_DataObserver briefObs { .context nullptr, .callback.briefObserver briefObserver };
OH_Rdb_Unsubscribe(storeTestRdbStore_, Rdb_SubscribeType::RDB_SUBSCRIBE_TYPE_CLOUD, briefObs);将进度观察者注册到指定的存储对象(store)上以便订阅自动同步进度的事件。当存储对象进行自动同步时系统会调用相应的回调函数处理进度观察。调用OH_Rdb_SubscribeAutoSyncProgress接口订阅自动同步进度事件。使用该接口需要实现云服务功能。示例代码如下所示 // 定义回调函数
void RdbProgressObserverCallback(void *context, Rdb_ProgressDetails *progressDetails)
{
// do something
}
const Rdb_ProgressObserver observer { .context nullptr, .callback RdbProgressObserverCallback };
OH_Rdb_SubscribeAutoSyncProgress(storeTestRdbStore_, observer);从指定的存储对象(store)中取消订阅自动同步进度的事件。取消后系统将不再调用相应的回调函数来处理进度观察。调用OH_Rdb_UnsubscribeAutoSyncProgress接口取消订阅自动同步进度事件。使用该接口需要实现云服务功能。示例代码如下所示 // 定义回调函数
void RdbProgressObserverCallback(void *context, Rdb_ProgressDetails *progressDetails)
{
// do something
}
const Rdb_ProgressObserver observer { .context nullptr, .callback RdbProgressObserverCallback };
OH_Rdb_UnsubscribeAutoSyncProgress(storeTestRdbStore_, observer);删除数据库。调用OH_Rdb_DeleteStore方法删除数据库及数据库相关文件。示例代码如下 // 释放数据库实例
OH_Rdb_CloseStore(store_);
// 删除数据库文件
OH_Rdb_DeleteStore(config);为了能让大家更好的学习鸿蒙HarmonyOS NEXT开发技术这边特意整理了《鸿蒙开发学习手册》共计890页希望对大家有所帮助https://qr21.cn/FV7h05
《鸿蒙开发学习手册》
如何快速入门https://qr21.cn/FV7h05
基本概念构建第一个ArkTS应用…… 开发基础知识https://qr21.cn/FV7h05
应用基础知识配置文件应用数据管理应用安全管理应用隐私保护三方应用调用管控机制资源分类与访问学习ArkTS语言…… 基于ArkTS 开发https://qr21.cn/FV7h05
Ability开发UI开发公共事件与通知窗口管理媒体安全网络与链接电话服务数据管理后台任务(Background Task)管理设备管理设备使用信息统计DFX国际化开发折叠屏系列…… 鸿蒙开发面试真题含参考答案https://qr18.cn/F781PH 鸿蒙开发面试大盘集篇共计319页https://qr18.cn/F781PH
1.项目开发必备面试题 2.性能优化方向 3.架构方向 4.鸿蒙开发系统底层方向 5.鸿蒙音视频开发方向 6.鸿蒙车载开发方向 7.鸿蒙南向开发方向
