Jackson 2.18.2 · com.fasterxml.jackson.dataformat.csv.impl.UTF8Reader

Field Summary

Modifier and Type	Field and Description
private final boolean	_autoClose
private int	_byteCount Total read byte count; used for error reporting purposes
private int	_charCount Total read character count; used for error reporting purposes
private int	_decodeErrorOffset Flag that is set when a pending decode error has been detected; needed to properly handle deferred reporting.
private byte[]	_inputBuffer
private int	_inputEnd Pointed to the end marker, that is, position one after the last valid available byte.
private int	_inputPtr Pointer to the next available byte (if any), iff less than `mByteBufferEnd`
private InputStream	_inputSource
private final IOContext	_ioContext IO context to use for returning input buffer, iff buffer is to be recycled when input ends.
private int	_surrogate Decoded first character of a surrogate pair, if one needs to be buffered
private char[]	_tmpBuffer

Inherited from java.io.Reader:: lock

Constructor Summary

Access	Constructor and Description
public	UTF8Reader(IOContext ctxt, InputStream in, boolean autoClose, byte[] buf, int ptr, int len)
public	UTF8Reader(IOContext ctxt, byte[] buf, int ptr, int len)
public	UTF8Reader(IOContext ctxt, InputStream in, boolean autoClose)

Method Summary

Modifier and Type	Method and Description
protected final boolean	canModifyBuffer() Method that can be used to see if we can actually modify the underlying buffer.
public void	close() Implements abstract java.io.Reader.close. Implements java.io.Closeable.close. Closes the stream and releases any system resources associated with it.
public final void	freeBuffers() This method should be called along with (or instead of) normal close.
protected final InputStream	getStream()
private boolean	Returns: True, if enough bytes were read to allow decoding of at least one full character; false if EOF was encountered instead. loadMore(int Number of "unused" bytes in the input buffer available)
public int	read() Overrides java.io.Reader.read. Although this method is implemented by the base class, AND it should never be called by parser code, let's still implement it bit more efficiently just in case
public int	read(char[] Destination buffer cbuf) Overrides java.io.Reader.read. Reads characters into an array.
public int	read(final char[] Destination buffer cbuf, final int Offset at which to start storing characters start, int Maximum number of characters to read len) Implements abstract java.io.Reader.read. Reads characters into a portion of an array.
protected final int	readBytes() Method for reading as many bytes from the underlying stream as possible (that fit in the buffer), to the beginning of the buffer.
protected final int	Returns: Number of bytes read, if any; -1 to indicate none available (that is, end of input) readBytesAt(int offset) Method for reading as many bytes from the underlying stream as possible (that fit in the buffer considering offset), to the specified offset.
protected void	reportBounds(char[] cbuf, int start, int len)
protected void	reportDeferredInvalid()
protected void	reportInvalidInitial(int mask, int outputDecoded)
protected void	reportInvalidOther(int mask, int outputDecoded, int errorPosition)
protected void	reportStrangeStream()
protected void	reportUnexpectedEOF(int gotBytes, int needed)

Inherited from java.io.Reader:: mark markSupported nullReader read ready reset skip transferTo

Field Detail

_autoClose	back to summary
private final boolean _autoClose

_byteCount	back to summary
private int _byteCount Total read byte count; used for error reporting purposes

_charCount	back to summary
private int _charCount Total read character count; used for error reporting purposes

_decodeErrorOffset	back to summary
private int _decodeErrorOffset Flag that is set when a pending decode error has been detected; needed to properly handle deferred reporting.

_inputBuffer	back to summary
private byte[] _inputBuffer

_inputEnd	back to summary
private int _inputEnd Pointed to the end marker, that is, position one after the last valid available byte.

_inputPtr	back to summary
private int _inputPtr Pointer to the next available byte (if any), iff less than `mByteBufferEnd`

_inputSource	back to summary
private InputStream _inputSource

_ioContext	back to summary
private final IOContext _ioContext IO context to use for returning input buffer, iff buffer is to be recycled when input ends.

_surrogate	back to summary
private int _surrogate Decoded first character of a surrogate pair, if one needs to be buffered

_tmpBuffer	back to summary
private char[] _tmpBuffer

Constructor Detail

UTF8Reader	back to summary
public UTF8Reader(IOContext ctxt, InputStream in, boolean autoClose, byte[] buf, int ptr, int len)

UTF8Reader	back to summary
public UTF8Reader(IOContext ctxt, byte[] buf, int ptr, int len)

UTF8Reader	back to summary
public UTF8Reader(IOContext ctxt, InputStream in, boolean autoClose)

Method Detail

canModifyBuffer	back to summary
protected final boolean canModifyBuffer() Method that can be used to see if we can actually modify the underlying buffer. This is the case if we are managing the buffer, but not if it was just given to us.

close	back to summary
public void close() throws IOException Implements abstract java.io.Reader.close. Implements java.io.Closeable.close. Doc from java.io.Reader.close. Closes the stream and releases any system resources associated with it. Once the stream has been closed, further read(), ready(), mark(), reset(), or skip() invocations will throw an IOException. Closing a previously closed stream has no effect. Annotations @Override Exceptions IOException: If an I/O error occurs

back to summary

public void close() throws IOException

Implements abstract java.io.Reader.close.

Implements java.io.Closeable.close.

Doc from java.io.Reader.close.

Closes the stream and releases any system resources associated with it. Once the stream has been closed, further read(), ready(), mark(), reset(), or skip() invocations will throw an IOException. Closing a previously closed stream has no effect.

Annotations

@Override

Exceptions

