【OpenHarmony-NDK技术】简单将cJson移植到OpenHarmony中，并在c层修改参数值再返回json

1、cJson的简单介绍

cJson - github网址

概述

一般使用cJson是，需要将json文本转化为json对象–编码，将json对象转化为json文本–解析。
git clone https://github.com/DaveGamble/cJSON.git
后留意cJSON.h和cJSON.h两个文件。

1、cJson的介绍

cJson是一个数据结构，里面含有prev next child 等指针用于获取json数据的具体值
typedef struct cJSON
{   struct cJSON *next;struct cJSON *prev;struct cJSON *child;//type是指，该节点的数据类型 int type;//字符串获取的变量char *valuestring;//int值获取的变量int valueint;//double 值获取的变量double valuedouble;//暂未接触char *string;
} cJSON;//int type的值，去这几种
//#define cJSON_Invalid (0)
//#define cJSON_False  (1 << 0)
//#define cJSON_True   (1 << 1)
//#define cJSON_NULL   (1 << 2)
//#define cJSON_Number (1 << 3)
//#define cJSON_String (1 << 4)
//#define cJSON_Array  (1 << 5)
//#define cJSON_Object (1 << 6)
//#define cJSON_Raw    (1 << 7)//编码方法
cJson* cJSON_Parse(char *); 
//解码方法
char* cJSON_Print(cJson *);

2、编码

//1、声明一个简单的字符串
char *jsonText = "{\"name\":\"zhangsan\",\"age\":18,\"price\":21.0}";
//2、将字符串给到cJSON_Parse方法，json！=null，就会给到一个cJson结构。
cJSON *json = cJSON_Parse(jsonText);// 获取到string的值
json->valuestring
// 获取到string的值
json->valuestring
// 获取到int的值
json->valueint
// 获取到int的值
json->valuedouble//以上三种方法获取对应类型的字段的值// 3、通过根json去获取到具体的一个字段(name)
cJSON *jsonValue = cJSON_GetObjectItem(json, "name");
//返回的也是一个cJson结构，获取值与上面相同操作

3、解码

//1.将一个cJOSN的结构，变量一个json文本
char * cJSON_Print(cJSON *);

2、OpenHarmony项目实现

1、项目创建

IDE版本：
DevEco Studio 3.1.1 Release
Build Version: 3.1.0.501, built on June 20, 2023
Build #DS-223.8617.56.36.310501
Runtime version: 17.0.6+10-b829.5 amd64

按照官方的要求创建一个Native项目

2、目录及文件介绍

在这里插入图片描述

1、cJSON.c是cjson实现的源码

2、cJSON.h是cJSON.c的头文件，以上两个文件可以在上面git中获取。

3、CMakeList.exe 文件时配置cmake编译的配置文件

# the minimum version of CMake.
cmake_minimum_required(VERSION 3.4.1)
project(MyFirstCpp)# 定义一个变量，并赋值为当前模块cpp目录
set(NATIVERENDER_ROOT_PATH ${CMAKE_CURRENT_SOURCE_DIR})# 添加头文件.h目录，包括cpp，cpp/include，告诉cmake去这里找到代码引入的头文件
include_directories(${NATIVERENDER_ROOT_PATH}${NATIVERENDER_ROOT_PATH}/include)
# hiloglib -- 给c层打印日志使用的
find_library(hilog_libhilog_ndk.z
)
# 声明一个产物libentry.so，SHARED表示产物为动态库，hello.cpp为产物的源代码
# ！！！注意：如果使用源码一起编译是，需要将源文件添加进来，例如：hello.cpp cjson.c
add_library(entry SHARED hello.cpp cjson.c)# 声明产物entry链接时需要的三方库libace_napi.z.so
# 这里直接写三方库的名称是因为它是在ndk中，已在链接寻址路径中，无需额外声明
# 添加的编译so库
target_link_libraries(entry PUBLIC ${hilog_lib} libace_napi.z.so)

4、Index.ets 布局文件

