com.ibm.cloud.objectstorage.util

Class UnreliableFilterInputStream

java.lang.Object

java.io.InputStream

java.io.FilterInputStream

com.ibm.cloud.objectstorage.util.UnreliableFilterInputStream

All Implemented Interfaces:

Closeable, AutoCloseable

public class UnreliableFilterInputStream
extends FilterInputStream

An internal class used solely for the purpose of testing via failure injection.

Field Summary

Fields inherited from class java.io.FilterInputStream

in

Constructor Summary

Constructors

Constructor and Description
UnreliableFilterInputStream(InputStream in, boolean isFakeIOException)

Method Summary

Modifier and Type	Method and Description
int	getBytesReadBeforeException()
int	getCurrNumErrors()
int	getMarked()
int	getMaxNumErrors()
int	getPosition()
int	getResetCount()
int	getResetIntervalBeforeException()
boolean	isFakeIOException()
void	mark(int readlimit)
int	read()
int	read(byte[] b, int off, int len)
void	reset()
String	toString()
UnreliableFilterInputStream	withBytesReadBeforeException(int bytesReadBeforeException)
UnreliableFilterInputStream	withMaxNumErrors(int maxNumErrors)
UnreliableFilterInputStream	withResetIntervalBeforeException(int resetIntervalBeforeException)

Methods inherited from class java.io.FilterInputStream

available, close, markSupported, read, skip

Methods inherited from class java.lang.Object

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

Constructor Detail

UnreliableFilterInputStream

public UnreliableFilterInputStream(InputStream in,
                                   boolean isFakeIOException)

Method Detail

read

public int read()
         throws IOException

Overrides:

read in class FilterInputStream

Throws:

IOException

read

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

Overrides:

read in class FilterInputStream

Throws:

IOException

mark

public void mark(int readlimit)

Overrides:

mark in class FilterInputStream

reset

public void reset()
           throws IOException

Overrides:

reset in class FilterInputStream

Throws:

IOException

getCurrNumErrors

public int getCurrNumErrors()

getMaxNumErrors

public int getMaxNumErrors()

withMaxNumErrors

public UnreliableFilterInputStream withMaxNumErrors(int maxNumErrors)

withBytesReadBeforeException

public UnreliableFilterInputStream withBytesReadBeforeException(int bytesReadBeforeException)

getBytesReadBeforeException

public int getBytesReadBeforeException()

withResetIntervalBeforeException

public UnreliableFilterInputStream withResetIntervalBeforeException(int resetIntervalBeforeException)

Parameters:

resetIntervalBeforeException - used to control whether an exception would be thrown based on the reset recurrence; not applicable if set to zero. For example, if resetIntervalBeforeException == n, the exception can only be thrown before the n_th reset (or after the n_th minus 1 reset), 2n_th reset (or after the 2n_th minus 1) reset), etc.

getResetIntervalBeforeException

public int getResetIntervalBeforeException()

getMarked

public int getMarked()

getPosition

public int getPosition()

isFakeIOException

public boolean isFakeIOException()

getResetCount

public int getResetCount()

toString

public String toString()

Overrides:

toString in class Object