#ifndef BMSER_CJSON_H_
#define BMSER_CJSON_H_

#ifdef __cplusplus
extern "C"
{
#endif

#define MAX_JSON_STRING_SIZE 1024

typedef enum {
    JSON_VALUE_NONE,
    JSON_VALUE_STRING,
    JSON_VALUE_NUMBER
} JsonValueType;

typedef struct {
    JsonValueType type;
    union {
        long long int64Val;
        double doubleVal;
        char stringVal[MAX_JSON_STRING_SIZE];
    } value;
} JsonValue;

/**
 * @brief 解析 JSON 文本并获取指定路径上 JSON 数组的长度。
 *
 * @param[in] json_text JSON 文本字符串。例:
 {
    "configFile": "DebugViewConfig",
    "frames": [
        {
            "frame_id": "",
            "regs": [
                {
                    "key": "iedname",
                    "value": "bmser"
                },
                {
                    "key": "packnum",
                    "value": 10
                }
            ]
        }
    ],
    "identifier": "systemParameterConfig",
    "mi": 1700640408784,
    "sn": "00000000"
}
 * @param[in] path 要获取数组长度的 JSON 路径。例:frames[0].regs
 * @return int 成功时返回数组的长度, 如果输入无效或者项不存在返回-1。
 * @par         修改日志:
 * Date                Author     Description           \n
 * 2023-12-08           JHC        创建初始版本          \n
 */
int json_get_array_length(const char* json_text, const char* path);

/**
 * @brief 根据给定的 JSON 文本和路径获取数据，并填充到结果结构体中。
 *
 * @param[in] json_text JSON 文本字符串。例:
 {
    "configFile": "DebugViewConfig",
    "frames": [
        {
            "frame_id": "",
            "regs": [
                {
                    "key": "iedname",
                    "value": "bmser"
                },
                {
                    "key": "packnum",
                    "value": 10
                }
            ]
        }
    ],
    "identifier": "systemParameterConfig",
    "mi": 1700640408784,
    "sn": "00000000"
}
 * @param[in] path 路径字符串，指定要获取数据的路径。例:frames[0].regs[0].key
 * @param[out] result 指向 JsonValue 结构体的指针，用于存放获取到的数据。
 * @return int 成功时返回0, 失败时返回-1。
 * @par         修改日志:
 * Date                Author     Description           \n
 * 2023-12-08           JHC        创建初始版本          \n
 */
int json_value_get_by_json_path(const char* json_text, const char* path, JsonValue* result);


/**
 * 读取文件内容并返回文件的全部文本内容。
 *
 * @param[i] fileName 需要读取的文件名。
 * @return 返回指向文件内容的指针。需要由调用者负责释放这段内存。若出错，则返回NULL。
 * @par         修改日志:
 * Date                Author     Description           \n
 * 2023-12-08           JHC        创建初始版本          \n
 */
char* jsonFileContent_read(const char* fileName);
#ifdef __cplusplus
}
#endif

#endif // !BMSER_CJSON