org.codehaus.jackson.io

Class UTF32Reader

java.lang.Object

java.io.Reader

org.codehaus.jackson.io.UTF32Reader

All Implemented Interfaces:

Closeable, AutoCloseable, Readable

public class UTF32Reader
extends Reader

Since JDK does not come with UTF-32/UCS-4, let's implement a simple decoder to use.

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	_bigEndian
protected byte[]	_buffer
protected int	_byteCount Total read byte count; used for error reporting purposes
protected int	_charCount Total read character count; used for error reporting purposes
protected IOContext	_context
protected InputStream	_in
protected int	_length
protected boolean	_managedBuffers
protected int	_ptr
protected char	_surrogate Although input is fine with full Unicode set, Java still uses 16-bit chars, so we may have to split high-order chars into surrogate pairs.
protected char[]	_tmpBuf
protected static int	LAST_VALID_UNICODE_CHAR JSON actually limits available Unicode range in the high end to the same as xml (to basically limit UTF-8 max byte sequence length to 4)
protected static char	NULL_BYTE
protected static char	NULL_CHAR

Fields inherited from class java.io.Reader

lock

Constructor Summary

Constructors

Constructor and Description
UTF32Reader(IOContext ctxt, InputStream in, byte[] buf, int ptr, int len, boolean isBigEndian)

Method Summary

Methods

Modifier and Type	Method and Description
void	close()
void	freeBuffers() This method should be called along with (or instead of) normal close.
int	read() Although this method is implemented by the base class, AND it should never be called by main code, let's still implement it bit more efficiently just in case
int	read(char[] cbuf, int start, int len)
protected void	reportBounds(char[] cbuf, int start, int len)
protected void	reportStrangeStream()

Methods inherited from class java.io.Reader

mark, markSupported, read, read, ready, reset, skip

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

_bigEndian

protected final boolean _bigEndian

_surrogate

protected char _surrogate

Although input is fine with full Unicode set, Java still uses 16-bit chars, so we may have to split high-order chars into surrogate pairs.

_charCount

protected int _charCount

Total read character count; used for error reporting purposes

_byteCount

protected int _byteCount

Total read byte count; used for error reporting purposes

_managedBuffers

protected final boolean _managedBuffers

LAST_VALID_UNICODE_CHAR

protected static final int LAST_VALID_UNICODE_CHAR

JSON actually limits available Unicode range in the high end to the same as xml (to basically limit UTF-8 max byte sequence length to 4)

See Also:

Constant Field Values

NULL_CHAR

protected static final char NULL_CHAR

See Also:

Constant Field Values

NULL_BYTE

protected static final char NULL_BYTE

See Also:

Constant Field Values

_context

protected final IOContext _context

_in

protected InputStream _in

_buffer

protected byte[] _buffer

_ptr

protected int _ptr

_length

protected int _length

_tmpBuf

protected char[] _tmpBuf

Constructor Detail

UTF32Reader

public UTF32Reader(IOContext ctxt,
           InputStream in,
           byte[] buf,
           int ptr,
           int len,
           boolean isBigEndian)

Method Detail

read

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

Specified by:

read in class Reader

Throws:

IOException

close

public void close()
           throws IOException

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Specified by:

close in class Reader

Throws:

IOException

read

public int read()
         throws IOException

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

Overrides:

read in class Reader

Throws:

IOException

freeBuffers

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).

reportBounds

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

Throws:

IOException

reportStrangeStream

protected void reportStrangeStream()
                            throws IOException

Throws:

IOException