Class NonBlockingUtf8JsonParserBase
java.lang.Object
com.fasterxml.jackson.core.JsonParser
com.fasterxml.jackson.core.base.ParserMinimalBase
com.fasterxml.jackson.core.base.ParserBase
com.fasterxml.jackson.core.json.JsonParserBase
com.fasterxml.jackson.core.json.async.NonBlockingJsonParserBase
com.fasterxml.jackson.core.json.async.NonBlockingUtf8JsonParserBase
- All Implemented Interfaces:
Versioned,Closeable,AutoCloseable
- Direct Known Subclasses:
NonBlockingByteBufferJsonParser,NonBlockingJsonParser
Non-blocking parser base implementation for JSON content.
NOTE: only supports parsing of UTF-8 encoded content (and 7-bit US-ASCII since it is strict subset of UTF-8): other encodings are not supported.
- Since:
- 2.9
-
Nested Class Summary
Nested classes/interfaces inherited from class com.fasterxml.jackson.core.JsonParser
JsonParser.Feature, JsonParser.NumberType, JsonParser.NumberTypeFP -
Field Summary
FieldsModifier and TypeFieldDescriptionprotected static final int[]private static final int[]protected intIn addition to current buffer pointer, and end pointer, we will also need to know number of bytes originally contained.private static final intprivate static final intprivate static final intprivate static final intprivate static final intprivate static final intprivate static final intFields inherited from class com.fasterxml.jackson.core.json.async.NonBlockingJsonParserBase
_currBufferStart, _currInputRowAlt, _endOfInput, _majorState, _majorStateAfterValue, _minorState, _minorStateAfterSplit, _nonStdTokenType, _pending32, _pendingBytes, _quad1, _quadBuffer, _quadLength, _quoted32, _quotedDigits, _symbols, MAJOR_ARRAY_ELEMENT_FIRST, MAJOR_ARRAY_ELEMENT_NEXT, MAJOR_CLOSED, MAJOR_INITIAL, MAJOR_OBJECT_FIELD_FIRST, MAJOR_OBJECT_FIELD_NEXT, MAJOR_OBJECT_VALUE, MAJOR_ROOT, MINOR_COMMENT_C, MINOR_COMMENT_CLOSING_ASTERISK, MINOR_COMMENT_CPP, MINOR_COMMENT_LEADING_SLASH, MINOR_COMMENT_YAML, MINOR_FIELD_APOS_NAME, MINOR_FIELD_LEADING_COMMA, MINOR_FIELD_LEADING_WS, MINOR_FIELD_NAME, MINOR_FIELD_NAME_ESCAPE, MINOR_FIELD_UNQUOTED_NAME, MINOR_NUMBER_EXPONENT_DIGITS, MINOR_NUMBER_EXPONENT_MARKER, MINOR_NUMBER_FRACTION_DIGITS, MINOR_NUMBER_INTEGER_DIGITS, MINOR_NUMBER_MINUS, MINOR_NUMBER_MINUSZERO, MINOR_NUMBER_PLUS, MINOR_NUMBER_ZERO, MINOR_ROOT_BOM, MINOR_ROOT_GOT_SEPARATOR, MINOR_ROOT_NEED_SEPARATOR, MINOR_VALUE_APOS_STRING, MINOR_VALUE_EXPECTING_COLON, MINOR_VALUE_EXPECTING_COMMA, MINOR_VALUE_LEADING_WS, MINOR_VALUE_STRING, MINOR_VALUE_STRING_ESCAPE, MINOR_VALUE_STRING_UTF8_2, MINOR_VALUE_STRING_UTF8_3, MINOR_VALUE_STRING_UTF8_4, MINOR_VALUE_TOKEN_ERROR, MINOR_VALUE_TOKEN_FALSE, MINOR_VALUE_TOKEN_NON_STD, MINOR_VALUE_TOKEN_NULL, MINOR_VALUE_TOKEN_TRUE, MINOR_VALUE_WS_AFTER_COMMA, NON_STD_TOKEN_INFINITY, NON_STD_TOKEN_MINUS_INFINITY, NON_STD_TOKEN_NAN, NON_STD_TOKEN_PLUS_INFINITY, NON_STD_TOKEN_VALUES, NON_STD_TOKENSFields inherited from class com.fasterxml.jackson.core.json.JsonParserBase
_objectCodec, FEAT_MASK_NON_NUM_NUMBERS, INPUT_CODES_LATIN1, INPUT_CODES_UTF8Fields inherited from class com.fasterxml.jackson.core.base.ParserBase
_binaryValue, _byteArrayBuilder, _closed, _currInputProcessed, _currInputRow, _currInputRowStart, _expLength, _fractLength, _inputEnd, _inputPtr, _intLength, _ioContext, _nameCopied, _nameCopyBuffer, _nextToken, _numberBigDecimal, _numberBigInt, _numberDouble, _numberFloat, _numberInt, _numberIsNaN, _numberLong, _numberNegative, _numberString, _numTypesValid, _parsingContext, _textBuffer, _tokenInputCol, _tokenInputRow, _tokenInputTotal, JSON_READ_CAPABILITIESFields inherited from class com.fasterxml.jackson.core.base.ParserMinimalBase
_currToken, _lastClearedToken, _streamReadConstraints, _tokenCount, _trackMaxTokenCount, BD_MAX_INT, BD_MAX_LONG, BD_MIN_INT, BD_MIN_LONG, BI_MAX_INT, BI_MAX_LONG, BI_MIN_INT, BI_MIN_LONG, CHAR_NULL, INT_0, INT_9, INT_APOS, INT_ASTERISK, INT_BACKSLASH, INT_COLON, INT_COMMA, INT_CR, INT_e, INT_E, INT_HASH, INT_LBRACKET, INT_LCURLY, INT_LF, INT_MINUS, INT_PERIOD, INT_PLUS, INT_QUOTE, INT_RBRACKET, INT_RCURLY, INT_SLASH, INT_SPACE, INT_TAB, MAX_ERROR_TOKEN_LENGTH, MAX_INT_D, MAX_INT_L, MAX_LONG_D, MIN_INT_D, MIN_INT_L, MIN_LONG_D, NO_BYTES, NO_INTS, NR_BIGDECIMAL, NR_BIGINT, NR_DOUBLE, NR_FLOAT, NR_INT, NR_LONG, NR_UNKNOWNFields inherited from class com.fasterxml.jackson.core.JsonParser
_features, _requestPayload, DEFAULT_READ_CAPABILITIES -
Constructor Summary
ConstructorsModifierConstructorDescriptionprotectedNonBlockingUtf8JsonParserBase(IOContext ctxt, int parserFeatures, ByteQuadsCanonicalizer sym) -
Method Summary
Modifier and TypeMethodDescriptionprivate final intprotected charMethod that sub-classes must implement to support escaped sequences in base64-encoded sections.private final intprivate int_decodeSplitEscaped(int value, int bytesRead) private final boolean_decodeSplitMultiByte(int c, int type, boolean gotNext) private final boolean_decodeSplitUTF8_3(int prev, int prevCount, int next) private final boolean_decodeSplitUTF8_4(int prev, int prevCount, int next) private final int_decodeUTF8_2(int c, int d) private final int_decodeUTF8_3(int c, int d, int e) private final int_decodeUTF8_4(int c, int d, int e, int f) private final Stringprivate JsonToken_finishAposName(int qlen, int currQuad, int currQuadBytes) private final JsonTokenprivate final JsonToken_finishBOM(int bytesHandled) private final JsonToken_finishCComment(int fromMinorState, boolean gotStar) private final JsonToken_finishCppComment(int fromMinorState) protected JsonTokenprotected JsonTokenprotected final JsonTokenprotected JsonToken_finishFloatExponent(boolean checkSign, int ch) protected JsonTokenprivate final JsonToken_finishHashComment(int fromMinorState) protected JsonToken_finishKeywordToken(String expToken, int matched, JsonToken result) protected JsonToken_finishKeywordTokenWithEOF(String expToken, int matched, JsonToken result) protected JsonToken_finishNonStdToken(int type, int matched) protected JsonToken_finishNonStdTokenWithEOF(int type, int matched) protected JsonToken_finishNumberIntegralPart(char[] outBuf, int outPtr) protected JsonTokenprotected JsonToken_finishNumberLeadingPosNegZeroes(boolean negative) protected JsonTokenprotected JsonTokenprotected JsonToken_finishNumberMinus(int ch) protected JsonToken_finishNumberPlus(int ch) protected JsonToken_finishNumberPlusMinus(int ch, boolean negative) private final JsonTokenprotected final JsonTokenMethod called when decoding of a token has been started, but not yet completed due to missing input; method is to continue decoding due to at least one more byte being made available to decode.protected final JsonTokenMethod similar to_finishToken(), but called when no more input is available, and end-of-input has been detected.private JsonToken_finishUnquotedName(int qlen, int currQuad, int currQuadBytes) Parsing of optionally supported non-standard "unquoted" names: names without either double-quotes or apostrophes surrounding them.private JsonToken_handleOddName(int ch) Method called when we see non-white space character other than double quote, when expecting a field name.private final JsonToken_parseEscapedName(int qlen, int currQuad, int currQuadBytes) Slower parsing method which is generally branched to when an escape sequence is detected (or alternatively for long names, one crossing input buffer boundary).private final String_parseMediumName(int ptr, int q2) private final String_parseMediumName2(int ptr, int q3, int q2) protected JsonToken_reportErrorToken(String actualToken) private final int_skipWS(int ch) private final JsonToken_startAfterComment(int fromMinorState) protected JsonTokenprivate final JsonToken_startDocument(int ch) protected JsonTokenprivate final JsonToken_startFieldName(int ch) Method that handles initial token type recognition for token that has to be either FIELD_NAME or END_OBJECT.private final JsonToken_startFieldNameAfterComma(int ch) protected JsonToken_startFloat(char[] outBuf, int outPtr, int ch) protected JsonTokenprotected JsonTokenprotected JsonTokenprotected JsonTokenprotected JsonTokenprotected JsonToken_startPositiveNumber(int ch) private final JsonToken_startSlashComment(int fromMinorState) protected JsonTokenprotected JsonTokenprotected JsonToken_startUnexpectedValue(boolean leadingComma, int ch) private final JsonToken_startValue(int ch) Helper method called to detect type of a value token (at any level), and possibly decode it if contained in input buffer.private final JsonToken_startValueAfterComma(int ch) private final JsonToken_startValueExpectColon(int ch) private final JsonToken_startValueExpectComma(int ch) voidprotected abstract bytegetByteFromBuffer(int ptr) protected abstract byteprotected abstract intfinal booleanMain iteration method, which will advance stream enough to determine type of the next token, if any.Methods inherited from class com.fasterxml.jackson.core.json.async.NonBlockingJsonParserBase
_addName, _closeArrayScope, _closeInput, _closeObjectScope, _currentLocationMinusOne, _eofAsNextToken, _fieldComplete, _findName, _findName, _findName, _getText2, _nonStdToken, _padLastQuad, _releaseBuffers, _reportInvalidChar, _reportInvalidInitial, _reportInvalidOther, _reportInvalidOther, _startArrayScope, _startObjectScope, _updateTokenLocation, _valueComplete, _valueCompleteInt, _valueNonStdNumberComplete, canParseAsync, currentLocation, currentTokenLocation, getBinaryValue, getEmbeddedObject, getInputSource, getText, getText, getTextCharacters, getTextLength, getTextOffset, getValueAsString, getValueAsString, hasTextCharacters, readBinaryValue, releaseBuffered, setCodec, symbolTableForTestsMethods inherited from class com.fasterxml.jackson.core.json.JsonParserBase
getCodec, getCurrentLocation, getNumberTypeFP, getReadCapabilities, getTokenLocationMethods inherited from class com.fasterxml.jackson.core.base.ParserBase
_checkStdFeatureChanges, _contentReference, _contentReferenceRedacted, _convertBigDecimalToBigInteger, _decodeBase64Escape, _decodeBase64Escape, _eofAsNextChar, _finishString, _getBigDecimal, _getBigInteger, _getByteArrayBuilder, _getNumberDouble, _getNumberFloat, _getSourceReference, _growNameDecodeBuffer, _handleBase64MissingPadding, _handleEOF, _handleUnrecognizedCharacterEscape, _parseIntValue, _parseNumericValue, _reportMismatchedEndMarker, _reportTooLongIntegral, _throwUnquotedSpace, _validJsonTokenList, _validJsonValueList, assignCurrentValue, close, convertNumberToBigDecimal, convertNumberToBigInteger, convertNumberToDouble, convertNumberToFloat, convertNumberToInt, convertNumberToLong, createChildArrayContext, createChildObjectContext, currentValue, disable, enable, getBigIntegerValue, getCurrentName, getDecimalValue, getDoubleValue, getFloatValue, getIntValue, getLongValue, getNumberType, getNumberValue, getNumberValueDeferred, getNumberValueExact, getParsingContext, getTokenCharacterOffset, getTokenColumnNr, getTokenLineNr, growArrayBy, isClosed, isNaN, loadMore, loadMoreGuaranteed, overrideCurrentName, overrideStdFeatures, reportInvalidBase64Char, reportInvalidBase64Char, reset, resetAsNaN, resetFloat, resetInt, setFeatureMask, versionMethods inherited from class com.fasterxml.jackson.core.base.ParserMinimalBase
_ascii, _asciiBytes, _constructError, _decodeBase64, _getCharDesc, _hasTextualNull, _longIntegerDesc, _longNumberDesc, _nullSafeUpdateToken, _reportError, _reportError, _reportError, _reportInputCoercion, _reportInvalidEOF, _reportInvalidEOF, _reportInvalidEOFInValue, _reportMissingRootWS, _reportUnexpectedChar, _reportUnexpectedNumberChar, _throwInternal, _throwInternalReturnAny, _throwInvalidSpace, _updateToken, _updateTokenToNA, _updateTokenToNull, _wrapError, clearCurrentToken, currentToken, currentTokenCount, currentTokenId, getCurrentToken, getCurrentTokenId, getLastClearedToken, getValueAsBoolean, getValueAsDouble, getValueAsInt, getValueAsInt, getValueAsLong, getValueAsLong, hasCurrentToken, hasToken, hasTokenId, isExpectedNumberIntToken, isExpectedStartArrayToken, isExpectedStartObjectToken, nextValue, reportInvalidNumber, reportOverflowInt, reportOverflowInt, reportOverflowInt, reportOverflowLong, reportOverflowLong, reportOverflowLong, reportUnexpectedNumberChar, skipChildren, streamReadConstraintsMethods inherited from class com.fasterxml.jackson.core.JsonParser
_codec, _constructError, _constructReadException, _constructReadException, _constructReadException, _constructReadException, _constructReadException, _constructReadException, _reportUnsupportedOperation, canReadObjectId, canReadTypeId, canUseSchema, configure, currentName, finishToken, getBinaryValue, getBooleanValue, getByteValue, getCurrentValue, getFeatureMask, getFormatFeatures, getNonBlockingInputFeeder, getObjectId, getSchema, getShortValue, getTypeId, getValueAsBoolean, getValueAsDouble, isEnabled, isEnabled, nextBooleanValue, nextFieldName, nextFieldName, nextIntValue, nextLongValue, nextTextValue, overrideFormatFeatures, readBinaryValue, readValueAs, readValueAs, readValueAsTree, readValuesAs, readValuesAs, releaseBuffered, requiresCustomCodec, setCurrentValue, setRequestPayloadOnError, setRequestPayloadOnError, setRequestPayloadOnError, setSchema
-
Field Details
-
FEAT_MASK_TRAILING_COMMA
private static final int FEAT_MASK_TRAILING_COMMA -
FEAT_MASK_LEADING_ZEROS
private static final int FEAT_MASK_LEADING_ZEROS -
FEAT_MASK_ALLOW_MISSING
private static final int FEAT_MASK_ALLOW_MISSING -
FEAT_MASK_ALLOW_SINGLE_QUOTES
private static final int FEAT_MASK_ALLOW_SINGLE_QUOTES -
FEAT_MASK_ALLOW_UNQUOTED_NAMES
private static final int FEAT_MASK_ALLOW_UNQUOTED_NAMES -
FEAT_MASK_ALLOW_JAVA_COMMENTS
private static final int FEAT_MASK_ALLOW_JAVA_COMMENTS -
FEAT_MASK_ALLOW_YAML_COMMENTS
private static final int FEAT_MASK_ALLOW_YAML_COMMENTS -
_icUTF8
private static final int[] _icUTF8 -
_icLatin1
protected static final int[] _icLatin1 -
_origBufferLen
protected int _origBufferLenIn addition to current buffer pointer, and end pointer, we will also need to know number of bytes originally contained. This is needed to correctly update location information when the block has been completed.
-
-
Constructor Details
-
NonBlockingUtf8JsonParserBase
protected NonBlockingUtf8JsonParserBase(IOContext ctxt, int parserFeatures, ByteQuadsCanonicalizer sym)
-
-
Method Details
-
needMoreInput
public final boolean needMoreInput() -
endOfInput
public void endOfInput() -
_decodeEscaped
Description copied from class:ParserBaseMethod that sub-classes must implement to support escaped sequences in base64-encoded sections. Sub-classes that do not need base64 support can leave this as is- Overrides:
_decodeEscapedin classParserBase- Returns:
- Character decoded, if any
- Throws:
IOException- If escape decoding fails
-
nextToken
Description copied from class:JsonParserMain iteration method, which will advance stream enough to determine type of the next token, if any. If none remaining (stream has no content other than possible white space before ending), null will be returned.- Specified by:
nextTokenin classParserMinimalBase- Returns:
- Next token from the stream, if any found, or null to indicate end-of-input
- Throws:
IOException- for low-level read issues, orJsonParseExceptionfor decoding problems
-
getNextSignedByteFromBuffer
protected abstract byte getNextSignedByteFromBuffer()- Returns:
- next signed byte from the buffer
- Since:
- v2.14
-
getNextUnsignedByteFromBuffer
protected abstract int getNextUnsignedByteFromBuffer()- Returns:
- next unsigned byte from the buffer
- Since:
- v2.14
-
getByteFromBuffer
protected abstract byte getByteFromBuffer(int ptr) - Parameters:
ptr- pointer to byte that is required- Returns:
- byte from the buffer at the given pointer
- Since:
- v2.14
-
_finishToken
Method called when decoding of a token has been started, but not yet completed due to missing input; method is to continue decoding due to at least one more byte being made available to decode.- Returns:
- Token decoded, if complete;
JsonToken.NOT_AVAILABLEif not - Throws:
IOException- (generallyJsonParseException) for decoding problems
-
_finishTokenWithEOF
Method similar to_finishToken(), but called when no more input is available, and end-of-input has been detected. This is usually problem case, but not always: root-level values may be properly terminated by this, and similarly trailing white-space may have been skipped.- Returns:
- Token decoded, if complete;
JsonToken.NOT_AVAILABLEif not - Throws:
IOException- (generallyJsonParseException) for decoding problems
-
_startDocument
- Throws:
IOException
-
_finishBOM
- Throws:
IOException
-
_startFieldName
Method that handles initial token type recognition for token that has to be either FIELD_NAME or END_OBJECT.- Throws:
IOException
-
_startFieldNameAfterComma
- Throws:
IOException
-
_startValue
Helper method called to detect type of a value token (at any level), and possibly decode it if contained in input buffer. Value may be preceded by leading white-space, but no separator (comma).- Throws:
IOException
-
_startValueExpectComma
- Throws:
IOException
-
_startValueExpectColon
- Throws:
IOException
-
_startValueAfterComma
- Throws:
IOException
-
_startUnexpectedValue
- Throws:
IOException
-
_skipWS
- Throws:
IOException
-
_startSlashComment
- Throws:
IOException
-
_finishHashComment
- Throws:
IOException
-
_finishCppComment
- Throws:
IOException
-
_finishCComment
- Throws:
IOException
-
_startAfterComment
- Throws:
IOException
-
_startFalseToken
- Throws:
IOException
-
_startTrueToken
- Throws:
IOException
-
_startNullToken
- Throws:
IOException
-
_finishKeywordToken
protected JsonToken _finishKeywordToken(String expToken, int matched, JsonToken result) throws IOException - Throws:
IOException
-
_finishKeywordTokenWithEOF
protected JsonToken _finishKeywordTokenWithEOF(String expToken, int matched, JsonToken result) throws IOException - Throws:
IOException
-
_finishNonStdToken
- Throws:
IOException
-
_finishNonStdTokenWithEOF
- Throws:
IOException
-
_finishErrorToken
- Throws:
IOException
-
_finishErrorTokenWithEOF
- Throws:
IOException
-
_reportErrorToken
- Throws:
IOException
-
_startFloatThatStartsWithPeriod
- Throws:
IOException
-
_startPositiveNumber
- Throws:
IOException
-
_startNegativeNumber
- Throws:
IOException
-
_startPositiveNumber
- Throws:
IOException
-
_startNumberLeadingZero
- Throws:
IOException
-
_finishNumberMinus
- Throws:
IOException
-
_finishNumberPlus
- Throws:
IOException
-
_finishNumberPlusMinus
- Throws:
IOException
-
_finishNumberLeadingZeroes
- Throws:
IOException
-
_finishNumberLeadingNegZeroes
- Throws:
IOException
-
_finishNumberLeadingPosZeroes
- Throws:
IOException
-
_finishNumberLeadingPosNegZeroes
- Throws:
IOException
-
_finishNumberIntegralPart
- Throws:
IOException
-
_startFloat
- Throws:
IOException
-
_finishFloatFraction
- Throws:
IOException
-
_finishFloatExponent
- Throws:
IOException
-
_fastParseName
- Throws:
IOException
-
_parseMediumName
- Throws:
IOException
-
_parseMediumName2
- Throws:
IOException
-
_parseEscapedName
private final JsonToken _parseEscapedName(int qlen, int currQuad, int currQuadBytes) throws IOException Slower parsing method which is generally branched to when an escape sequence is detected (or alternatively for long names, one crossing input buffer boundary). Needs to be able to handle more exceptional cases, gets slower, and hence is offlined to a separate method.- Throws:
IOException
-
_handleOddName
Method called when we see non-white space character other than double quote, when expecting a field name. In standard mode will just throw an exception; but in non-standard modes may be able to parse name.- Throws:
IOException
-
_finishUnquotedName
Parsing of optionally supported non-standard "unquoted" names: names without either double-quotes or apostrophes surrounding them. Unlike other- Throws:
IOException
-
_finishAposName
- Throws:
IOException
-
_finishFieldWithEscape
- Throws:
IOException
-
_decodeSplitEscaped
- Throws:
IOException
-
_startString
- Throws:
IOException
-
_finishRegularString
- Throws:
IOException
-
_startAposString
- Throws:
IOException
-
_finishAposString
- Throws:
IOException
-
_decodeSplitMultiByte
- Throws:
IOException
-
_decodeSplitUTF8_3
- Throws:
IOException
-
_decodeSplitUTF8_4
- Throws:
IOException
-
_decodeCharEscape
- Throws:
IOException
-
_decodeFastCharEscape
- Throws:
IOException
-
_decodeUTF8_2
- Throws:
IOException
-
_decodeUTF8_3
- Throws:
IOException
-
_decodeUTF8_4
- Throws:
IOException
-