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;
}
以上就是简单的将cJson 移植到OpenHarmony。希望可以帮助到大家!!!