org.cryptacular.io

Class DecodingInputStream

java.lang.Object

java.io.InputStream

java.io.FilterInputStream

org.cryptacular.io.DecodingInputStream

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable

public class DecodingInputStream
extends java.io.FilterInputStream

Filters read bytes through a Decoder such that consumers obtain raw (decoded) bytes from read operations.

Field Summary

Fields

Modifier and Type	Field and Description
private Decoder	decoder Performs decoding.
private java.nio.CharBuffer	input Holds input bytes as characters.
private java.nio.ByteBuffer	output Receives decoding result.
private java.io.InputStreamReader	reader Wraps the input stream to convert bytes to characters.

Fields inherited from class java.io.FilterInputStream

in

Constructor Summary

Constructors

Constructor and Description
DecodingInputStream(java.io.InputStream in, Decoder d) Creates a new instance that wraps the given stream and performs decoding using the given encoder component.

Method Summary

Modifier and Type	Method and Description
static DecodingInputStream	base64(java.io.InputStream in) Creates a new instance that decodes base64 input from the given stream.
static DecodingInputStream	hex(java.io.InputStream in) Creates a new instance that decodes hexadecimal input from the given stream.
private void	prepareInputBuffer(int required) Prepares the input buffer to receive the given number of bytes.
private void	prepareOutputBuffer() Prepares the output buffer based on input buffer capacity.
int	read()
int	read(byte[] b)
int	read(byte[] b, int off, int len)

Methods inherited from class java.io.FilterInputStream

available, close, mark, markSupported, reset, skip

Methods inherited from class java.lang.Object

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

Field Detail

decoder

private final Decoder decoder

Performs decoding.

reader

private final java.io.InputStreamReader reader

Wraps the input stream to convert bytes to characters.

input

private java.nio.CharBuffer input

Holds input bytes as characters.

output

private java.nio.ByteBuffer output

Receives decoding result.

Constructor Detail

DecodingInputStream

public DecodingInputStream(java.io.InputStream in,
                           Decoder d)

Creates a new instance that wraps the given stream and performs decoding using the given encoder component.

Parameters:

in - Input stream to wrap.

d - Decoder that provides on-the-fly decoding.

Method Detail

read

public int read()
         throws java.io.IOException

Overrides:

read in class java.io.FilterInputStream

Throws:

java.io.IOException

read

public int read(byte[] b)
         throws java.io.IOException

Overrides:

read in class java.io.FilterInputStream

Throws:

java.io.IOException

read

public int read(byte[] b,
                int off,
                int len)
         throws java.io.IOException

Overrides:

read in class java.io.FilterInputStream

Throws:

java.io.IOException

base64

public static DecodingInputStream base64(java.io.InputStream in)

Creates a new instance that decodes base64 input from the given stream.

Parameters:

in - Wrapped input stream.

Returns:

Decoding input stream that decodes base64 output.

hex

public static DecodingInputStream hex(java.io.InputStream in)

Creates a new instance that decodes hexadecimal input from the given stream.

Parameters:

in - Wrapped input stream.

Returns:

Decoding input stream that decodes hexadecimal output.

prepareInputBuffer

private void prepareInputBuffer(int required)

Prepares the input buffer to receive the given number of bytes.

Parameters:

required - Number of bytes required.

prepareOutputBuffer

private void prepareOutputBuffer()

Prepares the output buffer based on input buffer capacity.