• Home
  • Features
  • Pricing
  • Docs
  • Announcements
  • Sign In

taosdata / TDengine / #5051

13 May 2026 12:00PM UTC coverage: 73.358% (-0.04%) from 73.398%
#5051

push

travis-ci

web-flow
feat: taosdump support stream backup/restore (#35326)

139 of 170 new or added lines in 3 files covered. (81.76%)

714 existing lines in 146 files now uncovered.

281543 of 383795 relevant lines covered (73.36%)

135448694.71 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

76.34
/source/util/src/tjson.c
1
/*
2
 * Copyright (c) 2019 TAOS Data, Inc. <jhtao@taosdata.com>
3
 *
4
 * This program is free software: you can use, redistribute, and/or modify
5
 * it under the terms of the GNU Affero General Public License, version 3
6
 * or later ("AGPL"), as published by the Free Software Foundation.
7
 *
8
 * This program is distributed in the hope that it will be useful, but WITHOUT
9
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
10
 * FITNESS FOR A PARTICULAR PURPOSE.
11
 *
12
 * You should have received a copy of the GNU Affero General Public License
13
 * along with this program. If not, see <http://www.gnu.org/licenses/>.
14
 */
15

16
#define _DEFAULT_SOURCE
17

18
#include "tjson.h"
19
#include "cJSON.h"
20
#include "taoserror.h"
21

22
SJson* tjsonCreateObject() {
2,147,483,647✔
23
  SJson* pJson = cJSON_CreateObject();
2,147,483,647✔
24
  if (pJson == NULL) {
2,147,483,647✔
25
    terrno = TSDB_CODE_OUT_OF_MEMORY;
×
26
  }
27
  return pJson;
2,147,483,647✔
28
}
29

30
SJson* tjsonCreateArray() {
45,255,411✔
31
  SJson* pJson = cJSON_CreateArray();
45,255,411✔
32
  if (pJson == NULL) {
45,263,283✔
33
    terrno = TSDB_CODE_OUT_OF_MEMORY;
×
34
  }
35
  return pJson;
45,259,982✔
36
}
37

38
void tjsonDelete(SJson* pJson) {
776,832,437✔
39
  if (pJson != NULL) {
776,832,437✔
40
    cJSON_Delete((cJSON*)pJson);
776,834,516✔
41
  }
42
}
776,834,758✔
43

44
int32_t tjsonAddIntegerToObject(SJson* pJson, const char* pName, const uint64_t number) {
2,147,483,647✔
45
  char tmp[40] = {0};
2,147,483,647✔
46
  snprintf(tmp, sizeof(tmp), "%" PRId64, number);
2,147,483,647✔
47
  return tjsonAddStringToObject(pJson, pName, tmp);
2,147,483,647✔
48
}
49

50
int32_t tjsonAddDoubleToObject(SJson* pJson, const char* pName, const double number) {
537,524,646✔
51
  if (NULL == cJSON_AddNumberToObject((cJSON*)pJson, pName, number)) {
537,524,646✔
52
    return terrno = TSDB_CODE_OUT_OF_MEMORY;
555✔
53
  }
54

55
  return TSDB_CODE_SUCCESS;
537,523,846✔
56
}
57

58
int32_t tjsonAddBoolToObject(SJson* pJson, const char* pName, const bool boolean) {
2,147,483,647✔
59
  if (NULL == cJSON_AddBoolToObject((cJSON*)pJson, pName, boolean)) {
2,147,483,647✔
UNCOV
60
    return terrno = TSDB_CODE_OUT_OF_MEMORY;
×
61
  }
62

63
  return TSDB_CODE_SUCCESS;
2,147,483,647✔
64
}
65

66
int32_t tjsonAddStringToObject(SJson* pJson, const char* pName, const char* pVal) {
2,147,483,647✔
67
  if (NULL == cJSON_AddStringToObject((cJSON*)pJson, pName, pVal)) {
2,147,483,647✔
68
    return terrno = TSDB_CODE_OUT_OF_MEMORY;
84,174✔
69
  }
70

71
  return TSDB_CODE_SUCCESS;
2,147,483,647✔
72
}
73

74
SJson* tjsonAddArrayToObject(SJson* pJson, const char* pName) {
2,147,483,647✔
75
  SJson* ret = (SJson*)cJSON_AddArrayToObject((cJSON*)pJson, pName);
2,147,483,647✔
76
  if (ret == NULL) {
2,147,483,647✔
77
    terrno = TSDB_CODE_OUT_OF_MEMORY;
×
78
  }
79
  return ret;
2,147,483,647✔
80
}
81

82
int32_t tjsonAddItemToObject(SJson* pJson, const char* pName, SJson* pItem) {
2,147,483,647✔
83
  if (cJSON_AddItemToObject((cJSON*)pJson, pName, pItem)) {
2,147,483,647✔
84
    return TSDB_CODE_SUCCESS;
2,147,483,647✔
85
  }
86

UNCOV
87
  return terrno = TSDB_CODE_OUT_OF_MEMORY;
×
88
}
89

90
int32_t tjsonAddItemToArray(SJson* pJson, SJson* pItem) {
2,147,483,647✔
91
  if (cJSON_AddItemToArray((cJSON*)pJson, pItem)) {
2,147,483,647✔
92
    return TSDB_CODE_SUCCESS;
2,147,483,647✔
93
  }
94

95
  return terrno = TSDB_CODE_OUT_OF_MEMORY;
×
96
}
97

98
int32_t tjsonAddObject(SJson* pJson, const char* pName, FToJson func, const void* pObj) {
2,147,483,647✔
99
  if (NULL == pObj) {
2,147,483,647✔
100
    return TSDB_CODE_SUCCESS;
2,147,483,647✔
101
  }
102

103
  SJson* pJobj = tjsonCreateObject();
2,147,483,647✔
104
  if (NULL == pJobj) {
2,147,483,647✔
105
    return terrno;
×
106
  }
107
  int32_t rc = func(pObj, pJobj);
2,147,483,647✔
108
  if (rc != TSDB_CODE_SUCCESS) {
2,147,483,647✔
109
    tjsonDelete(pJobj);
×
110
    return rc;
×
111
  }
112
  return tjsonAddItemToObject(pJson, pName, pJobj);
2,147,483,647✔
113
}
114

115
int32_t tjsonAddItem(SJson* pJson, FToJson func, const void* pObj) {
2,147,483,647✔
116
  SJson* pJobj = tjsonCreateObject();
2,147,483,647✔
117
  if (pJobj == NULL) {
2,147,483,647✔
118
    return terrno;
×
119
  }
120

121
  int32_t rc = func(pObj, pJobj);
2,147,483,647✔
122
  if (rc != TSDB_CODE_SUCCESS) {
2,147,483,647✔
123
    tjsonDelete(pJobj);
×
124
    return rc;
×
125
  }
126
  return tjsonAddItemToArray(pJson, pJobj);
2,147,483,647✔
127
}
128

129
int32_t tjsonAddArray(SJson* pJson, const char* pName, FToJson func, const void* pArray, int32_t itemSize,
1,067,907,147✔
130
                      int32_t num) {
131
  if (num > 0) {
1,067,907,147✔
132
    SJson* pJsonArray = tjsonAddArrayToObject(pJson, pName);
985,841,397✔
133
    if (NULL == pJsonArray) {
985,840,396✔
134
      return terrno;
180✔
135
    }
136
    for (size_t i = 0; i < num; ++i) {
2,070,235,016✔
137
      int32_t code = tjsonAddItem(pJsonArray, func, (const char*)pArray + itemSize * i);
1,084,395,802✔
138
      if (TSDB_CODE_SUCCESS != code) {
1,084,394,362✔
139
        return code;
×
140
      }
141
    }
142
  }
143
  return TSDB_CODE_SUCCESS;
1,067,904,964✔
144
}
145

146
int32_t tjsonAddTArray(SJson* pJson, const char* pName, FToJson func, const SArray* pArray) {
4,444,435✔
147
  int32_t num = taosArrayGetSize(pArray);
4,444,435✔
148
  if (num > 0) {
4,444,435✔
149
    SJson* pJsonArray = tjsonAddArrayToObject(pJson, pName);
1,689,359✔
150
    if (NULL == pJsonArray) {
1,689,359✔
151
      return terrno;
×
152
    }
153
    for (int32_t i = 0; i < num; ++i) {
4,118,903✔
154
      int32_t code = tjsonAddItem(pJsonArray, func, taosArrayGet(pArray, i));
2,429,544✔
155
      if (TSDB_CODE_SUCCESS != code) {
2,429,544✔
156
        return code;
×
157
      }
158
    }
159
  }
160
  return TSDB_CODE_SUCCESS;
4,444,435✔
161
}
162

163
char* tjsonToString(const SJson* pJson) {
43,070,841✔
164
  char* p = cJSON_Print((cJSON*)pJson);
43,070,841✔
165
  if (!p) {
43,081,184✔
166
    terrno = TSDB_CODE_OUT_OF_MEMORY;
×
167
  }
168
  return p;
43,079,180✔
169
}
170

171
char* tjsonToUnformattedString(const SJson* pJson) {
711,458,124✔
172
  char* p = cJSON_PrintUnformatted((cJSON*)pJson);
711,458,124✔
173
  if (!p) {
711,460,830✔
174
    terrno = TSDB_CODE_OUT_OF_MEMORY;
×
175
  }
176
  return p;
711,461,295✔
177
}
178

179
SJson* tjsonGetObjectItem(const SJson* pJson, const char* pName) { return cJSON_GetObjectItem(pJson, pName); }
2,147,483,647✔
180

181
int32_t tjsonGetObjectName(const SJson* pJson, char** pName) {
1,177✔
182
  *pName = ((cJSON*)pJson)->string;
1,177✔
183
  if (NULL == *pName) {
1,177✔
184
    return TSDB_CODE_FAILED;
×
185
  }
186
  return TSDB_CODE_SUCCESS;
1,177✔
187
}
188

189
int32_t tjsonGetObjectValueString(const SJson* pJson, char** pValueString) {
1,177✔
190
  *pValueString = ((cJSON*)pJson)->valuestring;
1,177✔
191
  if (NULL == *pValueString) {
1,177✔
192
    return TSDB_CODE_FAILED;
×
193
  }
194
  return TSDB_CODE_SUCCESS;
1,177✔
195
}
196

197
void tjsonGetObjectValueBigInt(const SJson* pJson, int64_t* pVal) { *pVal = (int64_t)((cJSON*)pJson)->valuedouble; }
×
198

199
void tjsonGetObjectValueDouble(const SJson* pJson, double* pVal) { *pVal = ((cJSON*)pJson)->valuedouble; }
×
200

201
int32_t tjsonGetStringValue(const SJson* pJson, const char* pName, char* pVal) {
×
202
  char* p = cJSON_GetStringValue(tjsonGetObjectItem((cJSON*)pJson, pName));
×
203
  if (NULL == p) {
×
204
    return TSDB_CODE_SUCCESS;
×
205
  }
206
  TAOS_STRCPY(pVal, p);
×
207
  return TSDB_CODE_SUCCESS;
×
208
}
209
int32_t tjsonGetStringValue1(const SJson* pJson, const char* pName, char* pVal, int32_t cap) {
712,730,356✔
210
  char* p = cJSON_GetStringValue(tjsonGetObjectItem((cJSON*)pJson, pName));
712,730,356✔
211
  if (NULL == p) {
712,743,641✔
212
    return TSDB_CODE_SUCCESS;
×
213
  }
214
  int32_t len = strlen(p);
712,743,641✔
215
  if (len >= cap) {
712,743,641✔
216
    return TSDB_CODE_OUT_OF_MEMORY;
×
217
  }
218
  TAOS_STRCPY(pVal, p);
712,743,641✔
219
  return TSDB_CODE_SUCCESS;
712,743,641✔
220
}
221

222
int32_t tjsonGetStringValue2(const SJson* pJson, const char* pName, char* pVal, int32_t maxLen) {
14,166✔
223
  char* p = cJSON_GetStringValue(tjsonGetObjectItem((cJSON*)pJson, pName));
14,166✔
224
  if (NULL == p) {
14,166✔
225
    return TSDB_CODE_SUCCESS;
×
226
  }
227
  int32_t len = strlen(p);
14,166✔
228
  if (len >= maxLen - 1) {
14,166✔
229
    return TSDB_CODE_OUT_OF_MEMORY;
×
230
  }
231
  if (pVal == NULL) {
14,166✔
232
    return TSDB_CODE_INVALID_PARA;
×
233
  } else {
234
    strcpy(pVal, p);
14,166✔
235
  }
236
  return TSDB_CODE_SUCCESS;
14,166✔
237
}
238

239
const char* tjsonGetStringPointer(const SJson* pJson, const char* pName) {
2,233✔
240
  return cJSON_GetStringValue(tjsonGetObjectItem((cJSON*)pJson, pName));
2,233✔
241
}
242

243
int32_t tjsonDupStringValue(const SJson* pJson, const char* pName, char** pVal) {
15,497,442✔
244
  char* p = cJSON_GetStringValue(tjsonGetObjectItem((cJSON*)pJson, pName));
15,497,442✔
245
  if (NULL == p) {
15,497,809✔
246
    return TSDB_CODE_SUCCESS;
2,673,183✔
247
  }
248
  *pVal = taosStrdup(p);
12,824,626✔
249
  return TSDB_CODE_SUCCESS;
12,824,626✔
250
}
251

252
int32_t tjsonGetBigIntValue(const SJson* pJson, const char* pName, int64_t* pVal) {
2,147,483,647✔
253
  char* p = cJSON_GetStringValue(tjsonGetObjectItem((cJSON*)pJson, pName));
2,147,483,647✔
254
  if (NULL == p) {
2,147,483,647✔
255
    return TSDB_CODE_SUCCESS;
18,965,573✔
256
  }
257
#ifdef WINDOWS
258
  sscanf(p, "%" PRId64, pVal);
259
#else
260
  *pVal = taosStr2Int64(p, NULL, 10);
2,147,483,647✔
261
#endif
262
  return TSDB_CODE_SUCCESS;
2,147,483,647✔
263
}
264

265
int32_t tjsonGetIntValue(const SJson* pJson, const char* pName, int32_t* pVal) {
831,922,156✔
266
  int64_t val = 0;
831,922,156✔
267
  int32_t code = tjsonGetBigIntValue(pJson, pName, &val);
831,953,809✔
268
  *pVal = val;
831,938,391✔
269
  return code;
831,953,051✔
270
}
271

272
int32_t tjsonGetSmallIntValue(const SJson* pJson, const char* pName, int16_t* pVal) {
317,033,217✔
273
  int64_t val = 0;
317,033,217✔
274
  int32_t code = tjsonGetBigIntValue(pJson, pName, &val);
317,038,310✔
275
  *pVal = val;
317,029,382✔
276
  return code;
317,032,844✔
277
}
278

279
int32_t tjsonGetTinyIntValue(const SJson* pJson, const char* pName, int8_t* pVal) {
125,387,894✔
280
  int64_t val = 0;
125,387,894✔
281
  int32_t code = tjsonGetBigIntValue(pJson, pName, &val);
125,388,438✔
282
  *pVal = val;
125,389,078✔
283
  return code;
125,389,666✔
284
}
285

286
int32_t tjsonGetUBigIntValue(const SJson* pJson, const char* pName, uint64_t* pVal) {
647,527,115✔
287
  char* p = cJSON_GetStringValue(tjsonGetObjectItem((cJSON*)pJson, pName));
647,527,115✔
288
  if (NULL == p) {
647,547,035✔
289
    return TSDB_CODE_SUCCESS;
×
290
  }
291
#ifdef WINDOWS
292
  sscanf(p, "%" PRIu64, pVal);
293
#else
294
  *pVal = taosStr2UInt64(p, NULL, 10);
647,547,035✔
295
#endif
296
  return TSDB_CODE_SUCCESS;
647,533,530✔
297
}
298

299
int32_t tjsonGetUIntValue(const SJson* pJson, const char* pName, uint32_t* pVal) {
4,165,253✔
300
  uint64_t val = 0;
4,165,253✔
301
  int32_t  code = tjsonGetUBigIntValue(pJson, pName, &val);
4,165,253✔
302
  *pVal = val;
4,165,253✔
303
  return code;
4,165,253✔
304
}
305

306
int32_t tjsonGetUSmallIntValue(const SJson* pJson, const char* pName, uint16_t* pVal) {
1,235,004✔
307
  uint64_t val = 0;
1,235,004✔
308
  int32_t  code = tjsonGetUBigIntValue(pJson, pName, &val);
1,235,004✔
309
  *pVal = val;
1,235,004✔
310
  return code;
1,235,004✔
311
}
312

313
int32_t tjsonGetUTinyIntValue(const SJson* pJson, const char* pName, uint8_t* pVal) {
566,013,333✔
314
  uint64_t val = 0;
566,013,333✔
315
  int32_t  code = tjsonGetUBigIntValue(pJson, pName, &val);
566,018,650✔
316
  *pVal = val;
566,038,312✔
317
  return code;
566,041,178✔
318
}
319

320
int32_t tjsonGetBoolValue(const SJson* pJson, const char* pName, bool* pVal) {
746,022,605✔
321
  const SJson* pObject = tjsonGetObjectItem(pJson, pName);
746,022,605✔
322
  if (NULL == pObject) {
746,056,145✔
323
    return TSDB_CODE_SUCCESS;
×
324
  }
325
  if (!cJSON_IsBool(pObject)) {
746,056,145✔
326
    return TSDB_CODE_FAILED;
×
327
  }
328
  *pVal = cJSON_IsTrue(pObject) ? true : false;
746,062,254✔
329
  return TSDB_CODE_SUCCESS;
746,056,719✔
330
}
331

332
int32_t tjsonGetDoubleValue(const SJson* pJson, const char* pName, double* pVal) {
26,806,639✔
333
  const SJson* pObject = tjsonGetObjectItem(pJson, pName);
26,806,639✔
334
  if (NULL == pObject) {
26,809,544✔
335
    return TSDB_CODE_SUCCESS;
1,205,877✔
336
  }
337
  if (!cJSON_IsNumber(pObject)) {
25,603,667✔
338
    return TSDB_CODE_FAILED;
×
339
  }
340
  *pVal = cJSON_GetNumberValue(pObject);
25,603,113✔
341
  return TSDB_CODE_SUCCESS;
25,603,117✔
342
}
343

344
bool tjsonIsArray(const SJson* pJson) { return cJSON_IsArray(pJson); }
779,678✔
345

346
int32_t tjsonGetArraySize(const SJson* pJson) { return cJSON_GetArraySize(pJson); }
97,199,562✔
347

348
SJson* tjsonGetArrayItem(const SJson* pJson, int32_t index) { return cJSON_GetArrayItem(pJson, index); }
190,013,622✔
349

350
int32_t tjsonToObject(const SJson* pJson, const char* pName, FJsonToObject func, void* pObj) {
474,086,633✔
351
  SJson* pJsonObj = tjsonGetObjectItem(pJson, pName);
474,086,633✔
352
  if (NULL == pJsonObj) {
474,065,047✔
353
    return TSDB_CODE_SUCCESS;
6,111,109✔
354
  }
355
  return func(pJsonObj, pObj);
467,953,938✔
356
}
357

358
int32_t tjsonMakeObject(const SJson* pJson, const char* pName, FJsonToObject func, void** pObj, int32_t objSize) {
1,770,273✔
359
  if (objSize <= 0) {
1,770,273✔
360
    return TSDB_CODE_SUCCESS;
1,068,376✔
361
  }
362

363
  SJson* pJsonObj = tjsonGetObjectItem(pJson, pName);
701,897✔
364
  if (NULL == pJsonObj) {
701,897✔
365
    return TSDB_CODE_SUCCESS;
×
366
  }
367
  *pObj = taosMemoryCalloc(1, objSize);
701,897✔
368
  if (NULL == *pObj) {
701,897✔
369
    return terrno;
×
370
  }
371
  return func(pJsonObj, *pObj);
701,897✔
372
}
373

374
int32_t tjsonToArray(const SJson* pJson, const char* pName, FJsonToObject func, void* pArray, int32_t itemSize) {
11,560,276✔
375
  const cJSON* jArray = tjsonGetObjectItem(pJson, pName);
11,560,276✔
376
  int32_t      size = (NULL == jArray ? 0 : tjsonGetArraySize(jArray));
11,559,942✔
377
  for (int32_t i = 0; i < size; ++i) {
24,529,960✔
378
    int32_t code = func(tjsonGetArrayItem(jArray, i), (char*)pArray + itemSize * i);
12,970,018✔
379
    if (TSDB_CODE_SUCCESS != code) {
12,970,018✔
380
      return code;
×
381
    }
382
  }
383
  return TSDB_CODE_SUCCESS;
11,559,942✔
384
}
385

386
int32_t tjsonToTArray(const SJson* pJson, const char* pName, FJsonToObject func, SArray** pArray, int32_t itemSize) {
9,420,940✔
387
  const cJSON* jArray = tjsonGetObjectItem(pJson, pName);
9,420,940✔
388
  int32_t      size = tjsonGetArraySize(jArray);
9,420,940✔
389
  if (size > 0) {
9,420,940✔
390
    *pArray = taosArrayInit_s(itemSize, size);
4,349,287✔
391
    if (NULL == *pArray) {
4,349,287✔
392
      return terrno;
×
393
    }
394
    for (int32_t i = 0; i < size; ++i) {
11,732,401✔
395
      int32_t code = func(tjsonGetArrayItem(jArray, i), taosArrayGet(*pArray, i));
7,383,114✔
396
      if (TSDB_CODE_SUCCESS != code) {
7,383,114✔
397
        return code;
×
398
      }
399
    }
400
  }
401
  return TSDB_CODE_SUCCESS;
9,420,940✔
402
}
403

404
SJson* tjsonParse(const char* pStr) { return cJSON_Parse(pStr); }
19,418,669✔
405

406
bool tjsonValidateJson(const char* jIn) {
×
407
  if (!jIn) {
×
408
    return false;
×
409
  }
410

411
  // set json real data
412
  cJSON* root = cJSON_Parse(jIn);
×
413
  if (root == NULL) {
×
414
    return false;
×
415
  }
416

417
  if (!cJSON_IsObject(root)) {
×
418
    return false;
×
419
  }
420
  int size = cJSON_GetArraySize(root);
×
421
  for (int i = 0; i < size; i++) {
×
422
    cJSON* item = cJSON_GetArrayItem(root, i);
×
423
    if (!item) {
×
424
      return false;
×
425
    }
426

427
    char* jsonKey = item->string;
×
428
    if (!jsonKey) return false;
×
429
    for (size_t j = 0; j < strlen(jsonKey); ++j) {
×
430
      if (isprint(jsonKey[j]) == 0) return false;
×
431
    }
432

433
    if (item->type == cJSON_Object || item->type == cJSON_Array) {
×
434
      return false;
×
435
    }
436
  }
437
  return true;
×
438
}
439

440
const char* tjsonGetError() { return cJSON_GetErrorPtr(); }
×
441

442
void tjsonDeleteItemFromObject(const SJson* pJson, const char* pName) {
784✔
443
  cJSON_DeleteItemFromObject((cJSON*)pJson, pName);
784✔
444
}
784✔
STATUS · Troubleshooting · Open an Issue · Sales · Support · CAREERS · ENTERPRISE · START FREE · SCHEDULE DEMO
ANNOUNCEMENTS · TWITTER · TOS & SLA · Supported CI Services · What's a CI service? · Automated Testing

© 2026 Coveralls, Inc