org.apache.commons.codec.binary

Class BaseNCodecInputStream

java.lang.Object

java.io.InputStream

java.io.FilterInputStream

org.apache.commons.codec.binary.BaseNCodecInputStream

All Implemented Interfaces:

Closeable, AutoCloseable

Direct Known Subclasses:

Base32InputStream, Base64InputStream

public class BaseNCodecInputStream
extends FilterInputStream

Abstract superclass for Base-N input streams.

Since:

1.5

Field Summary

Fields inherited from class java.io.FilterInputStream

in

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	BaseNCodecInputStream(InputStream in, BaseNCodec baseNCodec, boolean doEncode)

Method Summary

Modifier and Type	Method and Description
int	available() Returns an estimate of the number of bytes that can be read (or skipped over) from this input stream without blocking by the next caller of a method for this input stream.
void	mark(int readLimit) Marks the current position in this input stream.
boolean	markSupported() Tests if this input stream supports the mark and reset methods.
int	read() Reads one byte from this input stream.
int	read(byte[] b, int offset, int len) Attempts to read len bytes into the specified b array starting at offset from this InputStream.
void	reset() Repositions this stream to the position at the time the mark method was last called on this input stream.
long	skip(long n) Skips over and discards n bytes of data from the input stream.

Methods inherited from class java.io.FilterInputStream

close, read

Methods inherited from class java.lang.Object

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

Constructor Detail

BaseNCodecInputStream

protected BaseNCodecInputStream(InputStream in,
                                BaseNCodec baseNCodec,
                                boolean doEncode)

Method Detail

available

public int available()
              throws IOException

Returns an estimate of the number of bytes that can be read (or skipped over) from this input stream without blocking by the next caller of a method for this input stream. The next caller might be the same thread or another thread. A single read or skip of this many bytes will not block, but may read or skip fewer bytes.

This method returns the result of in.available().

Overrides:

available in class FilterInputStream

Returns:

0 if the InputStream has reached EOF, 1 otherwise

Throws:

IOException - if an I/O error occurs.

Since:

1.7

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

Tests if this input stream supports the mark and reset methods. This method simply performs in.markSupported().

Overrides:

markSupported in class FilterInputStream

Returns:

Always returns false

See Also:

FilterInputStream.in, InputStream.mark(int), InputStream.reset()

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 - if an I/O error occurs.

See Also:

FilterInputStream.in

read

public int read(byte[] b,
                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:

b - destination byte array

offset - where to start writing the bytes

len - maximum number of bytes to read

Returns:

number of bytes read

Throws:

IOException - if an I/O error occurs.

NullPointerException - if the byte array parameter is null

IndexOutOfBoundsException - if offset, len or buffer size are invalid

See Also:

FilterInputStream.in

reset

public void reset()
           throws IOException

Repositions this stream to the position at the time the mark method was last called on this input stream.

The reset() method of BaseNCodecInputStream does nothing except throw an IOException.

Overrides:

reset in class FilterInputStream

Throws:

IOException - if this method is invoked

Since:

1.7

See Also:

FilterInputStream.in, FilterInputStream.mark(int)

skip

public long skip(long n)
          throws IOException

Skips over and discards n bytes of data from the input stream. The skip method may, for a variety of reasons, end up skipping over some smaller number of bytes, possibly 0. The actual number of bytes skipped is returned.

This method simply performs in.skip(n).

Overrides:

skip in class FilterInputStream

Parameters:

n - the number of bytes to be skipped.

Returns:

the actual number of bytes skipped.

Throws:

IllegalArgumentException - if the provided skip length is negative

IOException - if the stream does not support seek, or if some other I/O error occurs.

Since:

1.7