com.bumptech.glide.util

Class ExceptionPassthroughInputStream

java.lang.Object

java.io.InputStream

com.bumptech.glide.util.ExceptionPassthroughInputStream

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable

public final class ExceptionPassthroughInputStream
extends java.io.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 and Description
int	available()
void	close()
java.io.IOException	getException()
void	mark(int readLimit)
boolean	markSupported()
static ExceptionPassthroughInputStream	obtain(java.io.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.lang.Object

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

Method Detail

obtain

@NonNull
public static ExceptionPassthroughInputStream obtain(@NonNull
                                                              java.io.InputStream toWrap)

available

public int available()
              throws java.io.IOException

Overrides:

available in class java.io.InputStream

Throws:

java.io.IOException

close

public void close()
           throws java.io.IOException

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Overrides:

close in class java.io.InputStream

Throws:

java.io.IOException

mark

public void mark(int readLimit)

Overrides:

mark in class java.io.InputStream

markSupported

public boolean markSupported()

Overrides:

markSupported in class java.io.InputStream

read

public int read()
         throws java.io.IOException

Specified by:

read in class java.io.InputStream

Throws:

java.io.IOException

read

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

Overrides:

read in class java.io.InputStream

Throws:

java.io.IOException

read

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

Overrides:

read in class java.io.InputStream

Throws:

java.io.IOException

reset

public void reset()
           throws java.io.IOException

Overrides:

reset in class java.io.InputStream

Throws:

java.io.IOException

skip

public long skip(long byteCount)
          throws java.io.IOException

Overrides:

skip in class java.io.InputStream

Throws:

java.io.IOException

getException

@Nullable
public java.io.IOException getException()

release

public void release()