//伪代码
import testNapi from 'libentry.so'
json: string = "{\"name\":\"zhangsan\",\"age\":18,\"price\":21.5}";
Button().onClick(() => {let json = testNapi.modifyJson(this.json,this.inputText);hilog.info(0x0000, 'testTag', 'cjson name = %{public}d', json);
}

5、LogUtils.ts 是一个打印日志的工具

export class LogUtils{static Tag:string = 'MyFirstCpp';static i(...args){hilog.info(0x0000, LogUtils.Tag, '%{public}s', args);}static d(msg:string){hilog.debug(0x0000, LogUtils.Tag, '%{public}s', msg);}static e(msg:string){hilog.error(0x0000, LogUtils.Tag, '%{public}s', msg);}
}

6、hello.cpp文件方法配置介绍

初始化创建一个Native 项目在hello.cpp文件中默认存在如下代码：

EXTERN_C_START
static napi_value Init(napi_env env, napi_value exports) {napi_property_descriptor desc[] = {{"add", nullptr, Add, nullptr, nullptr, nullptr, napi_default, nullptr},//{"modifyJson", nullptr, ModifyJson, nullptr, nullptr, nullptr, napi_default, nullptr},};napi_define_properties(env, exports, sizeof(desc) / sizeof(desc[0]), desc);return exports;
}
EXTERN_C_ENDstatic napi_module demoModule = {.nm_version = 1,.nm_flags = 0,.nm_filename = nullptr,.nm_register_func = Init,.nm_modname = "entry",.nm_priv = ((void *)0),.reserved = {0},
};extern "C" __attribute__((constructor)) void RegisterEntryModule(void) {napi_module_register(&demoModule);
}

其中 napi_property_descriptor 变量里面存在的是c对应js的方法。需要添加不同的方法(js调用的方法)需要在这里声明。
{“add”, nullptr, Add, nullptr, nullptr, nullptr, napi_default, nullptr}
目前按照以上格式，替换一下【“add”】和【Add】的值。
eg:
我现在要声明一个modifyJson方法，如下参数，js层也一并需要声明。

{"modifyJson", nullptr, ModifyJson, nullptr, nullptr, nullptr, napi_default, nullptr}

在js层也需要声明条用的方法如下：
在src/main/cpp/types/libentry/index.d.ts文件下：

export const add: (a: number, b: number) => number;

eg:
添加 modifyJson 方法

export const add: (a: number, b: number) => number;
//json 是json字符串；nameValue 是修改name字段的值 
export const modifyJson:(json:string,nameValue:string)=>string;

3、代码介绍

首先NDK开发使用的是js的napi库。需要注意的是js和C/C++之间的数据类型之间的切换。

1、napi与C/C++之间数据类型切换

anpi 中的数据目前使用一个napi_value (js层接收的类型)
C/C++中的数据类型目前用到了 string，char*，int, double

下面就是 anpi_value 转为 C/C++ string、int、double

/*** 获取 js中的string 到 C中使用* @param env* @param value* @return */
static const string get_native_string_value(napi_env env,napi_value value){//不知道字符串长度，先获取一下，拿到字符串的真实长度size_t textLen;napi_get_value_string_utf8(env, value, NULL, 0, &textLen);//得到了真实的长度，需要在次长度上+1(不全\0)char text[textLen+1];napi_get_value_string_utf8(env, value,text, sizeof(text), &textLen);//返回的是std:string,记得导入 using namespace std;string buf(text, textLen);return buf;}/*** 获取 js 中的 int 到 C中使用* @param env* @param _msg* @return */
static int get_native_int_value(napi_env env,napi_value value){int32_t iNum;napi_get_value_int32(env, value, &iNum);return iNum;
}/*** 获取 js 中的double 到C中使用* @param env* @param _msg* @return */
static double get_native_double_value(napi_env env,napi_value value){double dNum;napi_get_value_double(env, value, &dNum);return dNum;
}

下面就是 C/C++ string、int、double 转为 napi_value(可以直接返回给js层的类型)

/*** 将c中的char* 构建一个 js的string类型* @return */
static napi_value return_string_value(napi_env env,char *_msg){napi_value msg;napi_create_string_utf8(env, _msg, strlen(_msg), &msg);return msg;
}/*** 将c中的int 构建一个 js的int类型* @return */
static napi_value return_int_value(napi_env env,int _msg){napi_value i;napi_create_int32(env, _msg, &i);return i;
}/*** 将c中的double 构建一个 js的double类型* @return */
static napi_value return_double_value(napi_env env,double _msg){napi_value d;napi_create_double(env, _msg, &d);return d;
}

4、核心处理

static napi_value ModifyJson(napi_env env, napi_callback_info info) {napi_value modifyJson;// OH_LOG_INFO c的日志，需要按照CmakeList.txt 导入库。不然无法访问OH_LOG_INFO(LOG_APP,"ModifyJson start");//1、获取js中传过来的参数，放入 args 数组中，argc 是有两个参数size_t argc = 2;napi_value args[2] = {nullptr};napi_get_cb_info(env, info, &argc, args, nullptr, nullptr);//2.获取对应参数的值string jsonText = get_native_string_value(env, args[0]);//3.获取修改的文本string newName = get_native_string_value(env, args[1]);//4.编码jsoncJSON *jsonObj = cJSON_Parse(jsonText.c_str());//5.获取字段为 name 的json对象，然后操作这个对象获取值和修改值cJSON *nameValueObj = cJSON_GetObjectItemCaseSensitive(jsonObj, "name");if(NULL == nameValueObj){//Undefined_value 和 get_native_string_value，类似只是返回 char* -> napi_value return Undefined_value(env, "NULL == nameValueObj");}//6.修改 nameValueObj 值,注意：赋值要使用 strdup 方法进行包一层，不然在 cJSON_Delete 释放时会报错//之前一个是将char* 赋值到valuestring 中，不进行strdup释放的时候回报错
//    nameValueObj->valuestring = strdup(newName.c_str());//查看cjson源码发现，自带一个修改指定字段的值 cJSON_SetValuestringcJSON_SetValuestring(nameValueObj, newName.c_str());//7.修改完值后需要重新进行对 jsonObj 进行 解码 json 再返回json到js层char *newJson = cJSON_Print(jsonObj);//8、返回新的json字符串napi_create_string_utf8(env, newJson, strlen(newJson), &modifyJson);//释放 jsonObjcJSON_Delete(jsonObj);return modifyJson;
}