IOException:: If an I/O error occurs

freeBuffers	back to summary
public final void freeBuffers() This method should be called along with (or instead of) normal close. After calling this method, no further reads should be tried. Method will try to recycle read buffers (if any).

getStream	back to summary
protected final InputStream getStream()

loadMore	back to summary
private boolean loadMore(int available) throws IOException Parameters available:int Number of "unused" bytes in the input buffer Returns:boolean True, if enough bytes were read to allow decoding of at least one full character; false if EOF was encountered instead.

read back to summary

read	back to summary
public int read() throws IOException Overrides java.io.Reader.read. Although this method is implemented by the base class, AND it should never be called by parser code, let's still implement it bit more efficiently just in case Returns:int Doc from java.io.Reader.read. The character read, as an integer in the range 0 to 65535 (`0x00-0xffff`), or -1 if the end of the stream has been reached Annotations @Override Exceptions IOException: Doc from java.io.Reader.read. If an I/O error occurs

public int read() throws IOException

Overrides java.io.Reader.read.

Although this method is implemented by the base class, AND it should never be called by parser code, let's still implement it bit more efficiently just in case

Returns:int

Doc from java.io.Reader.read.

The character read, as an integer in the range 0 to 65535 (0x00-0xffff), or -1 if the end of the stream has been reached

Annotations

@Override

Exceptions

IOException:

Doc from java.io.Reader.read.

If an I/O error occurs

read back to summary

read	back to summary
public int read(char[] cbuf) throws IOException Overrides java.io.Reader.read. Doc from java.io.Reader.read. Reads characters into an array. This method will block until some input is available, an I/O error occurs, or the end of the stream is reached. If the length of `cbuf` is zero, then no characters are read and `0` is returned; otherwise, there is an attempt to read at least one character. If no character is available because the stream is at its end, the value `-1` is returned; otherwise, at least one character is read and stored into `cbuf`. Parameters cbuf:char[] Destination buffer Returns:int The number of characters read, or -1 if the end of the stream has been reached Annotations @Override Exceptions IOException: If an I/O error occurs

public int read(char[] cbuf) throws IOException

Overrides java.io.Reader.read.

Doc from java.io.Reader.read.

Reads characters into an array. This method will block until some input is available, an I/O error occurs, or the end of the stream is reached.

If the length of cbuf is zero, then no characters are read and 0 is returned; otherwise, there is an attempt to read at least one character. If no character is available because the stream is at its end, the value -1 is returned; otherwise, at least one character is read and stored into cbuf.

Parameters

cbuf:char[]: Destination buffer

Returns:int

The number of characters read, or -1 if the end of the stream has been reached

Annotations

@Override

Exceptions

IOException:: If an I/O error occurs

read back to summary

read	back to summary
public int read(final char[] cbuf, final int start, int len) throws IOException Implements abstract java.io.Reader.read. Doc from java.io.Reader.read. Reads characters into a portion of an array. This method will block until some input is available, an I/O error occurs, or the end of the stream is reached. If `len` is zero, then no characters are read and `0` is returned; otherwise, there is an attempt to read at least one character. If no character is available because the stream is at its end, the value `-1` is returned; otherwise, at least one character is read and stored into `cbuf`. Parameters cbuf:char[] Destination buffer start:int Offset at which to start storing characters len:int Maximum number of characters to read Returns:int The number of characters read, or -1 if the end of the stream has been reached Annotations @Override Exceptions IOException: If an I/O error occurs

public int read(final char[] cbuf, final int start, int len) throws IOException

Implements abstract java.io.Reader.read.

Doc from java.io.Reader.read.

Reads characters into a portion of an array. This method will block until some input is available, an I/O error occurs, or the end of the stream is reached.

If len is zero, then no characters are read and 0 is returned; otherwise, there is an attempt to read at least one character. If no character is available because the stream is at its end, the value -1 is returned; otherwise, at least one character is read and stored into cbuf.

Parameters

cbuf:char[]: Destination buffer
start:int: Offset at which to start storing characters
len:int: Maximum number of characters to read

Returns:int

The number of characters read, or -1 if the end of the stream has been reached

Annotations

@Override

Exceptions

IOException:: If an I/O error occurs

readBytes	back to summary
protected final int readBytes() throws IOException Method for reading as many bytes from the underlying stream as possible (that fit in the buffer), to the beginning of the buffer.

readBytesAt	back to summary
protected final int readBytesAt(int offset) throws IOException Method for reading as many bytes from the underlying stream as possible (that fit in the buffer considering offset), to the specified offset. Returns:int Number of bytes read, if any; -1 to indicate none available (that is, end of input)

readBytesAt

back to summary

protected final int readBytesAt(int offset) throws IOException

Method for reading as many bytes from the underlying stream as possible (that fit in the buffer considering offset), to the specified offset.

Returns:int: Number of bytes read, if any; -1 to indicate none available (that is, end of input)

reportBounds	back to summary
protected void reportBounds(char[] cbuf, int start, int len) throws IOException

reportDeferredInvalid	back to summary
protected void reportDeferredInvalid() throws IOException

reportInvalidInitial	back to summary
protected void reportInvalidInitial(int mask, int outputDecoded) throws IOException

reportInvalidOther	back to summary
protected void reportInvalidOther(int mask, int outputDecoded, int errorPosition) throws IOException

reportStrangeStream	back to summary
protected void reportStrangeStream() throws IOException

reportUnexpectedEOF	back to summary
protected void reportUnexpectedEOF(int gotBytes, int needed) throws IOException

public final Class UTF8Reader

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail