yumapro  25.10-2
YumaPro SDK
Loading...
Searching...
No Matches
json_wr.h
Go to the documentation of this file.
1/*
2 * Copyright (c) 2008 - 2012, Andy Bierman, All Rights Reserved.
3 * Copyright (c) 2012 - 2021, YumaWorks, Inc., All Rights Reserved.
4 *
5 * Unless required by applicable law or agreed to in writing,
6 * software distributed under the License is distributed on an
7 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
8 * KIND, either express or implied. See the License for the
9 * specific language governing permissions and limitations
10 * under the License.
11 */
12#ifndef _H_json_wr
13#define _H_json_wr
14
15/* FILE: json_wr.h
16*********************************************************************
17* *
18* P U R P O S E *
19* *
20*********************************************************************/
21
27/*********************************************************************
28* *
29* C H A N G E H I S T O R Y *
30* *
31*********************************************************************
32
33date init comment
34----------------------------------------------------------------------
3501-sep-11 abb Begun;
36
37*/
38
39#include <stdio.h>
40#include <xmlstring.h>
41
42#ifndef _H_ses
43#include "ses.h"
44#endif
45
46#ifndef _H_status
47#include "status.h"
48#endif
49
50#ifndef _H_val
51#include "val.h"
52#endif
53
54#ifndef _H_val_util
55#include "val_util.h"
56#endif
57
58#ifndef _H_getcb
59#include "getcb.h"
60#endif
61
62#ifdef __cplusplus
63extern "C" {
64#endif
65
66/********************************************************************
67* *
68* C O N S T A N T S *
69* *
70*********************************************************************/
71#define JSON_WR_YANG_NULL (const xmlChar *)"[null]"
72
73/********************************************************************
74* *
75* T Y P E S *
76* *
77*********************************************************************/
78
79
88typedef enum json_wr_tag_t_ {
89 JSON_WR_TAG_NONE,
90 JSON_WR_TAG_FIRST,
91 JSON_WR_TAG_MIDDLE,
92 JSON_WR_TAG_LAST
93} json_wr_tag_t;
94
96typedef struct json_walker_cookie_t_ {
98 ses_cb_t *scb;
99
101 xml_msg_hdr_t *msg;
102
104 int32 indent;
105
107 val_nodetest_fn_t testfn;
108
110 boolean expand_varexpr;
111
113 boolean maxmode;
114
116 boolean isfirst;
117
119 boolean isfirstchild;
120
121 /* YPW-1199: malformed JSON output for leaf-lists and list */
127 boolean list_failed;
128
129} json_walker_cookie_t;
130
131
132/********************************************************************
133* *
134* F U N C T I O N S *
135* *
136*********************************************************************/
137
138
148extern void
149 json_wr_start_object (ses_cb_t *scb,
150 xml_msg_hdr_t *msg,
151 const xmlChar *modname,
152 const xmlChar *name,
153 int32 startindent);
154
155
167extern void
168 json_wr_start_object_ex (ses_cb_t *scb,
169 xml_msg_hdr_t *msg,
170 const xmlChar *modname,
171 const xmlChar *name,
172 int32 startindent,
173 boolean startbrace,
174 boolean endbrace);
175
176
187extern void
188 json_wr_start_object_val (ses_cb_t *scb,
189 xml_msg_hdr_t *msg,
190 val_value_t *val,
191 int32 startindent);
192
193
205extern void
206 json_wr_start_object_obj (ses_cb_t *scb,
207 xml_msg_hdr_t *msg,
208 const xmlChar *modname,
209 const xmlChar *name,
210 obj_template_t *obj,
211 int32 startindent);
212
213
221extern void
222 json_wr_end_object (ses_cb_t *scb,
223 xml_msg_hdr_t *msg,
224 int32 startindent);
225
226
234extern void
235 json_wr_start_array (ses_cb_t *scb,
236 xml_msg_hdr_t *msg,
237 int32 startindent);
238
239
252extern void
253 json_wr_start_array_obj (ses_cb_t *scb,
254 xml_msg_hdr_t *msg,
255 const xmlChar *modname,
256 const xmlChar *name,
257 obj_template_t *obj,
258 int32 startindent,
259 boolean startbrace,
260 boolean startbracket);
261
262
273extern void
274 json_wr_start_array_val (ses_cb_t *scb,
275 xml_msg_hdr_t *msg,
276 val_value_t *val,
277 int32 startindent,
278 boolean startbrace,
279 boolean startbracket);
280
281
289extern void
290 json_wr_end_array (ses_cb_t *scb,
291 xml_msg_hdr_t *msg,
292 int32 startindent);
293
294
309extern void
310 json_wr_simval_line (ses_cb_t *scb,
311 xml_msg_hdr_t *msg,
312 xmlns_id_t nsid,
313 const xmlChar *namestr,
314 const xmlChar *valstr,
315 ncx_btype_t btyp,
316 int32 startindent,
317 boolean isfirst);
318
319
320
321
338extern void
339 json_wr_simval_line2 (ses_cb_t *scb,
340 xml_msg_hdr_t *msg,
341 const xmlChar *modname,
342 const xmlChar *namestr,
343 const xmlChar *valstr,
344 ncx_btype_t btyp,
345 int32 startindent,
346 boolean isfirst);
347
348
378extern status_t
379 json_wr_max_check_val (ses_cb_t *scb,
380 xml_msg_hdr_t *msg,
381 xmlns_id_t parent_nsid,
382 val_value_t *val,
383 int32 startindent,
384 val_nodetest_fn_t testfn,
385 boolean isfirst,
386 boolean islast,
387 boolean isfirstchild,
388 boolean isfirstsibling,
389 boolean force_lastsibling,
390 boolean force_lastsib_value,
391 boolean force_array_obj);
392
393
426extern status_t
427 json_wr_max_check_val_force (ses_cb_t *scb,
428 xml_msg_hdr_t *msg,
429 xmlns_id_t parent_nsid,
430 val_value_t *val,
431 int32 startindent,
432 val_nodetest_fn_t testfn,
433 boolean isfirst,
434 boolean islast,
435 boolean isfirstchild,
436 boolean isfirstsibling,
437 boolean force_lastsibling,
438 boolean force_lastsib_value,
439 boolean force_array_obj,
440 xmlns_id_t force_nsid,
441 const xmlChar *force_name);
442
443
459extern status_t
460 json_wr_full_check_val (ses_cb_t *scb,
461 xml_msg_hdr_t *msg,
462 xmlns_id_t parent_nsid,
463 val_value_t *val,
464 int32 startindent,
465 val_nodetest_fn_t testfn);
466
467
485extern status_t
486 json_wr_full_check_val_force (ses_cb_t *scb,
487 xml_msg_hdr_t *msg,
488 xmlns_id_t parent_nsid,
489 val_value_t *val,
490 int32 startindent,
491 val_nodetest_fn_t testfn,
492 xmlns_id_t force_nsid,
493 const xmlChar *force_name);
494
495
506extern status_t
507 json_wr_check_open_file (FILE *fp,
508 val_value_t *val,
509 int32 startindent,
510 int32 indent,
511 val_nodetest_fn_t testfn);
512
513
526extern status_t
527 json_wr_check_open_file2 (FILE *fp,
528 val_value_t *val,
529 int32 startindent,
530 int32 indent,
531 val_nodetest_fn_t testfn,
532 boolean modnames);
533
534
535
536
537
548extern status_t
549 json_wr_check_file (const xmlChar *filespec,
550 val_value_t *val,
551 int32 startindent,
552 int32 indent,
553 val_nodetest_fn_t testfn);
554
555
556
568extern status_t
569 json_wr_check_file2 (const xmlChar *filespec,
570 val_value_t *val,
571 int32 startindent,
572 int32 indent,
573 val_nodetest_fn_t testfn,
574 boolean modnames);
575
576
586extern status_t
587 json_wr_file (const xmlChar *filespec,
588 val_value_t *val,
589 int32 startindent,
590 int32 indent);
591
602extern status_t
603 json_wr_file2 (const xmlChar *filespec,
604 val_value_t *val,
605 int32 startindent,
606 int32 indent,
607 boolean modnames);
608
609
617extern void
618 json_wr_output_null (ses_cb_t *scb,
619 int32 startindent);
620
621
637extern void
638 json_wr_check_child_obj (ses_cb_t *scb,
639 xml_msg_hdr_t *msg,
640 val_value_t *val,
641 obj_template_t *objnode,
642 int32 indent,
643 val_nodetest_fn_t testfn,
644 boolean isfirst,
645 boolean isfirstchild);
646
647
663extern void
664 json_wr_check_child_obj_ex (ses_cb_t *scb,
665 xml_msg_hdr_t *msg,
666 getcb_get2_t *parent_get2cb,
667 obj_template_t *objnode,
668 int32 indent,
669 val_nodetest_fn_t testfn,
670 boolean isfirst,
671 boolean isfirstchild);
672
673
677#ifdef __cplusplus
678} /* end extern 'C' */
679#endif
680
681#endif /* _H_json_wr */
getcb.h
GET1 and GET2 Callback Support.
json_wr_file2
status_t json_wr_file2(const xmlChar *filespec, val_value_t *val, int32 startindent, int32 indent, boolean modnames)
Write the specified value to a FILE in JSON format.
Definition: json_wr.c:3126
json_wr_check_open_file2
status_t json_wr_check_open_file2(FILE *fp, val_value_t *val, int32 startindent, int32 indent, val_nodetest_fn_t testfn, boolean modnames)
Write the specified value to an open FILE in JSON format Allow JSON or JSON-IETF format.
Definition: json_wr.c:2927
json_wr_start_array_obj
void json_wr_start_array_obj(ses_cb_t *scb, xml_msg_hdr_t *msg, const xmlChar *modname, const xmlChar *name, obj_template_t *obj, int32 startindent, boolean startbrace, boolean startbracket)
generate start of a JSON array; use OBJ to check the modname
Definition: json_wr.c:1765
json_wr_full_check_val_force
status_t json_wr_full_check_val_force(ses_cb_t *scb, xml_msg_hdr_t *msg, xmlns_id_t parent_nsid, val_value_t *val, int32 startindent, val_nodetest_fn_t testfn, xmlns_id_t force_nsid, const xmlChar *force_name)
generate entire val_value_t *w/filter)
Definition: json_wr.c:2851
json_wr_end_array
void json_wr_end_array(ses_cb_t *scb, xml_msg_hdr_t *msg, int32 startindent)
generate end of a JSON array
Definition: json_wr.c:1897
json_wr_max_check_val_force
status_t json_wr_max_check_val_force(ses_cb_t *scb, xml_msg_hdr_t *msg, xmlns_id_t parent_nsid, val_value_t *val, int32 startindent, val_nodetest_fn_t testfn, boolean isfirst, boolean islast, boolean isfirstchild, boolean isfirstsibling, boolean force_lastsibling, boolean force_lastsib_value, boolean force_array_obj, xmlns_id_t force_nsid, const xmlChar *force_name)
generate entire val_value_t *w/filter)
Definition: json_wr.c:2143
json_wr_start_array
void json_wr_start_array(ses_cb_t *scb, xml_msg_hdr_t *msg, int32 startindent)
generate start of a JSON array
Definition: json_wr.c:1728
json_wr_check_child_obj_ex
void json_wr_check_child_obj_ex(ses_cb_t *scb, xml_msg_hdr_t *msg, getcb_get2_t *parent_get2cb, obj_template_t *objnode, int32 indent, val_nodetest_fn_t testfn, boolean isfirst, boolean isfirstchild)
generate entire val_value_t *w/filter) (extended version)
Definition: json_wr.c:3272
json_wr_tag_t
json_wr_tag_t
type parser used in 3 separate modes
Definition: json_wr.h:88
json_wr_start_object_ex
void json_wr_start_object_ex(ses_cb_t *scb, xml_msg_hdr_t *msg, const xmlChar *modname, const xmlChar *name, int32 startindent, boolean startbrace, boolean endbrace)
generate start of a JSON object (extended version)
Definition: json_wr.c:1517
json_wr_simval_line2
void json_wr_simval_line2(ses_cb_t *scb, xml_msg_hdr_t *msg, const xmlChar *modname, const xmlChar *namestr, const xmlChar *valstr, ncx_btype_t btyp, int32 startindent, boolean isfirst)
generate 1 line for a simple value within a container or array
Definition: json_wr.c:1935
json_wr_check_file2
status_t json_wr_check_file2(const xmlChar *filespec, val_value_t *val, int32 startindent, int32 indent, val_nodetest_fn_t testfn, boolean modnames)
Write the specified value to a FILE in JSON format.
Definition: json_wr.c:3048
json_wr_start_object_obj
void json_wr_start_object_obj(ses_cb_t *scb, xml_msg_hdr_t *msg, const xmlChar *modname, const xmlChar *name, obj_template_t *obj, int32 startindent)
generate start of a JSON object based on val value tree; use OBJ to check the modname
Definition: json_wr.c:1644
json_wr_start_object
void json_wr_start_object(ses_cb_t *scb, xml_msg_hdr_t *msg, const xmlChar *modname, const xmlChar *name, int32 startindent)
generate start of a JSON object
Definition: json_wr.c:1465
json_wr_check_open_file
status_t json_wr_check_open_file(FILE *fp, val_value_t *val, int32 startindent, int32 indent, val_nodetest_fn_t testfn)
Write the specified value to an open FILE in JSON format.
Definition: json_wr.c:2896
json_wr_full_check_val
status_t json_wr_full_check_val(ses_cb_t *scb, xml_msg_hdr_t *msg, xmlns_id_t parent_nsid, val_value_t *val, int32 startindent, val_nodetest_fn_t testfn)
generate entire val_value_t *w/filter)
Definition: json_wr.c:2806
json_wr_start_array_val
void json_wr_start_array_val(ses_cb_t *scb, xml_msg_hdr_t *msg, val_value_t *val, int32 startindent, boolean startbrace, boolean startbracket)
generate start of a JSON array; use value node
Definition: json_wr.c:1833
json_wr_check_file
status_t json_wr_check_file(const xmlChar *filespec, val_value_t *val, int32 startindent, int32 indent, val_nodetest_fn_t testfn)
Write the specified value to a FILE in JSON format.
Definition: json_wr.c:3016
json_wr_file
status_t json_wr_file(const xmlChar *filespec, val_value_t *val, int32 startindent, int32 indent)
Write the specified value to a FILE in JSON format.
Definition: json_wr.c:3095
json_wr_start_object_val
void json_wr_start_object_val(ses_cb_t *scb, xml_msg_hdr_t *msg, val_value_t *val, int32 startindent)
generate start of a JSON object based on val value tree
Definition: json_wr.c:1580
json_wr_simval_line
void json_wr_simval_line(ses_cb_t *scb, xml_msg_hdr_t *msg, xmlns_id_t nsid, const xmlChar *namestr, const xmlChar *valstr, ncx_btype_t btyp, int32 startindent, boolean isfirst)
generate 1 line for a simple value within a container or array
Definition: json_wr.c:2016
json_wr_check_child_obj
void json_wr_check_child_obj(ses_cb_t *scb, xml_msg_hdr_t *msg, val_value_t *val, obj_template_t *objnode, int32 indent, val_nodetest_fn_t testfn, boolean isfirst, boolean isfirstchild)
generate entire val_value_t *w/filter)
Definition: json_wr.c:3187
json_wr_output_null
void json_wr_output_null(ses_cb_t *scb, int32 startindent)
generate a null value; needed for printing empty <data> element which is done as a wrapper,...
Definition: json_wr.c:3153
json_wr_max_check_val
status_t json_wr_max_check_val(ses_cb_t *scb, xml_msg_hdr_t *msg, xmlns_id_t parent_nsid, val_value_t *val, int32 startindent, val_nodetest_fn_t testfn, boolean isfirst, boolean islast, boolean isfirstchild, boolean isfirstsibling, boolean force_lastsibling, boolean force_lastsib_value, boolean force_array_obj)
generate entire val_value_t *w/filter)
Definition: json_wr.c:2072
json_wr_end_object
void json_wr_end_object(ses_cb_t *scb, xml_msg_hdr_t *msg, int32 startindent)
generate end of a JSON object
Definition: json_wr.c:1699
val_nodetest_fn_t
boolean(* val_nodetest_fn_t)(xml_msg_hdr_t *mhdr, ncx_withdefaults_t withdef, boolean realtest, val_value_t *node)
user function callback template to test output of a specified node.
Definition: val_util.h:132
status_t
status_t
global error return code
Definition: status_enum.h:219
xmlns_id_t
uint16 xmlns_id_t
integer handle for registered namespaces
Definition: xmlns.h:89
ncx_btype_t
ncx_btype_t
enumeration of the built-in NCX types These types cannot be overridden and cannot be imported
Definition: ncxtypes.h:213
ses.h
NETCONF Session Common definitions module.
status.h
Global error messages for status code enumerations.
getcb_get2_t
GET2 control block.
Definition: getcb.h:360
json_walker_cookie_t
JSON walker function for GET2 support.
Definition: json_wr.h:96
json_walker_cookie_t::isfirst
boolean isfirst
the first call has been done
Definition: json_wr.h:116
json_walker_cookie_t::isfirstchild
boolean isfirstchild
the first child node call has been done
Definition: json_wr.h:119
json_walker_cookie_t::indent
int32 indent
indent amount
Definition: json_wr.h:104
json_walker_cookie_t::testfn
val_nodetest_fn_t testfn
test function to skip or include the YANG data node
Definition: json_wr.h:107
json_walker_cookie_t::list_failed
boolean list_failed
Set to true if the list callback failed, so forcing the end of the array processing,...
Definition: json_wr.h:127
json_walker_cookie_t::scb
ses_cb_t * scb
backptr to session control block to use for output
Definition: json_wr.h:98
json_walker_cookie_t::maxmode
boolean maxmode
flag to indicate max-depth already reached
Definition: json_wr.h:113
json_walker_cookie_t::expand_varexpr
boolean expand_varexpr
expand yangcli variable expressions if found
Definition: json_wr.h:110
json_walker_cookie_t::msg
xml_msg_hdr_t * msg
back-ptr to message header in progress
Definition: json_wr.h:101
obj_template_t
One YANG data-def-stmt.
Definition: obj.h:1284
ses_cb_t
Session Control Block.
Definition: ses.h:759
val_value_t
one value to match one type
Definition: val.h:962
xml_msg_hdr_t
Common Encoding Message Header No longer XML specific!! Used by JSON and CBOR parsing as well!...
Definition: xml_msg.h:436
val.h
Value Node Basic Support.
val_util.h
Value Node Utilities.