]> git.ipfire.org Git - thirdparty/postgresql.git/commitdiff
Split JSON lexer/parser from 'json' data type support.
authorRobert Haas <rhaas@postgresql.org>
Fri, 24 Jan 2020 18:17:43 +0000 (10:17 -0800)
committerRobert Haas <rhaas@postgresql.org>
Fri, 24 Jan 2020 18:17:43 +0000 (10:17 -0800)
Keep the code that pertains to the 'json' data type in json.c, but
move the lexing and parsing code to a new file jsonapi.c, a name
I chose because the corresponding prototypes are in jsonapi.h.

This seems like a logical division, because the JSON lexer and parser
are also used by the 'jsonb' data type, but the SQL-callable functions
in json.c are a separate thing. Also, the new jsonapi.c file needs to
include far fewer header files than json.c, which seems like a good
sign that this is an appropriate place to insert an abstraction
boundary. I took the opportunity to remove a few apparently-unneeded
includes from json.c at the same time.

Patch by me, reviewed by David Steele, Mark Dilger, and Andrew
Dunstan. The previous commit was, too, but I forgot to note it
in the commit message.

Discussion: http://postgr.es/m/CA+TgmoYfOXhd27MUDGioVh6QtpD0C1K-f6ObSA10AWiHBAL5bA@mail.gmail.com

src/backend/utils/adt/Makefile
src/backend/utils/adt/json.c
src/backend/utils/adt/jsonapi.c [new file with mode: 0644]
src/include/utils/jsonapi.h

index 13efa9338c165f32e90621d2636c04388df01fc3..790d7a24fb84568040b3ab8bfb41dccb8d36b89b 100644 (file)
@@ -44,6 +44,7 @@ OBJS = \
        int.o \
        int8.o \
        json.o \
+       jsonapi.o \
        jsonb.o \
        jsonb_gin.o \
        jsonb_op.o \
index 458505abfd88358da1d5c864583ad0904a11a9a2..4be16b5c201a32ca4a316d8487a3b2479034bc32 100644 (file)
  */
 #include "postgres.h"
 
-#include "access/htup_details.h"
-#include "access/transam.h"
 #include "catalog/pg_type.h"
-#include "executor/spi.h"
 #include "funcapi.h"
-#include "lib/stringinfo.h"
 #include "libpq/pqformat.h"
-#include "mb/pg_wchar.h"
 #include "miscadmin.h"
 #include "parser/parse_coerce.h"
 #include "utils/array.h"
 #include "utils/json.h"
 #include "utils/jsonapi.h"
 #include "utils/lsyscache.h"
-#include "utils/syscache.h"
 #include "utils/typcache.h"
 
-/*
- * The context of the parser is maintained by the recursive descent
- * mechanism, but is passed explicitly to the error reporting routine
- * for better diagnostics.
- */
-typedef enum                                   /* contexts of JSON parser */
-{
-       JSON_PARSE_VALUE,                       /* expecting a value */
-       JSON_PARSE_STRING,                      /* expecting a string (for a field name) */
-       JSON_PARSE_ARRAY_START,         /* saw '[', expecting value or ']' */
-       JSON_PARSE_ARRAY_NEXT,          /* saw array element, expecting ',' or ']' */
-       JSON_PARSE_OBJECT_START,        /* saw '{', expecting label or '}' */
-       JSON_PARSE_OBJECT_LABEL,        /* saw object label, expecting ':' */
-       JSON_PARSE_OBJECT_NEXT,         /* saw object value, expecting ',' or '}' */
-       JSON_PARSE_OBJECT_COMMA,        /* saw object ',', expecting next label */
-       JSON_PARSE_END                          /* saw the end of a document, expect nothing */
-} JsonParseContext;
-
 typedef enum                                   /* type categories for datum_to_json */
 {
        JSONTYPE_NULL,                          /* null, so we didn't bother to identify */
@@ -75,19 +51,6 @@ typedef struct JsonAggState
        Oid                     val_output_func;
 } JsonAggState;
 
-static inline void json_lex(JsonLexContext *lex);
-static inline void json_lex_string(JsonLexContext *lex);
-static inline void json_lex_number(JsonLexContext *lex, char *s,
-                                                                  bool *num_err, int *total_len);
-static inline void parse_scalar(JsonLexContext *lex, JsonSemAction *sem);
-static void parse_object_field(JsonLexContext *lex, JsonSemAction *sem);
-static void parse_object(JsonLexContext *lex, JsonSemAction *sem);
-static void parse_array_element(JsonLexContext *lex, JsonSemAction *sem);
-static void parse_array(JsonLexContext *lex, JsonSemAction *sem);
-static void report_parse_error(JsonParseContext ctx, JsonLexContext *lex) pg_attribute_noreturn();
-static void report_invalid_token(JsonLexContext *lex) pg_attribute_noreturn();
-static int     report_json_context(JsonLexContext *lex);
-static char *extract_mb_char(char *s);
 static void composite_to_json(Datum composite, StringInfo result,
                                                          bool use_line_feeds);
 static void array_dim_to_json(StringInfo result, int dim, int ndims, int *dims,
@@ -106,121 +69,6 @@ static void add_json(Datum val, bool is_null, StringInfo result,
                                         Oid val_type, bool key_scalar);
 static text *catenate_stringinfo_string(StringInfo buffer, const char *addon);
 
-/* the null action object used for pure validation */
-static JsonSemAction nullSemAction =
-{
-       NULL, NULL, NULL, NULL, NULL,
-       NULL, NULL, NULL, NULL, NULL
-};
-
-/* Recursive Descent parser support routines */
-
-/*
- * lex_peek
- *
- * what is the current look_ahead token?
-*/
-static inline JsonTokenType
-lex_peek(JsonLexContext *lex)
-{
-       return lex->token_type;
-}
-
-/*
- * lex_accept
- *
- * accept the look_ahead token and move the lexer to the next token if the
- * look_ahead token matches the token parameter. In that case, and if required,
- * also hand back the de-escaped lexeme.
- *
- * returns true if the token matched, false otherwise.
- */
-static inline bool
-lex_accept(JsonLexContext *lex, JsonTokenType token, char **lexeme)
-{
-       if (lex->token_type == token)
-       {
-               if (lexeme != NULL)
-               {
-                       if (lex->token_type == JSON_TOKEN_STRING)
-                       {
-                               if (lex->strval != NULL)
-                                       *lexeme = pstrdup(lex->strval->data);
-                       }
-                       else
-                       {
-                               int                     len = (lex->token_terminator - lex->token_start);
-                               char       *tokstr = palloc(len + 1);
-
-                               memcpy(tokstr, lex->token_start, len);
-                               tokstr[len] = '\0';
-                               *lexeme = tokstr;
-                       }
-               }
-               json_lex(lex);
-               return true;
-       }
-       return false;
-}
-
-/*
- * lex_accept
- *
- * move the lexer to the next token if the current look_ahead token matches
- * the parameter token. Otherwise, report an error.
- */
-static inline void
-lex_expect(JsonParseContext ctx, JsonLexContext *lex, JsonTokenType token)
-{
-       if (!lex_accept(lex, token, NULL))
-               report_parse_error(ctx, lex);
-}
-
-/* chars to consider as part of an alphanumeric token */
-#define JSON_ALPHANUMERIC_CHAR(c)  \
-       (((c) >= 'a' && (c) <= 'z') || \
-        ((c) >= 'A' && (c) <= 'Z') || \
-        ((c) >= '0' && (c) <= '9') || \
-        (c) == '_' || \
-        IS_HIGHBIT_SET(c))
-
-/*
- * Utility function to check if a string is a valid JSON number.
- *
- * str is of length len, and need not be null-terminated.
- */
-bool
-IsValidJsonNumber(const char *str, int len)
-{
-       bool            numeric_error;
-       int                     total_len;
-       JsonLexContext dummy_lex;
-
-       if (len <= 0)
-               return false;
-
-       /*
-        * json_lex_number expects a leading  '-' to have been eaten already.
-        *
-        * having to cast away the constness of str is ugly, but there's not much
-        * easy alternative.
-        */
-       if (*str == '-')
-       {
-               dummy_lex.input = unconstify(char *, str) +1;
-               dummy_lex.input_length = len - 1;
-       }
-       else
-       {
-               dummy_lex.input = unconstify(char *, str);
-               dummy_lex.input_length = len;
-       }
-
-       json_lex_number(&dummy_lex, dummy_lex.input, &numeric_error, &total_len);
-
-       return (!numeric_error) && (total_len == dummy_lex.input_length);
-}
-
 /*
  * Input.
  */
@@ -285,1058 +133,6 @@ json_recv(PG_FUNCTION_ARGS)
        PG_RETURN_TEXT_P(cstring_to_text_with_len(str, nbytes));
 }
 
