|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.codehaus.jackson.JsonParser
org.codehaus.jackson.impl.JsonParserMinimalBase
org.codehaus.jackson.impl.JsonParserBase
public abstract class JsonParserBase
Intermediate base class used by all Jackson JsonParser
implementations. Contains most common things that are independent
of actual underlying input source
Nested Class Summary |
---|
Nested classes/interfaces inherited from class org.codehaus.jackson.JsonParser |
---|
JsonParser.Feature, JsonParser.NumberType |
Field Summary | |
---|---|
protected byte[] |
_binaryValue
We will hold on to decoded binary data, for duration of current event, so that multiple calls to JsonParserMinimalBase.getBinaryValue(org.codehaus.jackson.Base64Variant) will not need to decode data more
than once. |
protected ByteArrayBuilder |
_byteArrayBuilder
ByteArrayBuilder is needed if 'getBinaryValue' is called. |
protected boolean |
_closed
Flag that indicates whether parser is closed or not. |
protected long |
_currInputProcessed
Number of characters that were contained in previous blocks (blocks that were already processed prior to the current buffer). |
protected int |
_currInputRow
Current row location of current point in input buffer, starting from 1 |
protected int |
_currInputRowStart
Current index of the first character of the current row in input buffer. |
protected int |
_inputEnd
Index of character after last available one in the buffer. |
protected int |
_inputPtr
Pointer to next available character in buffer |
protected IOContext |
_ioContext
I/O context for this reader. |
protected boolean |
_nameCopied
Flag set to indicate whether the field name is available from the name copy buffer or not (in addition to its String representation being available via read context) |
protected char[] |
_nameCopyBuffer
Temporary buffer that is needed if field name is accessed using JsonParserMinimalBase.getTextCharacters() method (instead of String
returning alternatives) |
protected JsonToken |
_nextToken
Secondary token related to the next token after current one; used if its type is known. |
protected JsonReadContext |
_parsingContext
Information about parser context, context in which the next token is to be parsed (root, array, object). |
protected TextBuffer |
_textBuffer
Buffer that contains contents of String values, including field names if necessary (name split across boundary, contains escape sequence, or access needed to char array) |
protected int |
_tokenInputCol
Column on input row that current token starts; 0-based (although in the end it'll be converted to 1-based) |
protected int |
_tokenInputRow
Input row on which current token starts, 1-based |
protected long |
_tokenInputTotal
Total number of characters read before start of current token. |
Fields inherited from class org.codehaus.jackson.impl.JsonParserMinimalBase |
---|
INT_APOSTROPHE, INT_ASTERISK, INT_b, INT_BACKSLASH, INT_COLON, INT_COMMA, INT_CR, INT_f, INT_LBRACKET, INT_LCURLY, INT_LF, INT_n, INT_QUOTE, INT_r, INT_RBRACKET, INT_RCURLY, INT_SLASH, INT_SPACE, INT_t, INT_TAB, INT_u |
Fields inherited from class org.codehaus.jackson.JsonParser |
---|
_currToken, _features, _lastClearedToken |
Constructor Summary | |
---|---|
protected |
JsonParserBase(IOContext ctxt,
int features)
|
Method Summary | |
---|---|
protected abstract void |
_closeInput()
|
protected abstract byte[] |
_decodeBase64(Base64Variant b64variant)
|
protected abstract void |
_finishString()
|
ByteArrayBuilder |
_getByteArrayBuilder()
|
protected void |
_handleEOF()
Method called when an EOF is encountered between tokens. |
protected void |
_releaseBuffers()
Method called to release internal buffers owned by the base reader. |
protected void |
_reportMismatchedEndMarker(int actCh,
char expCh)
|
void |
close()
Closes the parser so that no further iteration or data access can be made; will also close the underlying input source if parser either owns the input source, or feature JsonParser.Feature.AUTO_CLOSE_SOURCE is enabled. |
JsonLocation |
getCurrentLocation()
Method that returns location of the last processed character; usually for error reporting purposes |
String |
getCurrentName()
Method that can be called to get the name associated with the current event. |
JsonReadContext |
getParsingContext()
Method that can be used to access current parsing context reader is in. |
long |
getTokenCharacterOffset()
|
int |
getTokenColumnNr()
|
int |
getTokenLineNr()
|
JsonLocation |
getTokenLocation()
Method that return the starting location of the current token; that is, position of the first character from input that starts the current token. |
boolean |
hasTextCharacters()
Method that can be used to determine whether calling of JsonParser.getTextCharacters() would be the most efficient
way to access textual content for the event parser currently
points to. |
boolean |
isClosed()
Method that can be called to determine whether this parser is closed or not. |
protected abstract boolean |
loadMore()
|
protected void |
loadMoreGuaranteed()
|
Version |
version()
Method called to detect version of the component that implements this interface; returned version should never be null, but may return specific "not available" instance (see Version for details). |
Methods inherited from class org.codehaus.jackson.impl.JsonParserMinimalBase |
---|
_constructError, _getCharDesc, _handleUnrecognizedCharacterEscape, _reportError, _reportInvalidEOF, _reportInvalidEOF, _reportInvalidEOFInValue, _reportUnexpectedChar, _throwInternal, _throwInvalidSpace, _throwUnquotedSpace, _wrapError, getBinaryValue, getText, getTextCharacters, getTextLength, getTextOffset, getValueAsBoolean, getValueAsDouble, getValueAsInt, getValueAsLong, nextToken, skipChildren |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
protected final IOContext _ioContext
protected boolean _closed
close()
) or when end-of-input is reached.
protected int _inputPtr
protected int _inputEnd
protected long _currInputProcessed
protected int _currInputRow
protected int _currInputRowStart
protected long _tokenInputTotal
protected int _tokenInputRow
protected int _tokenInputCol
protected JsonReadContext _parsingContext
protected JsonToken _nextToken
protected final TextBuffer _textBuffer
protected char[] _nameCopyBuffer
JsonParserMinimalBase.getTextCharacters()
method (instead of String
returning alternatives)
protected boolean _nameCopied
protected ByteArrayBuilder _byteArrayBuilder
protected byte[] _binaryValue
JsonParserMinimalBase.getBinaryValue(org.codehaus.jackson.Base64Variant)
will not need to decode data more
than once.
Constructor Detail |
---|
protected JsonParserBase(IOContext ctxt, int features)
Method Detail |
---|
public Version version()
Versioned
Version
for details).
version
in interface Versioned
version
in class JsonParser
public String getCurrentName() throws IOException, JsonParseException
getCurrentName
in class JsonParserMinimalBase
IOException
JsonParseException
public void close() throws IOException
JsonParser
JsonParser.Feature.AUTO_CLOSE_SOURCE
is enabled.
Whether parser owns the input source depends on factory
method that was used to construct instance (so check
JsonFactory
for details,
but the general
idea is that if caller passes in closable resource (such
as InputStream
or Reader
) parser does NOT
own the source; but if it passes a reference (such as
File
or URL
and creates
stream or reader it does own them.
close
in interface Closeable
close
in class JsonParserMinimalBase
IOException
public boolean isClosed()
JsonParser
JsonParser.nextToken()
(and the underlying
stream may be closed). Closing may be due to an explicit
call to JsonParser.close()
or because parser has encountered
end of input.
isClosed
in class JsonParserMinimalBase
public JsonReadContext getParsingContext()
JsonParser
getParsingContext
in class JsonParserMinimalBase
public JsonLocation getTokenLocation()
getTokenLocation
in class JsonParser
public JsonLocation getCurrentLocation()
getCurrentLocation
in class JsonParser
public boolean hasTextCharacters()
JsonParser
JsonParser.getTextCharacters()
would be the most efficient
way to access textual content for the event parser currently
points to.
Default implementation simply returns false since only actual implementation class has knowledge of its internal buffering state. Implementations are strongly encouraged to properly override this method, to allow efficient copying of content by other code.
hasTextCharacters
in class JsonParserMinimalBase
JsonParser.getTextCharacters()
; false
means that it may or may not existpublic final long getTokenCharacterOffset()
public final int getTokenLineNr()
public final int getTokenColumnNr()
protected final void loadMoreGuaranteed() throws IOException
IOException
protected abstract boolean loadMore() throws IOException
IOException
protected abstract void _finishString() throws IOException, JsonParseException
IOException
JsonParseException
protected abstract void _closeInput() throws IOException
IOException
protected abstract byte[] _decodeBase64(Base64Variant b64variant) throws IOException, JsonParseException
IOException
JsonParseException
protected void _releaseBuffers() throws IOException
_closeInput()
(for
example, when explicitly closing this reader instance), or
separately (if need be).
IOException
protected void _handleEOF() throws JsonParseException
_handleEOF
in class JsonParserMinimalBase
JsonParseException
protected void _reportMismatchedEndMarker(int actCh, char expCh) throws JsonParseException
JsonParseException
public ByteArrayBuilder _getByteArrayBuilder()
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |