Class BaseNCodecInputStream<C extends BaseNCodec, T extends BaseNCodecInputStream<C,T,B>, B extends BaseNCodecInputStream.AbstracBuilder<T,C,B>>

java.lang.Object

java.io.InputStream

java.io.FilterInputStream

org.apache.commons.codec.binary.BaseNCodecInputStream<C,T,B>

Type Parameters:

C - A BaseNCodec subclass.

T - A BaseNCodecInputStream subclass.

B - A subclass.

All Implemented Interfaces:

Closeable, AutoCloseable

Direct Known Subclasses:

Base16InputStream, Base32InputStream, Base45InputStream, Base58InputStream, Base64InputStream

public class BaseNCodecInputStream<C extends BaseNCodec, T extends BaseNCodecInputStream<C,T,B>, B extends BaseNCodecInputStream.AbstracBuilder<T,C,B>>
extends FilterInputStream

Abstracts Base-N input streams.

Since:

1.5

See Also:

• Base16InputStream
• Base32InputStream
• Base58InputStream
• Base64InputStream

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	BaseNCodecInputStream.AbstracBuilder<T, C extends BaseNCodec, B extends AbstractBaseNCodecStreamBuilder<T,C,B>>	Builds input stream instances in BaseNCodec format.

Field Summary

Fields inherited from class FilterInputStream

in

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	BaseNCodecInputStream(InputStream inputStream, C baseNCodec, boolean doEncode)	Constructs a new instance.
protected	BaseNCodecInputStream(BaseNCodecInputStream.AbstracBuilder<T,C,B> builder)	Constructs a new instance.

Method Summary

Modifier and Type	Method	Description
int	available()
boolean	isStrictDecoding()	Tests whether decoding behavior is strict.
void	mark(int readLimit)	Marks the current position in this input stream.
boolean	markSupported()
int	read()	Reads one byte from this input stream.
int	read(byte[] array, int offset, int len)	Attempts to read len bytes into the specified b array starting at offset from this InputStream.
void	reset()	Always throws IOException because this stream does not support resetting.
long	skip(long n)

Methods inherited from class FilterInputStream

close, read

Methods inherited from class Object

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

Constructor Details

BaseNCodecInputStream

protected BaseNCodecInputStream(BaseNCodecInputStream.AbstracBuilder<T,C,B> builder)

Constructs a new instance.

Parameters:

builder - A builder.

Since:

1.20.0

BaseNCodecInputStream

protected BaseNCodecInputStream(InputStream inputStream,
 C baseNCodec,
 boolean doEncode)

Constructs a new instance.

Parameters:

inputStream - The input stream.

baseNCodec - The codec.

doEncode - set to true to perform encoding, else decoding.

Method Details

available

public int available()
              throws IOException

Overrides:

available in class FilterInputStream

Returns:

0 if the InputStream has reached EOF, 1 otherwise.

Throws:

IOException - Thrown if an I/O error occurs.

Since:

1.7

isStrictDecoding

public boolean isStrictDecoding()

Tests whether decoding behavior is strict.

Strict decoding rejects invalid trailing bits and, for Base32 and Base64, noncanonical input. Decoding errors are reported as IOException. To complete validation, consume this stream to EOF. Decoded bytes can be emitted before a later validation error.

Returns:

true if using strict decoding.

Since:

1.15

mark

public void mark(int readLimit)

Marks the current position in this input stream.

The mark(int) method of BaseNCodecInputStream does nothing.

Overrides:

mark in class FilterInputStream

Parameters:

readLimit - The maximum limit of bytes that can be read before the mark position becomes invalid.

Since:

1.7

See Also:

• markSupported()

markSupported

public boolean markSupported()

Overrides:

markSupported in class FilterInputStream

Returns:

Always returns false.

read

public int read()
         throws IOException

Reads one byte from this input stream.

Overrides:

read in class FilterInputStream

Returns:

The byte as an integer in the range 0 to 255. Returns -1 if EOF has been reached.

Throws:

IOException - Thrown if an I/O error occurs.

read

public int read(byte[] array,
 int offset,
 int len)
         throws IOException

Attempts to read len bytes into the specified b array starting at offset from this InputStream.

Overrides:

read in class FilterInputStream

Parameters:

array - destination byte array.

offset - where to start writing the bytes.

len - maximum number of bytes to read.

Returns:

number of bytes read.

Throws:

IOException - Thrown if an I/O error occurs.

NullPointerException - Thrown if the byte array parameter is null.

IndexOutOfBoundsException - Thrown if the offset, length, or buffer size is invalid.

reset

public void reset()
           throws IOException

Always throws IOException because this stream does not support resetting.

Overrides:

reset in class FilterInputStream

Throws:

IOException - Thrown if this method is invoked.

Since:

1.7

skip

public long skip(long n)
          throws IOException

Overrides:

skip in class FilterInputStream

Throws:

IllegalArgumentException - Thrown if the provided skip length is negative.

IOException - Thrown if an I/O error occurs.

Since:

1.7