UTF8Reader

java.lang.Object

java.io.Reader

net.i2p.sam.UTF8Reader

All Implemented Interfaces:: Closeable, AutoCloseable, Readable

public class UTF8Readerextends Reader

An unbuffered version of InputStreamReader.

Does not read any extra characters, as long as input is well-formed. This permits the partial reading of an InputStream as UTF-8 and then passing the remainder of the input stream elsewhere. This isn't the most robust for malformed input, so it may not be appropriate for e.g. HTTP headers.

Not thread-safe, obviously.

May be moved to net.i2p.util if anybody else needs it.

Field Summary
Fields
Modifier and Type
Field
Description
private ByteBuffer
_bb
Bytes buffered while decoding, initialized lazily when needed.
private CharBuffer
_cb
Characters decoded ahead of the reader, initialized lazily.
private CharsetDecoder
_dc
The UTF-8 decoder, initialized lazily.
private final InputStream
_in
The bytes being decoded.
private static final int
REPLACEMENT
Character substituted for an undecodable byte.
Fields inherited from class Reader
lock
Constructor Summary
Constructors
Constructor
Description
UTF8Reader(InputStream in)
Creates a reader that decodes the stream as UTF-8.
Method Summary
All Methods
Modifier and Type
Method
Description
void
close()
int
read()
Read one decoded character.
int
read(char[] cbuf)
int
read(char[] cbuf, int off, int len)
Methods inherited from class Reader
mark, markSupported, nullReader, of, read, readAllAsString, readAllLines, ready, reset, skip, transferTo
Methods inherited from class Object
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details
- _in
  private final InputStream _in
  The bytes being decoded.
- _bb
  private ByteBuffer _bb
  Bytes buffered while decoding, initialized lazily when needed.
- _cb
  private CharBuffer _cb
  Characters decoded ahead of the reader, initialized lazily.
- _dc
  private CharsetDecoder _dc
  The UTF-8 decoder, initialized lazily.
- REPLACEMENT
  private static final int REPLACEMENT
  Character substituted for an undecodable byte.
  See Also:
  Constant Field Values
Constructor Details
- UTF8Reader
  public UTF8Reader(InputStream in)
  Creates a reader that decodes the stream as UTF-8.
  Parameters:
  in - UTF-8
Method Details
- read
  public int read() throws IOException
  Read one decoded character.
  Overrides:
  read in class Reader
  Returns:
  replacement character on decoding error
  Throws:
  IOException
- read
  public int read(char[] cbuf) throws IOException
  Overrides:
  read in class Reader
  Throws:
  IOException
- read
  public int read(char[] cbuf, int off, int len) throws IOException
  Specified by:
  read in class Reader
  Throws:
  IOException
- close
  public void close() throws IOException
  Specified by:
  close in interface AutoCloseable
  Specified by:
  close in interface Closeable
  Specified by:
  close in class Reader
  Throws:
  IOException

Field Summary

Fields inherited from class Reader

Constructor Summary

Method Summary

Methods inherited from class Reader

Methods inherited from class Object

Field Details

_in

_bb

_cb

_dc

REPLACEMENT

Constructor Details

Method Details

read

read

read

close