Module jakarta.json
Package org.glassfish.json

Class JsonParserImpl

  • All Implemented Interfaces:
    JsonParser, Closeable, AutoCloseable
    public class JsonParserImpl
extends Object
implements JsonParser
    JSON parser implementation. NoneContext, ArrayContext, ObjectContext is used to go to next parser state.
    Author:
    Jitendra Kotamraju, Kin-man Chung

    • Method Detail

      • isIntegralNumber

        public boolean isIntegralNumber()
        Description copied from interface: JsonParser
        Returns true if the JSON number at the current parser state is a integral number. A BigDecimal may be used to store the value internally and this method semantics are defined using its scale(). If the scale is zero, then it is considered integral type. This integral type information can be used to invoke an appropriate accessor method to obtain a numeric value as in the following example: 
         
 JsonParser parser = ...
 if (parser.isIntegralNumber()) {
     parser.getInt();     // or other methods to get integral value
 } else {
     parser.getBigDecimal();
 }
        Specified by:
        isIntegralNumber in interface JsonParser
        Returns:
        true if this number is a integral number, otherwise false

      • getInt

        public int getInt()
        Description copied from interface: JsonParser
        Returns a JSON number as an integer. The returned value is equal to new BigDecimal(getString()).intValue(). Note that this conversion can lose information about the overall magnitude and precision of the number value as well as return a result with the opposite sign. This method should only be called when the parser state is JsonParser.Event.VALUE_NUMBER.
        Specified by:
        getInt in interface JsonParser
        Returns:
        an integer for a JSON number
        See Also:
        BigDecimal.intValue()

      • getLong

        public long getLong()
        Description copied from interface: JsonParser
        Returns a JSON number as a long. The returned value is equal to new BigDecimal(getString()).longValue(). Note that this conversion can lose information about the overall magnitude and precision of the number value as well as return a result with the opposite sign. This method is only called when the parser state is JsonParser.Event.VALUE_NUMBER.
        Specified by:
        getLong in interface JsonParser
        Returns:
        a long for a JSON number
        See Also:
        BigDecimal.longValue()

      • getBigDecimal

        public BigDecimal getBigDecimal()
        Description copied from interface: JsonParser
        Returns a JSON number as a BigDecimal. The BigDecimal is created using new BigDecimal(getString()). This method should only called when the parser state is JsonParser.Event.VALUE_NUMBER.
        Specified by:
        getBigDecimal in interface JsonParser
        Returns:
        a BigDecimal for a JSON number

      • getArray

        public JsonArray getArray()
        Description copied from interface: JsonParser
        Returns a JsonArray and advance the parser to the the corresponding END_ARRAY.
        Specified by:
        getArray in interface JsonParser
        Returns:
        the JsonArray at the current parser position

      • getObject

        public JsonObject getObject()
        Description copied from interface: JsonParser
        Returns a JsonObject and advances the parser to the corresponding END_OBJECT.
        Specified by:
        getObject in interface JsonParser
        Returns:
        the JsonObject at the current parser position

      • getValue

        public JsonValue getValue()
        Description copied from interface: JsonParser
        Returns a JsonValue at the current parser position. If the parser state is START_ARRAY, the behavior is the same as JsonParser.getArray(). If the parser state is START_OBJECT, the behavior is the same as JsonParser.getObject(). For all other cases, if applicable, the JSON value is read and returned.
        Specified by:
        getValue in interface JsonParser
        Returns:
        the JsonValue at the current parser position.

      • getArrayStream

        public Stream<JsonValue> getArrayStream()
        Description copied from interface: JsonParser
        Returns a stream of the JsonArray elements. The parser state must be START_ARRAY. The elements are read lazily, on an as-needed basis, as required by the stream operations. If the stream operations do not consume all of the array elements, JsonParser.skipArray() can be used to skip the unprocessed array elements.
        Specified by:
        getArrayStream in interface JsonParser
        Returns:
        a stream of elements of the JsonArray

      • getObjectStream

        public Stream<Map.Entry<String,​JsonValue>> getObjectStream()
        Description copied from interface: JsonParser
        Returns a stream of the JsonObject's name/value pairs. The parser state must be START_OBJECT. The name/value pairs are read lazily, on an as-needed basis, as required by the stream operations. If the stream operations do not consume all of the object's name/value pairs, JsonParser.skipObject() can be used to skip the unprocessed elements.
        Specified by:
        getObjectStream in interface JsonParser
        Returns:
        a stream of name/value pairs of the JsonObject

      • getValueStream

        public Stream<JsonValue> getValueStream()
        Description copied from interface: JsonParser
        Returns a stream of JsonValue from a sequence of JSON values. The values are read lazily, on an as-needed basis, as needed by the stream operations.
        Specified by:
        getValueStream in interface JsonParser
        Returns:
        a Stream of JsonValue

      • skipArray

        public void skipArray()
        Description copied from interface: JsonParser
        Advance the parser to END_ARRAY. If the parser is in array context, i.e. it has previously encountered a START_ARRAY without encountering the corresponding END_ARRAY, the parser is advanced to the corresponding END_ARRAY. If the parser is not in any array context, nothing happens.
        Specified by:
        skipArray in interface JsonParser

      • skipObject

        public void skipObject()
        Description copied from interface: JsonParser
        Advance the parser to END_OBJECT. If the parser is in object context, i.e. it has previously encountered a START_OBJECT without encountering the corresponding END_OBJECT, the parser is advanced to the corresponding END_OBJECT. If the parser is not in any object context, nothing happens.
        Specified by:
        skipObject in interface JsonParser

      • getLocation

        public JsonLocation getLocation()
        Description copied from interface: JsonParser
        Return the location that corresponds to the parser's current state in the JSON input source. The location information is only valid in the current parser state (or until the parser is advanced to a next state).
        Specified by:
        getLocation in interface JsonParser
        Returns:
        a non-null location corresponding to the current parser state in JSON input source

      • getLastCharLocation

        public JsonLocation getLastCharLocation()

      • hasNext

        public boolean hasNext()
        Description copied from interface: JsonParser
        Returns true if there are more parsing states. This method returns false if the parser reaches the end of the JSON text.
        Specified by:
        hasNext in interface JsonParser
        Returns:
        true if there are more parsing states.

      • next

        public JsonParser.Event next()
        Description copied from interface: JsonParser
        Returns the event for the next parsing state.
        Specified by:
        next in interface JsonParser
        Returns:
        the event for the next parsing state

      • close

        public void close()
        Description copied from interface: JsonParser
        Closes this parser and frees any resources associated with the parser. This method closes the underlying input source.
        Specified by:
        close in interface AutoCloseable
        Specified by:
        close in interface Closeable
        Specified by:
        close in interface JsonParser