2009-11-11 10:39:23 -06:00
|
|
|
/*
|
2018-08-23 18:40:20 +02:00
|
|
|
* JSON Parser
|
2009-11-11 10:39:23 -06:00
|
|
|
*
|
|
|
|
|
* Copyright IBM, Corp. 2009
|
|
|
|
|
*
|
|
|
|
|
* Authors:
|
|
|
|
|
* Anthony Liguori <aliguori@us.ibm.com>
|
|
|
|
|
*
|
|
|
|
|
* This work is licensed under the terms of the GNU LGPL, version 2.1 or later.
|
|
|
|
|
* See the COPYING.LIB file in the top-level directory.
|
|
|
|
|
*
|
|
|
|
|
*/
|
|
|
|
|
|
2018-08-23 18:40:20 +02:00
|
|
|
#ifndef QAPI_QMP_JSON_PARSER_H
|
|
|
|
|
#define QAPI_QMP_JSON_PARSER_H
|
2009-11-11 10:39:23 -06:00
|
|
|
|
2018-08-23 18:40:20 +02:00
|
|
|
typedef struct JSONLexer {
|
|
|
|
|
int start_state, state;
|
|
|
|
|
GString *token;
|
2026-06-26 12:17:26 +02:00
|
|
|
int cur_x, cur_y;
|
2018-08-23 18:40:20 +02:00
|
|
|
int x, y;
|
|
|
|
|
} JSONLexer;
|
2009-11-11 10:39:23 -06:00
|
|
|
|
2026-06-26 12:17:21 +02:00
|
|
|
typedef struct JSONParserContext {
|
|
|
|
|
Error *err;
|
|
|
|
|
GQueue *stack;
|
|
|
|
|
va_list *ap;
|
|
|
|
|
} JSONParserContext;
|
|
|
|
|
|
2018-08-23 18:40:20 +02:00
|
|
|
typedef struct JSONMessageParser {
|
|
|
|
|
void (*emit)(void *opaque, QObject *json, Error *err);
|
|
|
|
|
void *opaque;
|
|
|
|
|
JSONLexer lexer;
|
2026-06-26 12:17:22 +02:00
|
|
|
JSONParserContext parser;
|
2026-06-26 12:17:23 +02:00
|
|
|
unsigned int brace_count;
|
|
|
|
|
unsigned int bracket_count;
|
json-streamer: remove token queue
Now fully exploit the push parser, feeding it one token at a time
without having to wait until braces and brackets are balanced.
While the nesting counts are retained for error recovery purposes,
the system can now report the first parsing error without waiting
for parentheses to be balanced. This also means that JSON_ERROR
can be handled in json-parser.c, not json-streamer.c.
After reporting the error, json-streamer.c then enters an error recovery
mode where subsequent errors are suppressed. This mimics the previous
error reporting behavior, but it provides prompt feedback on parsing
errors. As an example, here is an example interaction with qemu-ga.
BEFORE (error reported only once braces are balanced):
>> {"execute":foo
>> }
<< {"error": {"class": "GenericError", "desc": "JSON parse error, invalid keyword 'foo'"}}
>> {"execute":"somecommand"}
<< {"error": {"class": "CommandNotFound", "desc": "The command somecommand has not been found"}}
AFTER (error reported immediately, but similar error recovery as before):
>> {"execute":foo
<< {"error": {"class": "GenericError", "desc": "JSON parse error, invalid keyword 'foo'"}}
>> }
>> {"execute":"somecommand"}
<< {"error": {"class": "CommandNotFound", "desc": "The command somecommand has not been found"}}
Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
Message-ID: <20260626101727.1727389-5-pbonzini@redhat.com>
Reviewed-by: Markus Armbruster <armbru@redhat.com>
[Token size limit check off-by-one fixed]
Signed-off-by: Markus Armbruster <armbru@redhat.com>
2026-06-26 12:17:24 +02:00
|
|
|
unsigned int token_count;
|
|
|
|
|
bool error;
|
2018-08-23 18:40:20 +02:00
|
|
|
uint64_t token_size;
|
|
|
|
|
} JSONMessageParser;
|
2018-08-23 18:40:18 +02:00
|
|
|
|
2018-08-23 18:40:20 +02:00
|
|
|
void json_message_parser_init(JSONMessageParser *parser,
|
|
|
|
|
void (*emit)(void *opaque, QObject *json,
|
|
|
|
|
Error *err),
|
|
|
|
|
void *opaque, va_list *ap);
|
|
|
|
|
|
|
|
|
|
void json_message_parser_feed(JSONMessageParser *parser,
|
|
|
|
|
const char *buffer, size_t size);
|
|
|
|
|
|
|
|
|
|
void json_message_parser_flush(JSONMessageParser *parser);
|
|
|
|
|
|
|
|
|
|
void json_message_parser_destroy(JSONMessageParser *parser);
|
2009-11-11 10:39:23 -06:00
|
|
|
|
|
|
|
|
#endif
|