Class JsonParserBase

All Implemented Interfaces:
Versioned, Closeable, AutoCloseable
Direct Known Subclasses:
NonBlockingJsonParserBase, ReaderBasedJsonParser, UTF8DataInputJsonParser, UTF8StreamJsonParser

public abstract class JsonParserBase extends ParserBase
Another intermediate base class, only used by actual JSON-backed parser implementations.
Since:
2.17
  • Method Details

    • getCodec

      public ObjectCodec getCodec()
      Description copied from class: JsonParser
      Accessor for ObjectCodec associated with this parser, if any. Codec is used by JsonParser.readValueAs(Class) method (and its variants).
      Specified by:
      getCodec in class JsonParser
      Returns:
      Codec assigned to this parser, if any; null if none
    • setCodec

      public void setCodec(ObjectCodec c)
      Description copied from class: JsonParser
      Setter that allows defining ObjectCodec associated with this parser, if any. Codec is used by JsonParser.readValueAs(Class) method (and its variants).
      Specified by:
      setCodec in class JsonParser
      Parameters:
      c - Codec to assign, if any; null if none
    • getReadCapabilities

      public final JacksonFeatureSet<StreamReadCapability> getReadCapabilities()
      Description copied from class: JsonParser
      Accessor for getting metadata on capabilities of this parser, based on underlying data format being read (directly or indirectly).
      Overrides:
      getReadCapabilities in class JsonParser
      Returns:
      Set of read capabilities for content to read via this parser
    • getNumberTypeFP

      public JsonParser.NumberTypeFP getNumberTypeFP() throws IOException
      JSON format does not have native information on "correct" floating-point type to use, unlike some formats (most binary formats), so it needs to indicate this as JsonParser.NumberTypeFP.UNKNOWN.
      Overrides:
      getNumberTypeFP in class JsonParser
      Returns:
      Natural floating-point type if known; JsonParser.NumberTypeFP.UNKNOWN for all JSON-backed parsers.
      Throws:
      IOException - for low-level read issues, or JsonParseException for decoding problems
    • currentLocation

      public abstract JsonLocation currentLocation()
      Description copied from class: JsonParser
      Method that returns location of the last processed input unit (character or byte) from the input; usually for error reporting purposes.

      Note that the location is not guaranteed to be accurate (although most implementation will try their best): some implementations may only report specific boundary locations (start or end locations of tokens) and others only return JsonLocation.NA due to not having access to input location information (when delegating actual decoding work to other library)

      Overrides:
      currentLocation in class JsonParser
      Returns:
      Location of the last processed input unit (byte or character)
    • currentTokenLocation

      public abstract JsonLocation currentTokenLocation()
      Description copied from class: JsonParser
      Method that return the starting location of the current (most recently returned) token; that is, the position of the first input unit (character or byte) from input that starts the current token.

      Note that the location is not guaranteed to be accurate (although most implementation will try their best): some implementations may only return JsonLocation.NA due to not having access to input location information (when delegating actual decoding work to other library)

      Overrides:
      currentTokenLocation in class JsonParser
      Returns:
      Starting location of the token parser currently points to
    • getCurrentLocation

      @Deprecated public final JsonLocation getCurrentLocation()
      Deprecated.
      Description copied from class: ParserBase
      Method that returns location of the last processed character; usually for error reporting purposes
      Overrides:
      getCurrentLocation in class ParserBase
      Returns:
      Location of the last processed input unit (byte or character)
    • getTokenLocation

      @Deprecated public final JsonLocation getTokenLocation()
      Deprecated.
      Description copied from class: ParserBase
      Method that return the starting location of the current token; that is, position of the first character from input that starts the current token.
      Overrides:
      getTokenLocation in class ParserBase
      Returns:
      Starting location of the token parser currently points to