Package org.noggit

Class JSONParser

java.lang.Object
org.noggit.JSONParser
Direct Known Subclasses:
JSONParserWS
public class JSONParser extends Object
Version:
$Id: JSONParser.java 1099557 2011-05-04 18:54:26Z yonik $
Author:
yonik

  • Field Details

    • STRING

      public static final int STRING
      Event indicating a JSON string value, including member names of objects
      See Also:

    • LONG

      public static final int LONG
      Event indicating a JSON number value which fits into a signed 64 bit integer
      See Also:

    • NUMBER

      public static final int NUMBER
      Event indicating a JSON number value which has a fractional part or an exponent and with string length invalid input: '<'= 23 chars not including sign. This covers all representations of normal values for Double.toString().
      See Also:

    • BIGNUMBER

      public static final int BIGNUMBER
      Event indicating a JSON number value that was not produced by toString of any Java primitive numerics such as Double or Long. It is either an integer outside the range of a 64 bit signed integer, or a floating point value with a string representation of more than 23 chars.
      See Also:

    • BOOLEAN

      public static final int BOOLEAN
      Event indicating a JSON boolean
      See Also:

    • NULL

      public static final int NULL
      Event indicating a JSON null
      See Also:

    • OBJECT_START

      public static final int OBJECT_START
      Event indicating the start of a JSON object
      See Also:

    • OBJECT_END

      public static final int OBJECT_END
      Event indicating the end of a JSON object
      See Also:

    • ARRAY_START

      public static final int ARRAY_START
      Event indicating the start of a JSON array
      See Also:

    • ARRAY_END

      public static final int ARRAY_END
      Event indicating the end of a JSON array
      See Also:

    • EOF

      public static final int EOF
      Event indicating the end of input has been reached
      See Also:

    • ALLOW_COMMENTS

      public static final int ALLOW_COMMENTS
      Flags to control parsing behavior
      See Also:

    • ALLOW_SINGLE_QUOTES

      public static final int ALLOW_SINGLE_QUOTES
      See Also:

    • ALLOW_BACKSLASH_ESCAPING_ANY_CHARACTER

      public static final int ALLOW_BACKSLASH_ESCAPING_ANY_CHARACTER
      See Also:

    • ALLOW_UNQUOTED_KEYS

      public static final int ALLOW_UNQUOTED_KEYS
      See Also:

    • ALLOW_UNQUOTED_STRING_VALUES

      public static final int ALLOW_UNQUOTED_STRING_VALUES
      See Also:

    • ALLOW_EXTRA_COMMAS

      public static final int ALLOW_EXTRA_COMMAS
      ALLOW_EXTRA_COMMAS causes any number of extra commas in arrays and objects to be ignored Note that a trailing comma in [] would be [,] (hence calling the feature "trailing" commas is either limiting or misleading. Since trailing commas is fundamentally incompatible with any future "fill-in-missing-values-with-null", it was decided to extend this feature to handle any number of extra commas.
      See Also:

    • ALLOW_MISSING_COLON_COMMA_BEFORE_OBJECT

      public static final int ALLOW_MISSING_COLON_COMMA_BEFORE_OBJECT
      See Also:

    • OPTIONAL_OUTER_BRACES

      public static final int OPTIONAL_OUTER_BRACES
      See Also:

    • FLAGS_STRICT

      public static final int FLAGS_STRICT
      See Also:

    • FLAGS_DEFAULT

      public static final int FLAGS_DEFAULT
      See Also:

    • flags

      protected int flags

    • buf

      protected final char[] buf

    • start

      protected int start

    • end

      protected int end

    • in

      protected final Reader in

    • eof

      protected boolean eof

    • gpos

      protected long gpos

    • event

      protected int event

    • stringTerm

      protected int stringTerm

    • missingOpeningBrace

      protected boolean missingOpeningBrace

  • Constructor Details

    • JSONParser

      public JSONParser(Reader in)

    • JSONParser

      public JSONParser(Reader in, char[] buffer)

    • JSONParser

      public JSONParser(char[] data, int start, int end)

    • JSONParser

      public JSONParser(String data)

    • JSONParser

      public JSONParser(String data, int start, int end)

  • Method Details

    • getEventString

      public static String getEventString(int e)

    • getFlags

      public int getFlags()

    • setFlags

      public int setFlags(int flags)

    • fill

      protected void fill() throws IOException
      Throws:
      IOException

    • getChar

      protected int getChar() throws IOException
      Throws:
      IOException

    • isWhitespace

      protected static final boolean isWhitespace(int ch)
      Returns true if the given character is considered to be whitespace. One difference between Java's Character.isWhitespace() is that this method considers a hard space (non-breaking space, or nbsp) to be whitespace.

    • getCharNWS

      protected int getCharNWS() throws IOException
      Throws:
      IOException

    • getCharNWS

      protected int getCharNWS(int ch) throws IOException
      Throws:
      IOException

    • getCharExpected

      protected int getCharExpected(int expected) throws IOException
      Throws:
      IOException

    • getNewlineComment

      protected void getNewlineComment() throws IOException
      Throws:
      IOException

    • getSlashComment

      protected void getSlashComment() throws IOException
      Throws:
      IOException

    • matchBareWord

      protected boolean matchBareWord(char[] arr) throws IOException
      Throws:
      IOException

    • err

      protected JSONParser.ParseException err(String msg)

    • handleNonDoubleQuoteString

      protected void handleNonDoubleQuoteString(int ch, boolean isName) throws IOException
      Throws:
      IOException

    • toString

      public String toString()
      Overrides:
      toString in class Object

    • nextEvent

      public int nextEvent() throws IOException
      Returns the next event encountered in the JSON stream, one of
      Throws:
      IOException

    • lastEvent

      public int lastEvent()

    • wasKey

      public boolean wasKey()

    • getString

      public String getString() throws IOException
      Returns the JSON string value, decoding any escaped characters.
      Throws:
      IOException

    • getStringChars

      public CharArr getStringChars() throws IOException
      Returns the characters of a JSON string value, decoding any escaped characters.

      The underlying buffer of the returned CharArr should *not* be modified as it may be shared with the input buffer.

      The returned CharArr will only be valid up until the next JSONParser method is called. Any required data should be read before that point.

      Throws:
      IOException

    • getString

      public void getString(CharArr output) throws IOException
      Reads a JSON string into the output, decoding any escaped characters.
      Throws:
      IOException

    • getLong

      public long getLong() throws IOException
      Reads a number from the input stream and parses it as a long, only if the value will in fact fit into a signed 64 bit integer.
      Throws:
      IOException

    • getDouble

      public double getDouble() throws IOException
      Reads a number from the input stream and parses it as a double
      Throws:
      IOException

    • getNumberChars

      public CharArr getNumberChars() throws IOException
      Returns the characters of a JSON numeric value.

      The underlying buffer of the returned CharArr should *not* be modified as it may be shared with the input buffer.

      The returned CharArr will only be valid up until the next JSONParser method is called. Any required data should be read before that point.

      Throws:
      IOException

    • getNumberChars

      public void getNumberChars(CharArr output) throws IOException
      Reads a JSON numeric value into the output.
      Throws:
      IOException

    • getBoolean

      public boolean getBoolean() throws IOException
      Reads a boolean value
      Throws:
      IOException

    • getNull

      public void getNull() throws IOException
      Reads a null value
      Throws:
      IOException

    • getLevel

      public int getLevel()
      Returns:
      the current nesting level, the number of parent objects or arrays.

    • getPosition

      public long getPosition()