场景介绍
OpenHarmony提供Purgeable Memory内存管理机制,开发者可以使用相关接口创建PurgeableMemory对象,从而管理purgeable内存。
开发者可以通过本指导了解在OpenHarmony应用中,如何使用Native层相关接口操作purgeable内存。功能包括purgeable内存的申请、释放等。
针对Purgeable Memory内存管理机制,常见的开发场景如下:
- 通过该机制提供的
NAPI接口申请管理PurgeableMemory对象,并将数据内容写入该对象。 - 使用完毕后释放。
接口说明
| 接口名 | 描述 |
|---|---|
| OH_PurgeableMemory *OH_PurgeableMemory_Create(size_t size, OH_PurgeableMemory_ModifyFunc func, void *funcPara) | 创建PurgeableMemory对象,每次调用都会产生一个新的PurgeableMemory对象。 |
| bool OH_PurgeableMemory_Destroy(OH_PurgeableMemory *purgObj) | 对PurgeableMemory对象进行析构操作。 |
| bool OH_PurgeableMemory_BeginRead(OH_PurgeableMemory *purgObj) | 对PurgeableMemory对象进行读访问。 |
| void OH_PurgeableMemory_EndRead(OH_PurgeableMemory *purgObj) | 读操作结束,将PurgeableMemory对象的引用计数减1,当引用计数为0的时候, 该PurgeableMemory对象可以被系统回收。 |
| bool OH_PurgeableMemory_BeginWrite(OH_PurgeableMemory *purgObj) | 对PurgeableMemory对象进行写访问。 |
| void OH_PurgeableMemory_EndWrite(OH_PurgeableMemory *purgObj) | 写操作结束,将PurgeableMemory对象的引用计数减1,当引用计数为0的时候,该PurgeableMemory对象可以被系统回收。 |
| void *OH_PurgeableMemory_GetContent(OH_PurgeableMemory *purgObj) | 获取PurgeableMemory对象内存数据。 |
| size_t OH_PurgeableMemory_ContentSize(OH_PurgeableMemory *purgObj) | 获取PurgeableMemory对象内存数据大小。 |
| bool OH_PurgeableMemory_AppendModify(OH_PurgeableMemory *purgObj, OH_PurgeableMemory_ModifyFunc func, void *funcPara) | 添加PurgeableMemory对象的修改方法。 |
Purgeable Memory应用开发步骤
以下步骤描述了在OpenHarmony中如何使用Purgeable Memory提供的NAPI接口,申请PurgeableMemory对象,并将内容写入PurgeableMemory对象后,对相应对象进行读写访问。
- 声明PurgeableMemory对象创建规则。
// 声明构建函数的参数
struct ParaData{
int start;
int end;
};
// 声明一个使用ModifyFunc
bool FactorialFunc(void* data, size_t size, void* param){
bool ret = true;
ParaData *pdata = (ParaData*) param;
int* oriData = (int*)data;
int i = pdata->start;
while(i<pdata->end){
*oriData *= i;
i++;
}
return ret;
}
// 声明修改PurgeableMemory对象扩展函数的参数
struct AppendParaData{
int newPara;
};
// 声明修改PurgeableMemory对象的扩展函数
bool AddFunc(void* data, size_t size, void* param){
bool ret = true;
int *oriDatap = (int*) data;
AppendParaData* apData = (AppendParaData*)param;
*oriDatap += apData->newPara;
return ret;
}
- 创建PurgeableMemory对象。
// 声明一个4MB的PurgeableMemory对象大小
#define DATASIZE (4 * 1024 * 1024)
// 声明创建函数的参数
struct ParaData pdata = {1,2};
// 创建一个PurgeableMemory对象
OH_PurgeableMemory* pPurgmem = OH_PurgeableMemory_Create(DATASIZE, FactorialFunc, &pdata);
- 读访问PurgeableMemory对象。
//业务定义对象类型
class ReqObj;
// 读取对象
OH_PurgeableMemory_BeginRead(pPurgmem);
// 获取PurgeableMemory对象大小
size_t size = OH_PurgeableMemory_ContentSize(pPurgmem);
// 获取PurgeableMemory对象内容
ReqObj* pReqObj = (ReqObj*) OH_PurgeableMemory_GetContent(pPurgmem);
// 读取PurgeableMemory对象结束
OH_PurgeableMemory_EndRead(pPurgmem);
- 写访问PurgeableMemory对象。
//业务定义对象类型
class ReqObj;
// 修改PurgeableMemory对象
OH_PurgeableMemory_BeginWrite(pPurgmem);
// 获取PurgeableMemory对象数据
ReqObj* pReqObj = (ReqObj*) OH_PurgeableMemory_GetContent(pPurgmem);
// 声明扩展创建函数的参数
struct AppendParaData apdata = {1};
// 更新PurgeableMemory对象重建规则
OH_PurgeableMemory_AppendModify(pPurgmem, AddFunc, &apdata);
// 修改PurgeableMemory对象结束
OH_PurgeableMemory_EndWrite(pPurgmem);
- 销毁PurgeableMemory对象。
// 销毁对象
OH_PurgeableMemory_Destroy(pPurgmem);
写在最后
- 如果你觉得这篇内容对你还蛮有帮助,我想邀请你帮我三个小忙:
- 点赞,转发,有你们的 『点赞和评论』,才是我创造的动力。
- 关注小编,同时可以期待后续文章ing🚀,不定期分享原创知识。
- 想要获取更多完整鸿蒙最新学习知识点,请移步前往小编:
https://gitee.com/MNxiaona/733GH/blob/master/jianshu
