Package com.bumptech.glide.util

Class ExceptionPassthroughInputStream

java.lang.Object

java.io.InputStream

com.bumptech.glide.util.ExceptionPassthroughInputStream

All Implemented Interfaces:

Closeable, AutoCloseable

public final class ExceptionPassthroughInputStream
extends InputStream

An InputStream that catches, stores and rethrows IOExceptions during read and skip calls. This allows users of this API to handle the exception at a higher level if the exception is swallowed by some intermediate library. This class is a workaround for a framework issue where exceptions during reads while decoding bitmaps in BitmapFactory can return partially decoded bitmaps.

Unlike the deprecated ExceptionCatchingInputStream, this class will both store and re-throw any IOExceptions. Rethrowing works around bugs in wrapping streams that may not fully obey the stream contract. This is really only useful if some middle layer is going to catch the exception (like BitmapFactory) but we want to propagate the exception instead.

See https://github.com/bumptech/glide/issues/126 and #4438.

Method Summary

Modifier and Type	Method	Description
int	available()
void	close()
IOException	getException()
void	mark(int readLimit)
boolean	markSupported()
static ExceptionPassthroughInputStream	obtain(InputStream toWrap)
int	read()
int	read(byte[] buffer)
int	read(byte[] buffer, int byteOffset, int byteCount)
void	release()
void	reset()
long	skip(long byteCount)

Methods inherited from class java.io.InputStream

nullInputStream, readAllBytes, readNBytes, readNBytes, skipNBytes, transferTo

Methods inherited from class java.lang.Object

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

Method Details

obtain

@NonNull
public static ExceptionPassthroughInputStream obtain(@NonNull
 InputStream toWrap)

available

public int available()
              throws IOException

Overrides:

available in class InputStream

Throws:

IOException

close

public void close()
           throws IOException

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Overrides:

close in class InputStream

Throws:

IOException

mark

public void mark(int readLimit)

Overrides:

mark in class InputStream

markSupported

public boolean markSupported()

Overrides:

markSupported in class InputStream

read

public int read()
         throws IOException

Specified by:

read in class InputStream

Throws:

IOException

read

public int read(byte[] buffer)
         throws IOException

Overrides:

read in class InputStream

Throws:

IOException

read

public int read(byte[] buffer,
 int byteOffset,
 int byteCount)
         throws IOException

Overrides:

read in class InputStream

Throws:

IOException

reset

public void reset()
           throws IOException

Overrides:

reset in class InputStream

Throws:

IOException

skip

public long skip(long byteCount)
          throws IOException

Overrides:

skip in class InputStream

Throws:

IOException

getException

@Nullable
public IOException getException()

release

public void release()