net.pwall.pipeline.codec

Class DynamicReader

java.lang.Object

java.io.Reader

net.pwall.pipeline.codec.DynamicReader

All Implemented Interfaces:

Closeable, AutoCloseable, Readable

public class DynamicReader
extends Reader

Field Summary

Fields inherited from class java.io.Reader

lock

Constructor Summary

Constructors

Constructor and Description
DynamicReader(InputStream inputStream) Construct a DynamicReader for the supplied InputStream.
DynamicReader(InputStream inputStream, Charset charset) Construct a DynamicReader for the supplied InputStream, switching immediately to the specified Charset if specified.

Method Summary

Modifier and Type	Method and Description
void	close()
int	read(char[] cbuf, int off, int len) Reads characters into a portion of an array.
void	switchTo(Charset charset) Switch to the nominated character set.
void	switchTo(IntAcceptor<? extends Void> delegate) Switch to the specified delegate.
void	switchTo(String charsetName) Switch to the nominated character set.

Methods inherited from class java.io.Reader

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

Methods inherited from class java.lang.Object

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

Constructor Detail

DynamicReader

public DynamicReader(InputStream inputStream)

Construct a DynamicReader for the supplied InputStream.

Parameters:

inputStream - the InputStream

DynamicReader

public DynamicReader(InputStream inputStream,
                     Charset charset)

Construct a DynamicReader for the supplied InputStream, switching immediately to the specified Charset if specified. This bypasses much of the functionality of the DynamicDecoder, but allowing the Charset to be specified in this way simplifies the creation of a DynamicReader in those cases where the encoding may be, but is not always, known in advance.

Parameters:

inputStream - the InputStream

charset - the Charset if known, or null to allow dynamic encoding determination

Method Detail

read

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

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.

Specified by:

read in class Reader

Parameters:

cbuf - Destination buffer

off - Offset at which to start storing characters

len - Maximum number of characters to read

Returns:

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

Throws:

IOException - If an I/O error occurs

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

switchTo

public void switchTo(IntAcceptor<? extends Void> delegate)

Switch to the specified delegate.

Parameters:

delegate - the new delegate

switchTo

public void switchTo(Charset charset)

Switch to the nominated character set.

Parameters:

charset - the Charset

switchTo

public void switchTo(String charsetName)

Switch to the nominated character set.

Parameters:

charsetName - the character set name