com.bumptech.glide.load.engine

Class GlideException

java.lang.Object

java.lang.Throwable

java.lang.Exception

com.bumptech.glide.load.engine.GlideException

All Implemented Interfaces:

Serializable

public final class GlideException
extends Exception

An exception with zero or more causes indicating why a load in Glide failed.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
GlideException(String message)
GlideException(String detailMessage, List<Throwable> causes)
GlideException(String detailMessage, Throwable cause)

Method Summary

Modifier and Type	Method and Description
Throwable	fillInStackTrace()
List<Throwable>	getCauses() Returns a list of causes that are immediate children of this exception.
String	getMessage()
List<Throwable>	getRootCauses() Returns the list of root causes that are the leaf nodes of all children of this exception.
void	logRootCauses(String tag) Logs all root causes using the given tag.
void	printStackTrace()
void	printStackTrace(PrintStream err)
void	printStackTrace(PrintWriter err)

Methods inherited from class java.lang.Throwable

addSuppressed, getCause, getLocalizedMessage, getStackTrace, getSuppressed, initCause, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

GlideException

public GlideException(String message)

GlideException

public GlideException(String detailMessage,
                      Throwable cause)

GlideException

public GlideException(String detailMessage,
                      List<Throwable> causes)

Method Detail

fillInStackTrace

public Throwable fillInStackTrace()

Overrides:

fillInStackTrace in class Throwable

getCauses

public List<Throwable> getCauses()

Returns a list of causes that are immediate children of this exception.

Causes may or may not be GlideExceptions. Causes may also not be root causes, and in turn my have been caused by other failures.

See Also:

getRootCauses()

getRootCauses

public List<Throwable> getRootCauses()

Returns the list of root causes that are the leaf nodes of all children of this exception.

Use this method to do things like look for http exceptions that indicate the load may have failed due to an error that can be retried. Keep in mind that because Glide may attempt to load a given model using multiple different pathways, there may be multiple related or unrelated reasons for a load to fail.

logRootCauses

public void logRootCauses(String tag)

Logs all root causes using the given tag.

Each root cause is logged separately to avoid throttling. printStackTrace() will provide a more succinct overview of why the exception occurred, although it does not include complete stack traces.

printStackTrace

public void printStackTrace()

Overrides:

printStackTrace in class Throwable

printStackTrace

public void printStackTrace(PrintStream err)

Overrides:

printStackTrace in class Throwable

printStackTrace

public void printStackTrace(PrintWriter err)

Overrides:

printStackTrace in class Throwable

getMessage

public String getMessage()

Overrides:

getMessage in class Throwable