-/*
- * makeJsonLexContext
- *
- * lex constructor, with or without StringInfo object
- * for de-escaped lexemes.
- *
- * Without is better as it makes the processing faster, so only make one
- * if really required.
- *
- * If you already have the json as a text* value, use the first of these
- * functions, otherwise use  makeJsonLexContextCstringLen().
- */
-JsonLexContext *
-makeJsonLexContext(text *json, bool need_escapes)
-{
-       return makeJsonLexContextCstringLen(VARDATA_ANY(json),
-                                                                               VARSIZE_ANY_EXHDR(json),
-                                                                               need_escapes);
-}
-
-JsonLexContext *
-makeJsonLexContextCstringLen(char *json, int len, bool need_escapes)
-{
-       JsonLexContext *lex = palloc0(sizeof(JsonLexContext));
-
-       lex->input = lex->token_terminator = lex->line_start = json;
-       lex->line_number = 1;
-       lex->input_length = len;
-       if (need_escapes)
-               lex->strval = makeStringInfo();
-       return lex;
-}
-
-/*
- * pg_parse_json
- *
- * Publicly visible entry point for the JSON parser.
- *
- * lex is a lexing context, set up for the json to be processed by calling
- * makeJsonLexContext(). sem is a structure of function pointers to semantic
- * action routines to be called at appropriate spots during parsing, and a
- * pointer to a state object to be passed to those routines.
- */
-void
-pg_parse_json(JsonLexContext *lex, JsonSemAction *sem)
-{
-       JsonTokenType tok;
-
-       /* get the initial token */
-       json_lex(lex);
-
-       tok = lex_peek(lex);
-
-       /* parse by recursive descent */
-       switch (tok)
-       {
-               case JSON_TOKEN_OBJECT_START:
-                       parse_object(lex, sem);
-                       break;
-               case JSON_TOKEN_ARRAY_START:
-                       parse_array(lex, sem);
-                       break;
-               default:
-                       parse_scalar(lex, sem); /* json can be a bare scalar */
-       }
-
-       lex_expect(JSON_PARSE_END, lex, JSON_TOKEN_END);
-
-}
-
-/*
- * json_count_array_elements
- *
- * Returns number of array elements in lex context at start of array token
- * until end of array token at same nesting level.
- *
- * Designed to be called from array_start routines.
- */
-int
-json_count_array_elements(JsonLexContext *lex)
-{
-       JsonLexContext copylex;
-       int                     count;
-
-       /*
-        * It's safe to do this with a shallow copy because the lexical routines
-        * don't scribble on the input. They do scribble on the other pointers
-        * etc, so doing this with a copy makes that safe.
-        */
-       memcpy(&copylex, lex, sizeof(JsonLexContext));
-       copylex.strval = NULL;          /* not interested in values here */
-       copylex.lex_level++;
-
-       count = 0;
-       lex_expect(JSON_PARSE_ARRAY_START, &copylex, JSON_TOKEN_ARRAY_START);
-       if (lex_peek(&copylex) != JSON_TOKEN_ARRAY_END)
-       {
-               do
-               {
-                       count++;
-                       parse_array_element(&copylex, &nullSemAction);
-               }
-               while (lex_accept(&copylex, JSON_TOKEN_COMMA, NULL));
-       }
-       lex_expect(JSON_PARSE_ARRAY_NEXT, &copylex, JSON_TOKEN_ARRAY_END);
-
-       return count;
-}
-
-/*
- *     Recursive Descent parse routines. There is one for each structural
- *     element in a json document:
- *       - scalar (string, number, true, false, null)
- *       - array  ( [ ] )
- *       - array element
- *       - object ( { } )
- *       - object field
- */
-static inline void
-parse_scalar(JsonLexContext *lex, JsonSemAction *sem)
-{
-       char       *val = NULL;
-       json_scalar_action sfunc = sem->scalar;
-       char      **valaddr;
-       JsonTokenType tok = lex_peek(lex);
-
-       valaddr = sfunc == NULL ? NULL : &val;
-
-       /* a scalar must be a string, a number, true, false, or null */
-       switch (tok)
-       {
-               case JSON_TOKEN_TRUE:
-                       lex_accept(lex, JSON_TOKEN_TRUE, valaddr);
-                       break;
-               case JSON_TOKEN_FALSE:
-                       lex_accept(lex, JSON_TOKEN_FALSE, valaddr);
-                       break;
-               case JSON_TOKEN_NULL:
-                       lex_accept(lex, JSON_TOKEN_NULL, valaddr);
-                       break;
-               case JSON_TOKEN_NUMBER:
-                       lex_accept(lex, JSON_TOKEN_NUMBER, valaddr);
-                       break;
-               case JSON_TOKEN_STRING:
-                       lex_accept(lex, JSON_TOKEN_STRING, valaddr);
-                       break;
-               default:
-                       report_parse_error(JSON_PARSE_VALUE, lex);
-       }
-
-       if (sfunc != NULL)
-               (*sfunc) (sem->semstate, val, tok);
-}
-
-static void
-parse_object_field(JsonLexContext *lex, JsonSemAction *sem)
-{
-       /*
-        * An object field is "fieldname" : value where value can be a scalar,
-        * object or array.  Note: in user-facing docs and error messages, we
-        * generally call a field name a "key".
-        */
-
-       char       *fname = NULL;       /* keep compiler quiet */
-       json_ofield_action ostart = sem->object_field_start;
-       json_ofield_action oend = sem->object_field_end;
-       bool            isnull;
-       char      **fnameaddr = NULL;
-       JsonTokenType tok;
-
-       if (ostart != NULL || oend != NULL)
-               fnameaddr = &fname;
-
-       if (!lex_accept(lex, JSON_TOKEN_STRING, fnameaddr))
-               report_parse_error(JSON_PARSE_STRING, lex);
-
-       lex_expect(JSON_PARSE_OBJECT_LABEL, lex, JSON_TOKEN_COLON);
-
-       tok = lex_peek(lex);
-       isnull = tok == JSON_TOKEN_NULL;
-
-       if (ostart != NULL)
-               (*ostart) (sem->semstate, fname, isnull);
-
-       switch (tok)
-       {
-               case JSON_TOKEN_OBJECT_START:
-                       parse_object(lex, sem);
-                       break;
-               case JSON_TOKEN_ARRAY_START:
-                       parse_array(lex, sem);
-                       break;
-               default:
-                       parse_scalar(lex, sem);
-       }
-
-       if (oend != NULL)
-               (*oend) (sem->semstate, fname, isnull);
-}
-
-static void
-parse_object(JsonLexContext *lex, JsonSemAction *sem)
-{
-       /*
-        * an object is a possibly empty sequence of object fields, separated by
-        * commas and surrounded by curly braces.
-        */
-       json_struct_action ostart = sem->object_start;
-       json_struct_action oend = sem->object_end;
-       JsonTokenType tok;
-
-       check_stack_depth();
-
-       if (ostart != NULL)
-               (*ostart) (sem->semstate);
-
-       /*
-        * Data inside an object is at a higher nesting level than the object
-        * itself. Note that we increment this after we call the semantic routine
-        * for the object start and restore it before we call the routine for the
-        * object end.
-        */
-       lex->lex_level++;
-
-       /* we know this will succeed, just clearing the token */
-       lex_expect(JSON_PARSE_OBJECT_START, lex, JSON_TOKEN_OBJECT_START);
-
-       tok = lex_peek(lex);
-       switch (tok)
-       {
-               case JSON_TOKEN_STRING:
-                       parse_object_field(lex, sem);
-                       while (lex_accept(lex, JSON_TOKEN_COMMA, NULL))
-                               parse_object_field(lex, sem);
-                       break;
-               case JSON_TOKEN_OBJECT_END:
-                       break;
-               default:
-                       /* case of an invalid initial token inside the object */
-                       report_parse_error(JSON_PARSE_OBJECT_START, lex);
-       }
-
-       lex_expect(JSON_PARSE_OBJECT_NEXT, lex, JSON_TOKEN_OBJECT_END);
-
-       lex->lex_level--;
-
-       if (oend != NULL)
-               (*oend) (sem->semstate);
-}
-
-static void
-parse_array_element(JsonLexContext *lex, JsonSemAction *sem)
-{
-       json_aelem_action astart = sem->array_element_start;
-       json_aelem_action aend = sem->array_element_end;
-       JsonTokenType tok = lex_peek(lex);
-
-       bool            isnull;
-
-       isnull = tok == JSON_TOKEN_NULL;
-
-       if (astart != NULL)
-               (*astart) (sem->semstate, isnull);
-
-       /* an array element is any object, array or scalar */
-       switch (tok)
-       {
-               case JSON_TOKEN_OBJECT_START:
-                       parse_object(lex, sem);
-                       break;
-               case JSON_TOKEN_ARRAY_START:
-                       parse_array(lex, sem);
-                       break;
-               default:
-                       parse_scalar(lex, sem);
-       }
-
-       if (aend != NULL)
-               (*aend) (sem->semstate, isnull);
-}
-
-static void
-parse_array(JsonLexContext *lex, JsonSemAction *sem)
-{
-       /*
-        * an array is a possibly empty sequence of array elements, separated by
-        * commas and surrounded by square brackets.
-        */
-       json_struct_action astart = sem->array_start;
-       json_struct_action aend = sem->array_end;
-
-       check_stack_depth();
-
-       if (astart != NULL)
-               (*astart) (sem->semstate);
-
-       /*
-        * Data inside an array is at a higher nesting level than the array
-        * itself. Note that we increment this after we call the semantic routine
-        * for the array start and restore it before we call the routine for the
-        * array end.
-        */
-       lex->lex_level++;
-
-       lex_expect(JSON_PARSE_ARRAY_START, lex, JSON_TOKEN_ARRAY_START);
-       if (lex_peek(lex) != JSON_TOKEN_ARRAY_END)
-       {
-
-               parse_array_element(lex, sem);
-
-               while (lex_accept(lex, JSON_TOKEN_COMMA, NULL))
-                       parse_array_element(lex, sem);
-       }
-
-       lex_expect(JSON_PARSE_ARRAY_NEXT, lex, JSON_TOKEN_ARRAY_END);
-
-       lex->lex_level--;
-
-       if (aend != NULL)
-               (*aend) (sem->semstate);
-}
-
-/*
- * Lex one token from the input stream.
- */
-static inline void
-json_lex(JsonLexContext *lex)
-{
-       char       *s;
-       int                     len;
-
-       /* Skip leading whitespace. */
-       s = lex->token_terminator;
-       len = s - lex->input;
-       while (len < lex->input_length &&
-                  (*s == ' ' || *s == '\t' || *s == '\n' || *s == '\r'))
-       {
-               if (*s == '\n')
-                       ++lex->line_number;
-               ++s;
-               ++len;
-       }
-       lex->token_start = s;
-
-       /* Determine token type. */
-       if (len >= lex->input_length)
-       {
-               lex->token_start = NULL;
-               lex->prev_token_terminator = lex->token_terminator;
-               lex->token_terminator = s;
-               lex->token_type = JSON_TOKEN_END;
-       }
-       else
-               switch (*s)
-               {
-                               /* Single-character token, some kind of punctuation mark. */
-                       case '{':
-                               lex->prev_token_terminator = lex->token_terminator;
-                               lex->token_terminator = s + 1;
-                               lex->token_type = JSON_TOKEN_OBJECT_START;
-                               break;
-                       case '}':
-                               lex->prev_token_terminator = lex->token_terminator;
-                               lex->token_terminator = s + 1;
-                               lex->token_type = JSON_TOKEN_OBJECT_END;
-                               break;
-                       case '[':
-                               lex->prev_token_terminator = lex->token_terminator;
-                               lex->token_terminator = s + 1;
-                               lex->token_type = JSON_TOKEN_ARRAY_START;
-                               break;
-                       case ']':
-                               lex->prev_token_terminator = lex->token_terminator;
-                               lex->token_terminator = s + 1;
-                               lex->token_type = JSON_TOKEN_ARRAY_END;
-                               break;
-                       case ',':
-                               lex->prev_token_terminator = lex->token_terminator;
-                               lex->token_terminator = s + 1;
-                               lex->token_type = JSON_TOKEN_COMMA;
-                               break;
-                       case ':':
-                               lex->prev_token_terminator = lex->token_terminator;
-                               lex->token_terminator = s + 1;
-                               lex->token_type = JSON_TOKEN_COLON;
-                               break;
-                       case '"':
-                               /* string */
-                               json_lex_string(lex);
-                               lex->token_type = JSON_TOKEN_STRING;
-                               break;
-                       case '-':
-                               /* Negative number. */
-                               json_lex_number(lex, s + 1, NULL, NULL);
-                               lex->token_type = JSON_TOKEN_NUMBER;
-                               break;
-                       case '0':
-                       case '1':
-                       case '2':
-                       case '3':
-                       case '4':
-                       case '5':
-                       case '6':
-                       case '7':
-                       case '8':
-                       case '9':
-                               /* Positive number. */
-                               json_lex_number(lex, s, NULL, NULL);
-                               lex->token_type = JSON_TOKEN_NUMBER;
-                               break;
-                       default:
-                               {
-                                       char       *p;
-
-                                       /*
-                                        * We're not dealing with a string, number, legal
-                                        * punctuation mark, or end of string.  The only legal
-                                        * tokens we might find here are true, false, and null,
-                                        * but for error reporting purposes we scan until we see a
-                                        * non-alphanumeric character.  That way, we can report
-                                        * the whole word as an unexpected token, rather than just
-                                        * some unintuitive prefix thereof.
-                                        */
-                                       for (p = s; p - s < lex->input_length - len && JSON_ALPHANUMERIC_CHAR(*p); p++)
-                                                /* skip */ ;
-
-                                       /*
-                                        * We got some sort of unexpected punctuation or an
-                                        * otherwise unexpected character, so just complain about
-                                        * that one character.
-                                        */
-                                       if (p == s)
-                                       {
-                                               lex->prev_token_terminator = lex->token_terminator;
-                                               lex->token_terminator = s + 1;
-                                               report_invalid_token(lex);
-                                       }
-
-                                       /*
-                                        * We've got a real alphanumeric token here.  If it
-                                        * happens to be true, false, or null, all is well.  If
-                                        * not, error out.
-                                        */
-                                       lex->prev_token_terminator = lex->token_terminator;
-                                       lex->token_terminator = p;
-                                       if (p - s == 4)
-                                       {
-                                               if (memcmp(s, "true", 4) == 0)
-                                                       lex->token_type = JSON_TOKEN_TRUE;
-                                               else if (memcmp(s, "null", 4) == 0)
-                                                       lex->token_type = JSON_TOKEN_NULL;
-                                               else
-                                                       report_invalid_token(lex);
-                                       }
-                                       else if (p - s == 5 && memcmp(s, "false", 5) == 0)
-                                               lex->token_type = JSON_TOKEN_FALSE;
-                                       else
-                                               report_invalid_token(lex);
-
-                               }
-               }                                               /* end of switch */
-}
-
-/*
- * The next token in the input stream is known to be a string; lex it.
- */
-static inline void
-json_lex_string(JsonLexContext *lex)
-{
-       char       *s;
-       int                     len;
-       int                     hi_surrogate = -1;
-
-       if (lex->strval != NULL)
-               resetStringInfo(lex->strval);
-
-       Assert(lex->input_length > 0);
-       s = lex->token_start;
-       len = lex->token_start - lex->input;
-       for (;;)
-       {
-               s++;
-               len++;
-               /* Premature end of the string. */
-               if (len >= lex->input_length)
-               {
-                       lex->token_terminator = s;
-                       report_invalid_token(lex);
-               }
-               else if (*s == '"')
-                       break;
-               else if ((unsigned char) *s < 32)
-               {
-                       /* Per RFC4627, these characters MUST be escaped. */
-                       /* Since *s isn't printable, exclude it from the context string */
-                       lex->token_terminator = s;
-                       ereport(ERROR,
-                                       (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
-                                        errmsg("invalid input syntax for type %s", "json"),
-                                        errdetail("Character with value 0x%02x must be escaped.",
-                                                          (unsigned char) *s),
-                                        report_json_context(lex)));
-               }
-               else if (*s == '\\')
-               {
-                       /* OK, we have an escape character. */
-                       s++;
-                       len++;
-                       if (len >= lex->input_length)
-                       {
-                               lex->token_terminator = s;
-                               report_invalid_token(lex);
-                       }
-                       else if (*s == 'u')
-                       {
-                               int                     i;
-                               int                     ch = 0;
-
-                               for (i = 1; i <= 4; i++)
-                               {
-                                       s++;
-                                       len++;
-                                       if (len >= lex->input_length)
-                                       {
-                                               lex->token_terminator = s;
-                                               report_invalid_token(lex);
-                                       }
-                                       else if (*s >= '0' && *s <= '9')
-                                               ch = (ch * 16) + (*s - '0');
-                                       else if (*s >= 'a' && *s <= 'f')
-                                               ch = (ch * 16) + (*s - 'a') + 10;
-                                       else if (*s >= 'A' && *s <= 'F')
-                                               ch = (ch * 16) + (*s - 'A') + 10;
-                                       else
-                                       {
-                                               lex->token_terminator = s + pg_mblen(s);
-                                               ereport(ERROR,
-                                                               (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
-                                                                errmsg("invalid input syntax for type %s",
-                                                                               "json"),
-                                                                errdetail("\"\\u\" must be followed by four hexadecimal digits."),
-                                                                report_json_context(lex)));
-                                       }
-                               }
-                               if (lex->strval != NULL)
-                               {
-                                       char            utf8str[5];
-                                       int                     utf8len;
-
-                                       if (ch >= 0xd800 && ch <= 0xdbff)
-                                       {
-                                               if (hi_surrogate != -1)
-                                                       ereport(ERROR,
-                                                                       (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
-                                                                        errmsg("invalid input syntax for type %s",
-                                                                                       "json"),
-                                                                        errdetail("Unicode high surrogate must not follow a high surrogate."),
-                                                                        report_json_context(lex)));
-                                               hi_surrogate = (ch & 0x3ff) << 10;
-                                               continue;
-                                       }
-                                       else if (ch >= 0xdc00 && ch <= 0xdfff)
-                                       {
-                                               if (hi_surrogate == -1)
-                                                       ereport(ERROR,
-                                                                       (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
-                                                                        errmsg("invalid input syntax for type %s", "json"),
-                                                                        errdetail("Unicode low surrogate must follow a high surrogate."),
-                                                                        report_json_context(lex)));
-                                               ch = 0x10000 + hi_surrogate + (ch & 0x3ff);
-                                               hi_surrogate = -1;
-                                       }
-
-                                       if (hi_surrogate != -1)
-                                               ereport(ERROR,
-                                                               (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
-                                                                errmsg("invalid input syntax for type %s", "json"),
-                                                                errdetail("Unicode low surrogate must follow a high surrogate."),
-                                                                report_json_context(lex)));
-
-                                       /*
-                                        * For UTF8, replace the escape sequence by the actual
-                                        * utf8 character in lex->strval. Do this also for other
-                                        * encodings if the escape designates an ASCII character,
-                                        * otherwise raise an error.
-                                        */
-
-                                       if (ch == 0)
-                                       {
-                                               /* We can't allow this, since our TEXT type doesn't */
-                                               ereport(ERROR,
-                                                               (errcode(ERRCODE_UNTRANSLATABLE_CHARACTER),
-                                                                errmsg("unsupported Unicode escape sequence"),
-                                                                errdetail("\\u0000 cannot be converted to text."),
-                                                                report_json_context(lex)));
-                                       }
-                                       else if (GetDatabaseEncoding() == PG_UTF8)
-                                       {
-                                               unicode_to_utf8(ch, (unsigned char *) utf8str);
-                                               utf8len = pg_utf_mblen((unsigned char *) utf8str);
-                                               appendBinaryStringInfo(lex->strval, utf8str, utf8len);
-                                       }
-                                       else if (ch <= 0x007f)
-                                       {
-                                               /*
-                                                * This is the only way to designate things like a
-                                                * form feed character in JSON, so it's useful in all
-                                                * encodings.
-                                                */
-                                               appendStringInfoChar(lex->strval, (char) ch);
-                                       }
-                                       else
-                                       {
-                                               ereport(ERROR,
-                                                               (errcode(ERRCODE_UNTRANSLATABLE_CHARACTER),
-                                                                errmsg("unsupported Unicode escape sequence"),
-                                                                errdetail("Unicode escape values cannot be used for code point values above 007F when the server encoding is not UTF8."),
-                                                                report_json_context(lex)));
-                                       }
-
-                               }
-                       }
-                       else if (lex->strval != NULL)
-                       {
-                               if (hi_surrogate != -1)
-                                       ereport(ERROR,
-                                                       (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
-                                                        errmsg("invalid input syntax for type %s",
-                                                                       "json"),
-                                                        errdetail("Unicode low surrogate must follow a high surrogate."),
-                                                        report_json_context(lex)));
-
-                               switch (*s)
-                               {
-                                       case '"':
-                                       case '\\':
-                                       case '/':
-                                               appendStringInfoChar(lex->strval, *s);
-                                               break;
-                                       case 'b':
-                                               appendStringInfoChar(lex->strval, '\b');
-                                               break;
-                                       case 'f':
-                                               appendStringInfoChar(lex->strval, '\f');
-                                               break;
-                                       case 'n':
-                                               appendStringInfoChar(lex->strval, '\n');
-                                               break;
-                                       case 'r':
-                                               appendStringInfoChar(lex->strval, '\r');
-                                               break;
-                                       case 't':
-                                               appendStringInfoChar(lex->strval, '\t');
-                                               break;
-                                       default:
-                                               /* Not a valid string escape, so error out. */
-                                               lex->token_terminator = s + pg_mblen(s);
-                                               ereport(ERROR,
-                                                               (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
-                                                                errmsg("invalid input syntax for type %s",
-                                                                               "json"),
-                                                                errdetail("Escape sequence \"\\%s\" is invalid.",
-                                                                                  extract_mb_char(s)),
-                                                                report_json_context(lex)));
-                               }
-                       }
-                       else if (strchr("\"\\/bfnrt", *s) == NULL)
-                       {
-                               /*
-                                * Simpler processing if we're not bothered about de-escaping
-                                *
-                                * It's very tempting to remove the strchr() call here and
-                                * replace it with a switch statement, but testing so far has
-                                * shown it's not a performance win.
-                                */
-                               lex->token_terminator = s + pg_mblen(s);
-                               ereport(ERROR,
-                                               (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
-                                                errmsg("invalid input syntax for type %s", "json"),
-                                                errdetail("Escape sequence \"\\%s\" is invalid.",
-                                                                  extract_mb_char(s)),
-                                                report_json_context(lex)));
-                       }
-
-               }
-               else if (lex->strval != NULL)
-               {
-                       if (hi_surrogate != -1)
-                               ereport(ERROR,
-                                               (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
-                                                errmsg("invalid input syntax for type %s", "json"),
-                                                errdetail("Unicode low surrogate must follow a high surrogate."),
-                                                report_json_context(lex)));
-
-                       appendStringInfoChar(lex->strval, *s);
-               }
-
-       }
-
-       if (hi_surrogate != -1)
-               ereport(ERROR,
-                               (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
-                                errmsg("invalid input syntax for type %s", "json"),
-                                errdetail("Unicode low surrogate must follow a high surrogate."),
-                                report_json_context(lex)));
-
-       /* Hooray, we found the end of the string! */
-       lex->prev_token_terminator = lex->token_terminator;
-       lex->token_terminator = s + 1;
-}
-
-/*
- * The next token in the input stream is known to be a number; lex it.
- *
- * In JSON, a number consists of four parts:
- *
- * (1) An optional minus sign ('-').
- *
- * (2) Either a single '0', or a string of one or more digits that does not
- *        begin with a '0'.
- *
- * (3) An optional decimal part, consisting of a period ('.') followed by
- *        one or more digits.  (Note: While this part can be omitted
- *        completely, it's not OK to have only the decimal point without
- *        any digits afterwards.)
- *
- * (4) An optional exponent part, consisting of 'e' or 'E', optionally
- *        followed by '+' or '-', followed by one or more digits.  (Note:
- *        As with the decimal part, if 'e' or 'E' is present, it must be
- *        followed by at least one digit.)
- *
- * The 's' argument to this function points to the ostensible beginning
- * of part 2 - i.e. the character after any optional minus sign, or the
- * first character of the string if there is none.
- *
- * If num_err is not NULL, we return an error flag to *num_err rather than
- * raising an error for a badly-formed number.  Also, if total_len is not NULL
- * the distance from lex->input to the token end+1 is returned to *total_len.
- */
-static inline void
-json_lex_number(JsonLexContext *lex, char *s,
-                               bool *num_err, int *total_len)
-{
-       bool            error = false;
-       int                     len = s - lex->input;
-
-       /* Part (1): leading sign indicator. */
-       /* Caller already did this for us; so do nothing. */
-
-       /* Part (2): parse main digit string. */
-       if (len < lex->input_length && *s == '0')
-       {
-               s++;
-               len++;
-       }
-       else if (len < lex->input_length && *s >= '1' && *s <= '9')
-       {
-               do
-               {
-                       s++;
-                       len++;
-               } while (len < lex->input_length && *s >= '0' && *s <= '9');
-       }
-       else
-               error = true;
-
-       /* Part (3): parse optional decimal portion. */
-       if (len < lex->input_length && *s == '.')
-       {
-               s++;
-               len++;
-               if (len == lex->input_length || *s < '0' || *s > '9')
-                       error = true;
-               else
-               {
-                       do
-                       {
-                               s++;
-                               len++;
-                       } while (len < lex->input_length && *s >= '0' && *s <= '9');
-               }
-       }
-
-       /* Part (4): parse optional exponent. */
-       if (len < lex->input_length && (*s == 'e' || *s == 'E'))
-       {
-               s++;
-               len++;
-               if (len < lex->input_length && (*s == '+' || *s == '-'))
-               {
-                       s++;
-                       len++;
-               }
-               if (len == lex->input_length || *s < '0' || *s > '9')
-                       error = true;
-               else
-               {
-                       do
-                       {
-                               s++;
-                               len++;
-                       } while (len < lex->input_length && *s >= '0' && *s <= '9');
-               }
-       }
-
-       /*
-        * Check for trailing garbage.  As in json_lex(), any alphanumeric stuff
-        * here should be considered part of the token for error-reporting
-        * purposes.
-        */
-       for (; len < lex->input_length && JSON_ALPHANUMERIC_CHAR(*s); s++, len++)
-               error = true;
-
-       if (total_len != NULL)
-               *total_len = len;
-
-       if (num_err != NULL)
-       {
-               /* let the caller handle any error */
-               *num_err = error;
-       }
-       else
-       {
-               /* return token endpoint */
-               lex->prev_token_terminator = lex->token_terminator;
-               lex->token_terminator = s;
-               /* handle error if any */
-               if (error)
-                       report_invalid_token(lex);
-       }
-}
-
-/*
- * Report a parse error.
- *
- * lex->token_start and lex->token_terminator must identify the current token.
- */
-static void
-report_parse_error(JsonParseContext ctx, JsonLexContext *lex)
-{
-       char       *token;
-       int                     toklen;
-
-       /* Handle case where the input ended prematurely. */
-       if (lex->token_start == NULL || lex->token_type == JSON_TOKEN_END)
-               ereport(ERROR,
-                               (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
-                                errmsg("invalid input syntax for type %s", "json"),
-                                errdetail("The input string ended unexpectedly."),
-                                report_json_context(lex)));
-
-       /* Separate out the current token. */
-       toklen = lex->token_terminator - lex->token_start;
-       token = palloc(toklen + 1);
-       memcpy(token, lex->token_start, toklen);
-       token[toklen] = '\0';
-
-       /* Complain, with the appropriate detail message. */
-       if (ctx == JSON_PARSE_END)
-               ereport(ERROR,
-                               (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
-                                errmsg("invalid input syntax for type %s", "json"),
-                                errdetail("Expected end of input, but found \"%s\".",
-                                                  token),
-                                report_json_context(lex)));
-       else
-       {
-               switch (ctx)
-               {
-                       case JSON_PARSE_VALUE:
-                               ereport(ERROR,
-                                               (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
-                                                errmsg("invalid input syntax for type %s", "json"),
-                                                errdetail("Expected JSON value, but found \"%s\".",
-                                                                  token),
-                                                report_json_context(lex)));
-                               break;
-                       case JSON_PARSE_STRING:
-                               ereport(ERROR,
-                                               (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
-                                                errmsg("invalid input syntax for type %s", "json"),
-                                                errdetail("Expected string, but found \"%s\".",
-                                                                  token),
-                                                report_json_context(lex)));
-                               break;
-                       case JSON_PARSE_ARRAY_START:
-                               ereport(ERROR,
-                                               (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
-                                                errmsg("invalid input syntax for type %s", "json"),
-                                                errdetail("Expected array element or \"]\", but found \"%s\".",
-                                                                  token),
-                                                report_json_context(lex)));
-                               break;
-                       case JSON_PARSE_ARRAY_NEXT:
-                               ereport(ERROR,
-                                               (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
-                                                errmsg("invalid input syntax for type %s", "json"),
-                                                errdetail("Expected \",\" or \"]\", but found \"%s\".",
-                                                                  token),
-                                                report_json_context(lex)));
-                               break;
-                       case JSON_PARSE_OBJECT_START:
-                               ereport(ERROR,
-                                               (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
-                                                errmsg("invalid input syntax for type %s", "json"),
-                                                errdetail("Expected string or \"}\", but found \"%s\".",
-                                                                  token),
-                                                report_json_context(lex)));
-                               break;
-                       case JSON_PARSE_OBJECT_LABEL:
-                               ereport(ERROR,
-                                               (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
-                                                errmsg("invalid input syntax for type %s", "json"),
-                                                errdetail("Expected \":\", but found \"%s\".",
-                                                                  token),
-                                                report_json_context(lex)));
-                               break;
-                       case JSON_PARSE_OBJECT_NEXT:
-                               ereport(ERROR,
-                                               (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
-                                                errmsg("invalid input syntax for type %s", "json"),
-                                                errdetail("Expected \",\" or \"}\", but found \"%s\".",
-                                                                  token),
-                                                report_json_context(lex)));
-                               break;
-                       case JSON_PARSE_OBJECT_COMMA:
-                               ereport(ERROR,
-                                               (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
-                                                errmsg("invalid input syntax for type %s", "json"),
-                                                errdetail("Expected string, but found \"%s\".",
-                                                                  token),
-                                                report_json_context(lex)));
-                               break;
-                       default:
-                               elog(ERROR, "unexpected json parse state: %d", ctx);
-               }
-       }
-}
-
-/*
- * Report an invalid input token.
- *
- * lex->token_start and lex->token_terminator must identify the token.
- */
-static void
-report_invalid_token(JsonLexContext *lex)
-{
-       char       *token;
-       int                     toklen;
-
-       /* Separate out the offending token. */
-       toklen = lex->token_terminator - lex->token_start;
-       token = palloc(toklen + 1);
-       memcpy(token, lex->token_start, toklen);
-       token[toklen] = '\0';
-
-       ereport(ERROR,
-                       (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
-                        errmsg("invalid input syntax for type %s", "json"),
-                        errdetail("Token \"%s\" is invalid.", token),
-                        report_json_context(lex)));
-}
-
-/*
- * Report a CONTEXT line for bogus JSON input.
- *
- * lex->token_terminator must be set to identify the spot where we detected
- * the error.  Note that lex->token_start might be NULL, in case we recognized
- * error at EOF.
- *
- * The return value isn't meaningful, but we make it non-void so that this
- * can be invoked inside ereport().
- */
-static int
-report_json_context(JsonLexContext *lex)
-{
-       const char *context_start;
-       const char *context_end;
-       const char *line_start;
-       int                     line_number;
-       char       *ctxt;
-       int                     ctxtlen;
-       const char *prefix;
-       const char *suffix;
-
-       /* Choose boundaries for the part of the input we will display */
-       context_start = lex->input;
-       context_end = lex->token_terminator;
-       line_start = context_start;
-       line_number = 1;
-       for (;;)
-       {
-               /* Always advance over newlines */
-               if (context_start < context_end && *context_start == '\n')
-               {
-                       context_start++;
-                       line_start = context_start;
-                       line_number++;
-                       continue;
-               }
-               /* Otherwise, done as soon as we are close enough to context_end */
-               if (context_end - context_start < 50)
-                       break;
-               /* Advance to next multibyte character */
-               if (IS_HIGHBIT_SET(*context_start))
-                       context_start += pg_mblen(context_start);
-               else
-                       context_start++;
-       }
-
-       /*
-        * We add "..." to indicate that the excerpt doesn't start at the
-        * beginning of the line ... but if we're within 3 characters of the
-        * beginning of the line, we might as well just show the whole line.
-        */
-       if (context_start - line_start <= 3)
-               context_start = line_start;
-
-       /* Get a null-terminated copy of the data to present */
-       ctxtlen = context_end - context_start;
-       ctxt = palloc(ctxtlen + 1);
-       memcpy(ctxt, context_start, ctxtlen);
-       ctxt[ctxtlen] = '\0';
-
-       /*
-        * Show the context, prefixing "..." if not starting at start of line, and
-        * suffixing "..." if not ending at end of line.
-        */
-       prefix = (context_start > line_start) ? "..." : "";
-       suffix = (lex->token_type != JSON_TOKEN_END && context_end - lex->input < lex->input_length && *context_end != '\n' && *context_end != '\r') ? "..." : "";
-
-       return errcontext("JSON data, line %d: %s%s%s",
-                                         line_number, prefix, ctxt, suffix);
-}
-
-/*
- * Extract a single, possibly multi-byte char from the input string.
- */
-static char *
-extract_mb_char(char *s)
-{
-       char       *res;
-       int                     len;
-
-       len = pg_mblen(s);
-       res = palloc(len + 1);
-       memcpy(res, s, len);
-       res[len] = '\0';
-
-       return res;
-}
-
 /*
  * Determine how we want to print values of a given type in datum_to_json.
  *
@@ -2547,7 +1343,7 @@ json_typeof(PG_FUNCTION_ARGS)
 
        /* Lex exactly one token from the input and check its type. */
        json_lex(lex);
-       tok = lex_peek(lex);
+       tok = lex->token_type;
        switch (tok)
        {
                case JSON_TOKEN_OBJECT_START:
diff --git a/src/backend/utils/adt/jsonapi.c b/src/backend/utils/adt/jsonapi.c
new file mode 100644 (file)
index 0000000..fc8af9f
--- /dev/null
@@ -0,0 +1,1216 @@
+/*-------------------------------------------------------------------------
+ *
+ * jsonapi.c
+ *             JSON parser and lexer interfaces
+ *
+ * Portions Copyright (c) 1996-2020, PostgreSQL Global Development Group
+ * Portions Copyright (c) 1994, Regents of the University of California
+ *
+ * IDENTIFICATION
+ *       src/backend/utils/adt/jsonapi.c
+ *
+ *-------------------------------------------------------------------------
+ */
+#include "postgres.h"
+
+#include "mb/pg_wchar.h"
+#include "miscadmin.h"
+#include "utils/jsonapi.h"
+
+/*
+ * The context of the parser is maintained by the recursive descent
+ * mechanism, but is passed explicitly to the error reporting routine
+ * for better diagnostics.
+ */
+typedef enum                                   /* contexts of JSON parser */
+{
+       JSON_PARSE_VALUE,                       /* expecting a value */
+       JSON_PARSE_STRING,                      /* expecting a string (for a field name) */
+       JSON_PARSE_ARRAY_START,         /* saw '[', expecting value or ']' */
+       JSON_PARSE_ARRAY_NEXT,          /* saw array element, expecting ',' or ']' */
+       JSON_PARSE_OBJECT_START,        /* saw '{', expecting label or '}' */
+       JSON_PARSE_OBJECT_LABEL,        /* saw object label, expecting ':' */
+       JSON_PARSE_OBJECT_NEXT,         /* saw object value, expecting ',' or '}' */
+       JSON_PARSE_OBJECT_COMMA,        /* saw object ',', expecting next label */
+       JSON_PARSE_END                          /* saw the end of a document, expect nothing */
+} JsonParseContext;
+
+static inline void json_lex_string(JsonLexContext *lex);
+static inline void json_lex_number(JsonLexContext *lex, char *s,
+                                                                  bool *num_err, int *total_len);
+static inline void parse_scalar(JsonLexContext *lex, JsonSemAction *sem);
+static void parse_object_field(JsonLexContext *lex, JsonSemAction *sem);
+static void parse_object(JsonLexContext *lex, JsonSemAction *sem);
+static void parse_array_element(JsonLexContext *lex, JsonSemAction *sem);
+static void parse_array(JsonLexContext *lex, JsonSemAction *sem);
+static void report_parse_error(JsonParseContext ctx, JsonLexContext *lex) pg_attribute_noreturn();
+static void report_invalid_token(JsonLexContext *lex) pg_attribute_noreturn();
+static int     report_json_context(JsonLexContext *lex);
+static char *extract_mb_char(char *s);
+
+/* the null action object used for pure validation */
+JsonSemAction nullSemAction =
+{
+       NULL, NULL, NULL, NULL, NULL,
+       NULL, NULL, NULL, NULL, NULL
+};
+
+/* Recursive Descent parser support routines */
+
+/*
+ * lex_peek
+ *
+ * what is the current look_ahead token?
+*/
+static inline JsonTokenType
+lex_peek(JsonLexContext *lex)
+{
+       return lex->token_type;
+}
+
+/*
+ * lex_accept
+ *
+ * accept the look_ahead token and move the lexer to the next token if the
+ * look_ahead token matches the token parameter. In that case, and if required,
+ * also hand back the de-escaped lexeme.
+ *
+ * returns true if the token matched, false otherwise.
+ */
+static inline bool
+lex_accept(JsonLexContext *lex, JsonTokenType token, char **lexeme)
+{
+       if (lex->token_type == token)
+       {
+               if (lexeme != NULL)
+               {
+                       if (lex->token_type == JSON_TOKEN_STRING)
+                       {
+                               if (lex->strval != NULL)
+                                       *lexeme = pstrdup(lex->strval->data);
+                       }
+                       else
+                       {
+                               int                     len = (lex->token_terminator - lex->token_start);
+                               char       *tokstr = palloc(len + 1);
+
+                               memcpy(tokstr, lex->token_start, len);
+                               tokstr[len] = '\0';
+                               *lexeme = tokstr;
+                       }
+               }
+               json_lex(lex);
+               return true;
+       }
+       return false;
+}
+
+/*
+ * lex_accept
+ *
+ * move the lexer to the next token if the current look_ahead token matches
+ * the parameter token. Otherwise, report an error.
+ */
+static inline void
+lex_expect(JsonParseContext ctx, JsonLexContext *lex, JsonTokenType token)
+{
+       if (!lex_accept(lex, token, NULL))
+               report_parse_error(ctx, lex);
+}
+
+/* chars to consider as part of an alphanumeric token */
+#define JSON_ALPHANUMERIC_CHAR(c)  \
+       (((c) >= 'a' && (c) <= 'z') || \
+        ((c) >= 'A' && (c) <= 'Z') || \
+        ((c) >= '0' && (c) <= '9') || \
+        (c) == '_' || \
+        IS_HIGHBIT_SET(c))
+
+/*
+ * Utility function to check if a string is a valid JSON number.
+ *
+ * str is of length len, and need not be null-terminated.
+ */
+bool
+IsValidJsonNumber(const char *str, int len)
+{
+       bool            numeric_error;
+       int                     total_len;
+       JsonLexContext dummy_lex;
+
+       if (len <= 0)
+               return false;
+
+       /*
+        * json_lex_number expects a leading  '-' to have been eaten already.
+        *
+        * having to cast away the constness of str is ugly, but there's not much
+        * easy alternative.
+        */
+       if (*str == '-')
+       {
+               dummy_lex.input = unconstify(char *, str) +1;
+               dummy_lex.input_length = len - 1;
+       }
+       else
+       {
+               dummy_lex.input = unconstify(char *, str);
+               dummy_lex.input_length = len;
+       }
+
+       json_lex_number(&dummy_lex, dummy_lex.input, &numeric_error, &total_len);
+
+       return (!numeric_error) && (total_len == dummy_lex.input_length);
+}
+
+/*
+ * makeJsonLexContext
+ *
+ * lex constructor, with or without StringInfo object
+ * for de-escaped lexemes.
+ *
+ * Without is better as it makes the processing faster, so only make one
+ * if really required.
+ *
+ * If you already have the json as a text* value, use the first of these
+ * functions, otherwise use  makeJsonLexContextCstringLen().
+ */
+JsonLexContext *
+makeJsonLexContext(text *json, bool need_escapes)
+{
+       return makeJsonLexContextCstringLen(VARDATA_ANY(json),
+                                                                               VARSIZE_ANY_EXHDR(json),
+                                                                               need_escapes);
+}
+
+JsonLexContext *
+makeJsonLexContextCstringLen(char *json, int len, bool need_escapes)
+{
+       JsonLexContext *lex = palloc0(sizeof(JsonLexContext));
+
+       lex->input = lex->token_terminator = lex->line_start = json;
+       lex->line_number = 1;
+       lex->input_length = len;
+       if (need_escapes)
+               lex->strval = makeStringInfo();
+       return lex;
+}
+
+/*
+ * pg_parse_json
+ *
+ * Publicly visible entry point for the JSON parser.
+ *
+ * lex is a lexing context, set up for the json to be processed by calling
+ * makeJsonLexContext(). sem is a structure of function pointers to semantic
+ * action routines to be called at appropriate spots during parsing, and a
+ * pointer to a state object to be passed to those routines.
+ */
+void
+pg_parse_json(JsonLexContext *lex, JsonSemAction *sem)
+{
+       JsonTokenType tok;
+
+       /* get the initial token */
+       json_lex(lex);
+
+       tok = lex_peek(lex);
+
+       /* parse by recursive descent */
+       switch (tok)
+       {
+               case JSON_TOKEN_OBJECT_START:
+                       parse_object(lex, sem);
+                       break;
+               case JSON_TOKEN_ARRAY_START:
+                       parse_array(lex, sem);
+                       break;
+               default:
+                       parse_scalar(lex, sem); /* json can be a bare scalar */
+       }
+
+       lex_expect(JSON_PARSE_END, lex, JSON_TOKEN_END);
+
+}
+
+/*
+ * json_count_array_elements
+ *
+ * Returns number of array elements in lex context at start of array token
+ * until end of array token at same nesting level.
+ *
+ * Designed to be called from array_start routines.
+ */
+int
+json_count_array_elements(JsonLexContext *lex)
+{
+       JsonLexContext copylex;
+       int                     count;
+
+       /*
+        * It's safe to do this with a shallow copy because the lexical routines
+        * don't scribble on the input. They do scribble on the other pointers
+        * etc, so doing this with a copy makes that safe.
+        */
+       memcpy(&copylex, lex, sizeof(JsonLexContext));
+       copylex.strval = NULL;          /* not interested in values here */
+       copylex.lex_level++;
+
+       count = 0;
+       lex_expect(JSON_PARSE_ARRAY_START, &copylex, JSON_TOKEN_ARRAY_START);
+       if (lex_peek(&copylex) != JSON_TOKEN_ARRAY_END)
+       {
+               do
+               {
+                       count++;
+                       parse_array_element(&copylex, &nullSemAction);
+               }
+               while (lex_accept(&copylex, JSON_TOKEN_COMMA, NULL));
+       }
+       lex_expect(JSON_PARSE_ARRAY_NEXT, &copylex, JSON_TOKEN_ARRAY_END);
+
+       return count;
+}
+
+/*
+ *     Recursive Descent parse routines. There is one for each structural
+ *     element in a json document:
+ *       - scalar (string, number, true, false, null)
+ *       - array  ( [ ] )
+ *       - array element
+ *       - object ( { } )
+ *       - object field
+ */
+static inline void
+parse_scalar(JsonLexContext *lex, JsonSemAction *sem)
+{
+       char       *val = NULL;
+       json_scalar_action sfunc = sem->scalar;
+       char      **valaddr;
+       JsonTokenType tok = lex_peek(lex);
+
+       valaddr = sfunc == NULL ? NULL : &val;
+
+       /* a scalar must be a string, a number, true, false, or null */
+       switch (tok)
+       {
+               case JSON_TOKEN_TRUE:
+                       lex_accept(lex, JSON_TOKEN_TRUE, valaddr);
+                       break;
+               case JSON_TOKEN_FALSE:
+                       lex_accept(lex, JSON_TOKEN_FALSE, valaddr);
+                       break;
+               case JSON_TOKEN_NULL:
+                       lex_accept(lex, JSON_TOKEN_NULL, valaddr);
+                       break;
+               case JSON_TOKEN_NUMBER:
+                       lex_accept(lex, JSON_TOKEN_NUMBER, valaddr);
+                       break;
+               case JSON_TOKEN_STRING:
+                       lex_accept(lex, JSON_TOKEN_STRING, valaddr);
+                       break;
+               default:
+                       report_parse_error(JSON_PARSE_VALUE, lex);
+       }
+
+       if (sfunc != NULL)
+               (*sfunc) (sem->semstate, val, tok);
+}
+
+static void
+parse_object_field(JsonLexContext *lex, JsonSemAction *sem)
+{
+       /*
+        * An object field is "fieldname" : value where value can be a scalar,
+        * object or array.  Note: in user-facing docs and error messages, we
+        * generally call a field name a "key".
+        */
+
+       char       *fname = NULL;       /* keep compiler quiet */
+       json_ofield_action ostart = sem->object_field_start;
+       json_ofield_action oend = sem->object_field_end;
+       bool            isnull;
+       char      **fnameaddr = NULL;
+       JsonTokenType tok;
+
+       if (ostart != NULL || oend != NULL)
+               fnameaddr = &fname;
+
+       if (!lex_accept(lex, JSON_TOKEN_STRING, fnameaddr))
+               report_parse_error(JSON_PARSE_STRING, lex);
+
+       lex_expect(JSON_PARSE_OBJECT_LABEL, lex, JSON_TOKEN_COLON);
+
+       tok = lex_peek(lex);
+       isnull = tok == JSON_TOKEN_NULL;
+
+       if (ostart != NULL)
+               (*ostart) (sem->semstate, fname, isnull);
+
+       switch (tok)
+       {
+               case JSON_TOKEN_OBJECT_START:
+                       parse_object(lex, sem);
+                       break;
+               case JSON_TOKEN_ARRAY_START:
+                       parse_array(lex, sem);
+                       break;
+               default:
+                       parse_scalar(lex, sem);
+       }
+
+       if (oend != NULL)
+               (*oend) (sem->semstate, fname, isnull);
+}
+
+static void
+parse_object(JsonLexContext *lex, JsonSemAction *sem)
+{
+       /*
+        * an object is a possibly empty sequence of object fields, separated by
+        * commas and surrounded by curly braces.
+        */
+       json_struct_action ostart = sem->object_start;
+       json_struct_action oend = sem->object_end;
+       JsonTokenType tok;
+
+       check_stack_depth();
+
+       if (ostart != NULL)
+               (*ostart) (sem->semstate);
+
+       /*
+        * Data inside an object is at a higher nesting level than the object
+        * itself. Note that we increment this after we call the semantic routine
+        * for the object start and restore it before we call the routine for the
+        * object end.
+        */
+       lex->lex_level++;
+
+       /* we know this will succeed, just clearing the token */
+       lex_expect(JSON_PARSE_OBJECT_START, lex, JSON_TOKEN_OBJECT_START);
+
+       tok = lex_peek(lex);
+       switch (tok)
+       {
+               case JSON_TOKEN_STRING:
+                       parse_object_field(lex, sem);
+                       while (lex_accept(lex, JSON_TOKEN_COMMA, NULL))
+                               parse_object_field(lex, sem);
+                       break;
+               case JSON_TOKEN_OBJECT_END:
+                       break;
+               default:
+                       /* case of an invalid initial token inside the object */
+                       report_parse_error(JSON_PARSE_OBJECT_START, lex);
+       }
+
+       lex_expect(JSON_PARSE_OBJECT_NEXT, lex, JSON_TOKEN_OBJECT_END);
+
+       lex->lex_level--;
+
+       if (oend != NULL)
+               (*oend) (sem->semstate);
+}
+
+static void
+parse_array_element(JsonLexContext *lex, JsonSemAction *sem)
+{
+       json_aelem_action astart = sem->array_element_start;
+       json_aelem_action aend = sem->array_element_end;
+       JsonTokenType tok = lex_peek(lex);
+
+       bool            isnull;
+
+       isnull = tok == JSON_TOKEN_NULL;
+
+       if (astart != NULL)
+               (*astart) (sem->semstate, isnull);
+
+       /* an array element is any object, array or scalar */
+       switch (tok)
+       {
+               case JSON_TOKEN_OBJECT_START:
+                       parse_object(lex, sem);
+                       break;
+               case JSON_TOKEN_ARRAY_START:
+                       parse_array(lex, sem);
+                       break;
+               default:
+                       parse_scalar(lex, sem);
+       }
+
+       if (aend != NULL)
+               (*aend) (sem->semstate, isnull);
+}
+
+static void
+parse_array(JsonLexContext *lex, JsonSemAction *sem)
+{
+       /*
+        * an array is a possibly empty sequence of array elements, separated by
+        * commas and surrounded by square brackets.
+        */
+       json_struct_action astart = sem->array_start;
+       json_struct_action aend = sem->array_end;
+
+       check_stack_depth();
+
+       if (astart != NULL)
+               (*astart) (sem->semstate);
+
+       /*
+        * Data inside an array is at a higher nesting level than the array
+        * itself. Note that we increment this after we call the semantic routine
+        * for the array start and restore it before we call the routine for the
+        * array end.
+        */
+       lex->lex_level++;
+
+       lex_expect(JSON_PARSE_ARRAY_START, lex, JSON_TOKEN_ARRAY_START);
+       if (lex_peek(lex) != JSON_TOKEN_ARRAY_END)
+       {
+
+               parse_array_element(lex, sem);
+
+               while (lex_accept(lex, JSON_TOKEN_COMMA, NULL))
+                       parse_array_element(lex, sem);
+       }
+
+       lex_expect(JSON_PARSE_ARRAY_NEXT, lex, JSON_TOKEN_ARRAY_END);
+
+       lex->lex_level--;
+
+       if (aend != NULL)
+               (*aend) (sem->semstate);
+}
+
+/*
+ * Lex one token from the input stream.
+ */
+void
+json_lex(JsonLexContext *lex)
+{
+       char       *s;
+       int                     len;
+
+       /* Skip leading whitespace. */
+       s = lex->token_terminator;
+       len = s - lex->input;
+       while (len < lex->input_length &&
+                  (*s == ' ' || *s == '\t' || *s == '\n' || *s == '\r'))
+       {
+               if (*s == '\n')
+                       ++lex->line_number;
+               ++s;
+               ++len;
+       }
+       lex->token_start = s;
+
+       /* Determine token type. */
+       if (len >= lex->input_length)
+       {
+               lex->token_start = NULL;
+               lex->prev_token_terminator = lex->token_terminator;
+               lex->token_terminator = s;
+               lex->token_type = JSON_TOKEN_END;
+       }
+       else
+               switch (*s)
+               {
+                               /* Single-character token, some kind of punctuation mark. */
+                       case '{':
+                               lex->prev_token_terminator = lex->token_terminator;
+                               lex->token_terminator = s + 1;
+                               lex->token_type = JSON_TOKEN_OBJECT_START;
+                               break;
+                       case '}':
+                               lex->prev_token_terminator = lex->token_terminator;
+                               lex->token_terminator = s + 1;
+                               lex->token_type = JSON_TOKEN_OBJECT_END;
+                               break;
+                       case '[':
+                               lex->prev_token_terminator = lex->token_terminator;
+                               lex->token_terminator = s + 1;
+                               lex->token_type = JSON_TOKEN_ARRAY_START;
+                               break;
+                       case ']':
+                               lex->prev_token_terminator = lex->token_terminator;
+                               lex->token_terminator = s + 1;
+                               lex->token_type = JSON_TOKEN_ARRAY_END;
+                               break;
+                       case ',':
+                               lex->prev_token_terminator = lex->token_terminator;
+                               lex->token_terminator = s + 1;
+                               lex->token_type = JSON_TOKEN_COMMA;
+                               break;
+                       case ':':
+                               lex->prev_token_terminator = lex->token_terminator;
+                               lex->token_terminator = s + 1;
+                               lex->token_type = JSON_TOKEN_COLON;
+                               break;
+                       case '"':
+                               /* string */
+                               json_lex_string(lex);
+                               lex->token_type = JSON_TOKEN_STRING;
+                               break;
+                       case '-':
+                               /* Negative number. */
+                               json_lex_number(lex, s + 1, NULL, NULL);
+                               lex->token_type = JSON_TOKEN_NUMBER;
+                               break;
+                       case '0':
+                       case '1':
+                       case '2':
+                       case '3':
+                       case '4':
+                       case '5':
+                       case '6':
+                       case '7':
+                       case '8':
+                       case '9':
+                               /* Positive number. */
+                               json_lex_number(lex, s, NULL, NULL);
+                               lex->token_type = JSON_TOKEN_NUMBER;
+                               break;
+                       default:
+                               {
+                                       char       *p;
+
+                                       /*
+                                        * We're not dealing with a string, number, legal
+                                        * punctuation mark, or end of string.  The only legal
+                                        * tokens we might find here are true, false, and null,
+                                        * but for error reporting purposes we scan until we see a
+                                        * non-alphanumeric character.  That way, we can report
+                                        * the whole word as an unexpected token, rather than just
+                                        * some unintuitive prefix thereof.
+                                        */
+                                       for (p = s; p - s < lex->input_length - len && JSON_ALPHANUMERIC_CHAR(*p); p++)
+                                                /* skip */ ;
+
+                                       /*
+                                        * We got some sort of unexpected punctuation or an
+                                        * otherwise unexpected character, so just complain about
+                                        * that one character.
+                                        */
+                                       if (p == s)
+                                       {
+                                               lex->prev_token_terminator = lex->token_terminator;
+                                               lex->token_terminator = s + 1;
+                                               report_invalid_token(lex);
+                                       }
+
+                                       /*
+                                        * We've got a real alphanumeric token here.  If it
+                                        * happens to be true, false, or null, all is well.  If
+                                        * not, error out.
+                                        */
+                                       lex->prev_token_terminator = lex->token_terminator;
+                                       lex->token_terminator = p;
+                                       if (p - s == 4)
+                                       {
+                                               if (memcmp(s, "true", 4) == 0)
+                                                       lex->token_type = JSON_TOKEN_TRUE;
+                                               else if (memcmp(s, "null", 4) == 0)
+                                                       lex->token_type = JSON_TOKEN_NULL;
+                                               else
+                                                       report_invalid_token(lex);
+                                       }
+                                       else if (p - s == 5 && memcmp(s, "false", 5) == 0)
+                                               lex->token_type = JSON_TOKEN_FALSE;
+                                       else
+                                               report_invalid_token(lex);
+
+                               }
+               }                                               /* end of switch */
+}
+
+/*
+ * The next token in the input stream is known to be a string; lex it.
+ */
+static inline void
+json_lex_string(JsonLexContext *lex)
+{
+       char       *s;
+       int                     len;
+       int                     hi_surrogate = -1;
+
+       if (lex->strval != NULL)
+               resetStringInfo(lex->strval);
+
+       Assert(lex->input_length > 0);
+       s = lex->token_start;
+       len = lex->token_start - lex->input;
+       for (;;)
+       {
+               s++;
+               len++;
+               /* Premature end of the string. */
+               if (len >= lex->input_length)
+               {
+                       lex->token_terminator = s;
+                       report_invalid_token(lex);
+               }
+               else if (*s == '"')
+                       break;
+               else if ((unsigned char) *s < 32)
+               {
+                       /* Per RFC4627, these characters MUST be escaped. */
+                       /* Since *s isn't printable, exclude it from the context string */
+                       lex->token_terminator = s;
+                       ereport(ERROR,
+                                       (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
+                                        errmsg("invalid input syntax for type %s", "json"),
+                                        errdetail("Character with value 0x%02x must be escaped.",
+                                                          (unsigned char) *s),
+                                        report_json_context(lex)));
+               }
+               else if (*s == '\\')
+               {
+                       /* OK, we have an escape character. */
+                       s++;
+                       len++;
+                       if (len >= lex->input_length)
+                       {
+                               lex->token_terminator = s;
+                               report_invalid_token(lex);
+                       }
+                       else if (*s == 'u')
+                       {
+                               int                     i;
+                               int                     ch = 0;
+
+                               for (i = 1; i <= 4; i++)
+                               {
+                                       s++;
+                                       len++;
+                                       if (len >= lex->input_length)
+                                       {
+                                               lex->token_terminator = s;
+                                               report_invalid_token(lex);
+                                       }
+                                       else if (*s >= '0' && *s <= '9')
+                                               ch = (ch * 16) + (*s - '0');
+                                       else if (*s >= 'a' && *s <= 'f')
+                                               ch = (ch * 16) + (*s - 'a') + 10;
+                                       else if (*s >= 'A' && *s <= 'F')
+                                               ch = (ch * 16) + (*s - 'A') + 10;
+                                       else
+                                       {
+                                               lex->token_terminator = s + pg_mblen(s);
+                                               ereport(ERROR,
+                                                               (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
+                                                                errmsg("invalid input syntax for type %s",
+                                                                               "json"),
+                                                                errdetail("\"\\u\" must be followed by four hexadecimal digits."),
+                                                                report_json_context(lex)));
+                                       }
+                               }
+                               if (lex->strval != NULL)
+                               {
+                                       char            utf8str[5];
+                                       int                     utf8len;
+
+                                       if (ch >= 0xd800 && ch <= 0xdbff)
+                                       {
+                                               if (hi_surrogate != -1)
+                                                       ereport(ERROR,
+                                                                       (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
+                                                                        errmsg("invalid input syntax for type %s",
+                                                                                       "json"),
+                                                                        errdetail("Unicode high surrogate must not follow a high surrogate."),
+                                                                        report_json_context(lex)));
+                                               hi_surrogate = (ch & 0x3ff) << 10;
+                                               continue;
+                                       }
+                                       else if (ch >= 0xdc00 && ch <= 0xdfff)
+                                       {
+                                               if (hi_surrogate == -1)
+                                                       ereport(ERROR,
+                                                                       (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
+                                                                        errmsg("invalid input syntax for type %s", "json"),
+                                                                        errdetail("Unicode low surrogate must follow a high surrogate."),
+                                                                        report_json_context(lex)));
+                                               ch = 0x10000 + hi_surrogate + (ch & 0x3ff);
+                                               hi_surrogate = -1;
+                                       }
+
+                                       if (hi_surrogate != -1)
+                                               ereport(ERROR,
+                                                               (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
+                                                                errmsg("invalid input syntax for type %s", "json"),
+                                                                errdetail("Unicode low surrogate must follow a high surrogate."),
+                                                                report_json_context(lex)));
+
+                                       /*
+                                        * For UTF8, replace the escape sequence by the actual
+                                        * utf8 character in lex->strval. Do this also for other
+                                        * encodings if the escape designates an ASCII character,
+                                        * otherwise raise an error.
+                                        */
+
+                                       if (ch == 0)
+                                       {
+                                               /* We can't allow this, since our TEXT type doesn't */
+                                               ereport(ERROR,
+                                                               (errcode(ERRCODE_UNTRANSLATABLE_CHARACTER),
+                                                                errmsg("unsupported Unicode escape sequence"),
+                                                                errdetail("\\u0000 cannot be converted to text."),
+                                                                report_json_context(lex)));
+                                       }
+                                       else if (GetDatabaseEncoding() == PG_UTF8)
+                                       {
+                                               unicode_to_utf8(ch, (unsigned char *) utf8str);
+                                               utf8len = pg_utf_mblen((unsigned char *) utf8str);
+                                               appendBinaryStringInfo(lex->strval, utf8str, utf8len);
+                                       }
+                                       else if (ch <= 0x007f)
+                                       {
+                                               /*
+                                                * This is the only way to designate things like a
+                                                * form feed character in JSON, so it's useful in all
+                                                * encodings.
+                                                */
+                                               appendStringInfoChar(lex->strval, (char) ch);
+                                       }
+                                       else
+                                       {
+                                               ereport(ERROR,
+                                                               (errcode(ERRCODE_UNTRANSLATABLE_CHARACTER),
+                                                                errmsg("unsupported Unicode escape sequence"),
+                                                                errdetail("Unicode escape values cannot be used for code point values above 007F when the server encoding is not UTF8."),
+                                                                report_json_context(lex)));
+                                       }
+
+                               }
+                       }
+                       else if (lex->strval != NULL)
+                       {
+                               if (hi_surrogate != -1)
+                                       ereport(ERROR,
+                                                       (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
+                                                        errmsg("invalid input syntax for type %s",
+                                                                       "json"),
+                                                        errdetail("Unicode low surrogate must follow a high surrogate."),
+                                                        report_json_context(lex)));
+
+                               switch (*s)
+                               {
+                                       case '"':
+                                       case '\\':
+                                       case '/':
+                                               appendStringInfoChar(lex->strval, *s);
+                                               break;
+                                       case 'b':
+                                               appendStringInfoChar(lex->strval, '\b');
+                                               break;
+                                       case 'f':
+                                               appendStringInfoChar(lex->strval, '\f');
+                                               break;
+                                       case 'n':
+                                               appendStringInfoChar(lex->strval, '\n');
+                                               break;
+                                       case 'r':
+                                               appendStringInfoChar(lex->strval, '\r');
+                                               break;
+                                       case 't':
+                                               appendStringInfoChar(lex->strval, '\t');
+                                               break;
+                                       default:
+                                               /* Not a valid string escape, so error out. */
+                                               lex->token_terminator = s + pg_mblen(s);
+                                               ereport(ERROR,
+                                                               (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
+                                                                errmsg("invalid input syntax for type %s",
+                                                                               "json"),
+                                                                errdetail("Escape sequence \"\\%s\" is invalid.",
+                                                                                  extract_mb_char(s)),
+                                                                report_json_context(lex)));
+                               }
+                       }
+                       else if (strchr("\"\\/bfnrt", *s) == NULL)
+                       {
+                               /*
+                                * Simpler processing if we're not bothered about de-escaping
+                                *
+                                * It's very tempting to remove the strchr() call here and
+                                * replace it with a switch statement, but testing so far has
+                                * shown it's not a performance win.
+                                */
+                               lex->token_terminator = s + pg_mblen(s);
+                               ereport(ERROR,
+                                               (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
+                                                errmsg("invalid input syntax for type %s", "json"),
+                                                errdetail("Escape sequence \"\\%s\" is invalid.",
+                                                                  extract_mb_char(s)),
+                                                report_json_context(lex)));
+                       }
+
+               }
+               else if (lex->strval != NULL)
+               {
+                       if (hi_surrogate != -1)
+                               ereport(ERROR,
+                                               (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
+                                                errmsg("invalid input syntax for type %s", "json"),
+                                                errdetail("Unicode low surrogate must follow a high surrogate."),
+                                                report_json_context(lex)));
+
+                       appendStringInfoChar(lex->strval, *s);
+               }
+
+       }
+
+       if (hi_surrogate != -1)
+               ereport(ERROR,
+                               (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
+                                errmsg("invalid input syntax for type %s", "json"),
+                                errdetail("Unicode low surrogate must follow a high surrogate."),
+                                report_json_context(lex)));
+
+       /* Hooray, we found the end of the string! */
+       lex->prev_token_terminator = lex->token_terminator;
+       lex->token_terminator = s + 1;
+}
+
+/*
+ * The next token in the input stream is known to be a number; lex it.
+ *
+ * In JSON, a number consists of four parts:
+ *
+ * (1) An optional minus sign ('-').
+ *
+ * (2) Either a single '0', or a string of one or more digits that does not
+ *        begin with a '0'.
+ *
+ * (3) An optional decimal part, consisting of a period ('.') followed by
+ *        one or more digits.  (Note: While this part can be omitted
+ *        completely, it's not OK to have only the decimal point without
+ *        any digits afterwards.)
+ *
+ * (4) An optional exponent part, consisting of 'e' or 'E', optionally
+ *        followed by '+' or '-', followed by one or more digits.  (Note:
+ *        As with the decimal part, if 'e' or 'E' is present, it must be
+ *        followed by at least one digit.)
+ *
+ * The 's' argument to this function points to the ostensible beginning
+ * of part 2 - i.e. the character after any optional minus sign, or the
+ * first character of the string if there is none.
+ *
+ * If num_err is not NULL, we return an error flag to *num_err rather than
+ * raising an error for a badly-formed number.  Also, if total_len is not NULL
+ * the distance from lex->input to the token end+1 is returned to *total_len.
+ */
+static inline void
+json_lex_number(JsonLexContext *lex, char *s,
+                               bool *num_err, int *total_len)
+{
+       bool            error = false;
+       int                     len = s - lex->input;
+
+       /* Part (1): leading sign indicator. */
+       /* Caller already did this for us; so do nothing. */
+
+       /* Part (2): parse main digit string. */
+       if (len < lex->input_length && *s == '0')
+       {
+               s++;
+               len++;
+       }
+       else if (len < lex->input_length && *s >= '1' && *s <= '9')
+       {
+               do
+               {
+                       s++;
+                       len++;
+               } while (len < lex->input_length && *s >= '0' && *s <= '9');
+       }
+       else
+               error = true;
+
+       /* Part (3): parse optional decimal portion. */
+       if (len < lex->input_length && *s == '.')
+       {
+               s++;
+               len++;
+               if (len == lex->input_length || *s < '0' || *s > '9')
+                       error = true;
+               else
+               {
+                       do
+                       {
+                               s++;
+                               len++;
+                       } while (len < lex->input_length && *s >= '0' && *s <= '9');
+               }
+       }
+
+       /* Part (4): parse optional exponent. */
+       if (len < lex->input_length && (*s == 'e' || *s == 'E'))
+       {
+               s++;
+               len++;
+               if (len < lex->input_length && (*s == '+' || *s == '-'))
+               {
+                       s++;
+                       len++;
+               }
+               if (len == lex->input_length || *s < '0' || *s > '9')
+                       error = true;
+               else
+               {
+                       do
+                       {
+                               s++;
+                               len++;
+                       } while (len < lex->input_length && *s >= '0' && *s <= '9');
+               }
+       }
+
+       /*
+        * Check for trailing garbage.  As in json_lex(), any alphanumeric stuff
+        * here should be considered part of the token for error-reporting
+        * purposes.
+        */
+       for (; len < lex->input_length && JSON_ALPHANUMERIC_CHAR(*s); s++, len++)
+               error = true;
+
+       if (total_len != NULL)
+               *total_len = len;
+
+       if (num_err != NULL)
+       {
+               /* let the caller handle any error */
+               *num_err = error;
+       }
+       else
+       {
+               /* return token endpoint */
+               lex->prev_token_terminator = lex->token_terminator;
+               lex->token_terminator = s;
+               /* handle error if any */
+               if (error)
+                       report_invalid_token(lex);
+       }
+}
+
+/*
+ * Report a parse error.
+ *
+ * lex->token_start and lex->token_terminator must identify the current token.
+ */
+static void
+report_parse_error(JsonParseContext ctx, JsonLexContext *lex)
+{
+       char       *token;
+       int                     toklen;
+
+       /* Handle case where the input ended prematurely. */
+       if (lex->token_start == NULL || lex->token_type == JSON_TOKEN_END)
+               ereport(ERROR,
+                               (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
+                                errmsg("invalid input syntax for type %s", "json"),
+                                errdetail("The input string ended unexpectedly."),
+                                report_json_context(lex)));
+
+       /* Separate out the current token. */
+       toklen = lex->token_terminator - lex->token_start;
+       token = palloc(toklen + 1);
+       memcpy(token, lex->token_start, toklen);
+       token[toklen] = '\0';
+
+       /* Complain, with the appropriate detail message. */
+       if (ctx == JSON_PARSE_END)
+               ereport(ERROR,
+                               (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
+                                errmsg("invalid input syntax for type %s", "json"),
+                                errdetail("Expected end of input, but found \"%s\".",
+                                                  token),
+                                report_json_context(lex)));
+       else
+       {
+               switch (ctx)
+               {
+                       case JSON_PARSE_VALUE:
+                               ereport(ERROR,
+                                               (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
+                                                errmsg("invalid input syntax for type %s", "json"),
+                                                errdetail("Expected JSON value, but found \"%s\".",
+                                                                  token),
+                                                report_json_context(lex)));
+                               break;
+                       case JSON_PARSE_STRING:
+                               ereport(ERROR,
+                                               (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
+                                                errmsg("invalid input syntax for type %s", "json"),
+                                                errdetail("Expected string, but found \"%s\".",
+                                                                  token),
+                                                report_json_context(lex)));
+                               break;
+                       case JSON_PARSE_ARRAY_START:
+                               ereport(ERROR,
+                                               (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
+                                                errmsg("invalid input syntax for type %s", "json"),
+                                                errdetail("Expected array element or \"]\", but found \"%s\".",
+                                                                  token),
+                                                report_json_context(lex)));
+                               break;
+                       case JSON_PARSE_ARRAY_NEXT:
+                               ereport(ERROR,
+                                               (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
+                                                errmsg("invalid input syntax for type %s", "json"),
+                                                errdetail("Expected \",\" or \"]\", but found \"%s\".",
+                                                                  token),
+                                                report_json_context(lex)));
+                               break;
+                       case JSON_PARSE_OBJECT_START:
+                               ereport(ERROR,
+                                               (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
+                                                errmsg("invalid input syntax for type %s", "json"),
+                                                errdetail("Expected string or \"}\", but found \"%s\".",
+                                                                  token),
+                                                report_json_context(lex)));
+                               break;
+                       case JSON_PARSE_OBJECT_LABEL:
+                               ereport(ERROR,
+                                               (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
+                                                errmsg("invalid input syntax for type %s", "json"),
+                                                errdetail("Expected \":\", but found \"%s\".",
+                                                                  token),
+                                                report_json_context(lex)));
+                               break;
+                       case JSON_PARSE_OBJECT_NEXT:
+                               ereport(ERROR,
+                                               (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
+                                                errmsg("invalid input syntax for type %s", "json"),
+                                                errdetail("Expected \",\" or \"}\", but found \"%s\".",
+                                                                  token),
+                                                report_json_context(lex)));
+                               break;
+                       case JSON_PARSE_OBJECT_COMMA:
+                               ereport(ERROR,
+                                               (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
+                                                errmsg("invalid input syntax for type %s", "json"),
+                                                errdetail("Expected string, but found \"%s\".",
+                                                                  token),
+                                                report_json_context(lex)));
+                               break;
+                       default:
+                               elog(ERROR, "unexpected json parse state: %d", ctx);
+               }
+       }
+}
+
+/*
+ * Report an invalid input token.
+ *
+ * lex->token_start and lex->token_terminator must identify the token.
+ */
+static void
+report_invalid_token(JsonLexContext *lex)
+{
+       char       *token;
+       int                     toklen;
+
+       /* Separate out the offending token. */
+       toklen = lex->token_terminator - lex->token_start;
+       token = palloc(toklen + 1);
+       memcpy(token, lex->token_start, toklen);
+       token[toklen] = '\0';
+
+       ereport(ERROR,
+                       (errcode(ERRCODE_INVALID_TEXT_REPRESENTATION),
+                        errmsg("invalid input syntax for type %s", "json"),
+                        errdetail("Token \"%s\" is invalid.", token),
+                        report_json_context(lex)));
+}
+
+/*
+ * Report a CONTEXT line for bogus JSON input.
+ *
+ * lex->token_terminator must be set to identify the spot where we detected
+ * the error.  Note that lex->token_start might be NULL, in case we recognized
+ * error at EOF.
+ *
+ * The return value isn't meaningful, but we make it non-void so that this
+ * can be invoked inside ereport().
+ */
+static int
+report_json_context(JsonLexContext *lex)
+{
+       const char *context_start;
+       const char *context_end;
+       const char *line_start;
+       int                     line_number;
+       char       *ctxt;
+       int                     ctxtlen;
+       const char *prefix;
+       const char *suffix;
+
+       /* Choose boundaries for the part of the input we will display */
+       context_start = lex->input;
+       context_end = lex->token_terminator;
+       line_start = context_start;
+       line_number = 1;
+       for (;;)
+       {
+               /* Always advance over newlines */
+               if (context_start < context_end && *context_start == '\n')
+               {
+                       context_start++;
+                       line_start = context_start;
+                       line_number++;
+                       continue;
+               }
+               /* Otherwise, done as soon as we are close enough to context_end */
+               if (context_end - context_start < 50)
+                       break;
+               /* Advance to next multibyte character */
+               if (IS_HIGHBIT_SET(*context_start))
+                       context_start += pg_mblen(context_start);
+               else
+                       context_start++;
+       }
+
+       /*
+        * We add "..." to indicate that the excerpt doesn't start at the
+        * beginning of the line ... but if we're within 3 characters of the
+        * beginning of the line, we might as well just show the whole line.
+        */
+       if (context_start - line_start <= 3)
+               context_start = line_start;
+
+       /* Get a null-terminated copy of the data to present */
+       ctxtlen = context_end - context_start;
+       ctxt = palloc(ctxtlen + 1);
+       memcpy(ctxt, context_start, ctxtlen);
+       ctxt[ctxtlen] = '\0';
+
+       /*
+        * Show the context, prefixing "..." if not starting at start of line, and
+        * suffixing "..." if not ending at end of line.
+        */
+       prefix = (context_start > line_start) ? "..." : "";
+       suffix = (lex->token_type != JSON_TOKEN_END && context_end - lex->input < lex->input_length && *context_end != '\n' && *context_end != '\r') ? "..." : "";
+
+       return errcontext("JSON data, line %d: %s%s%s",
+                                         line_number, prefix, ctxt, suffix);
+}
+
+/*
+ * Extract a single, possibly multi-byte char from the input string.
+ */
+static char *
+extract_mb_char(char *s)
+{
+       char       *res;
+       int                     len;
+
+       len = pg_mblen(s);
+       res = palloc(len + 1);
+       memcpy(res, s, len);
+       res[len] = '\0';
+
+       return res;
+}
index 1190947476694619cdab1b18160d8ce844bb43d6..bbca121bb72361208e9dda5de2887e665d04dd4d 100644 (file)
@@ -103,6 +103,9 @@ typedef struct JsonSemAction
  */
 extern void pg_parse_json(JsonLexContext *lex, JsonSemAction *sem);
 
+/* the null action object used for pure validation */
+extern JsonSemAction nullSemAction;
+
 /*
  * json_count_array_elements performs a fast secondary parse to determine the
  * number of elements in passed array lex context. It should be called from an
@@ -124,6 +127,9 @@ extern JsonLexContext *makeJsonLexContextCstringLen(char *json,
                                                                                                        int len,
                                                                                                        bool need_escapes);
 
+/* lex one token */
+extern void json_lex(JsonLexContext *lex);
+
 /*
  * Utility function to check if a string is a valid JSON number.
  *