# HttpRetryException
Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
Summary:[Ctors](https://developer.android.com/reference/java/net/HttpRetryException#pubctors)\|[Methods](https://developer.android.com/reference/java/net/HttpRetryException#pubmethods)\|[Inherited Methods](https://developer.android.com/reference/java/net/HttpRetryException#inhmethods)
# HttpRetryException
`
public
class
HttpRetryException
`
`
``
``
``
extends `[IOException](https://developer.android.com/reference/java/io/IOException)`
``
`
|---|---|---|---|-----------------------------|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) |||||
| ↳ | [java.lang.Throwable](https://developer.android.com/reference/java/lang/Throwable) ||||
| | ↳ | [java.lang.Exception](https://developer.android.com/reference/java/lang/Exception) |||
| | | ↳ | [java.io.IOException](https://developer.android.com/reference/java/io/IOException) ||
| | | | ↳ | java.net.HttpRetryException |
*** ** * ** ***
Thrown to indicate that a HTTP request needs to be retried but cannot be retried automatically, due to streaming mode being enabled.
## Summary
| ### Public constructors ||
|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|
| ` `[HttpRetryException](https://developer.android.com/reference/java/net/HttpRetryException#HttpRetryException(java.lang.String,%20int))`(`[String](https://developer.android.com/reference/java/lang/String)` detail, int code) ` Constructs a new`HttpRetryException`from the specified response code and exception detail message |
| ` `[HttpRetryException](https://developer.android.com/reference/java/net/HttpRetryException#HttpRetryException(java.lang.String,%20int,%20java.lang.String))`(`[String](https://developer.android.com/reference/java/lang/String)` detail, int code, `[String](https://developer.android.com/reference/java/lang/String)` location) ` Constructs a new`HttpRetryException`with detail message responseCode and the contents of the Location response header field. |
| ### Public methods ||
|-----------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| ` `[String](https://developer.android.com/reference/java/lang/String) | ` `[getLocation](https://developer.android.com/reference/java/net/HttpRetryException#getLocation())`() ` Returns the value of the Location header field if the error resulted from redirection. |
| ` `[String](https://developer.android.com/reference/java/lang/String) | ` `[getReason](https://developer.android.com/reference/java/net/HttpRetryException#getReason())`() ` Returns a string explaining why the http request could not be retried. |
| ` int` | ` `[responseCode](https://developer.android.com/reference/java/net/HttpRetryException#responseCode())`() ` Returns the http response code |
| ### Inherited methods |
|-----------------------|---|
| From class` `[java.lang.Throwable](https://developer.android.com/reference/java/lang/Throwable)` ` |-----------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` final void` | ` `[addSuppressed](https://developer.android.com/reference/java/lang/Throwable#addSuppressed(java.lang.Throwable))`(`[Throwable](https://developer.android.com/reference/java/lang/Throwable)` exception) ` Appends the specified exception to the exceptions that were suppressed in order to deliver this exception. | | ` `[Throwable](https://developer.android.com/reference/java/lang/Throwable) | ` `[fillInStackTrace](https://developer.android.com/reference/java/lang/Throwable#fillInStackTrace())`() ` Fills in the execution stack trace. | | ` `[Throwable](https://developer.android.com/reference/java/lang/Throwable) | ` `[getCause](https://developer.android.com/reference/java/lang/Throwable#getCause())`() ` Returns the cause of this throwable or`null`if the cause is nonexistent or unknown. | | ` `[String](https://developer.android.com/reference/java/lang/String) | ` `[getLocalizedMessage](https://developer.android.com/reference/java/lang/Throwable#getLocalizedMessage())`() ` Creates a localized description of this throwable. | | ` `[String](https://developer.android.com/reference/java/lang/String) | ` `[getMessage](https://developer.android.com/reference/java/lang/Throwable#getMessage())`() ` Returns the detail message string of this throwable. | | ` `[StackTraceElement[]](https://developer.android.com/reference/java/lang/StackTraceElement) | ` `[getStackTrace](https://developer.android.com/reference/java/lang/Throwable#getStackTrace())`() ` Provides programmatic access to the stack trace information printed by[printStackTrace()](https://developer.android.com/reference/java/lang/Throwable#printStackTrace()). | | ` final `[Throwable[]](https://developer.android.com/reference/java/lang/Throwable) | ` `[getSuppressed](https://developer.android.com/reference/java/lang/Throwable#getSuppressed())`() ` Returns an array containing all of the exceptions that were suppressed, typically by the`try`-with-resources statement, in order to deliver this exception. | | ` `[Throwable](https://developer.android.com/reference/java/lang/Throwable) | ` `[initCause](https://developer.android.com/reference/java/lang/Throwable#initCause(java.lang.Throwable))`(`[Throwable](https://developer.android.com/reference/java/lang/Throwable)` cause) ` Initializes the*cause*of this throwable to the specified value. | | ` void` | ` `[printStackTrace](https://developer.android.com/reference/java/lang/Throwable#printStackTrace())`() ` Prints this throwable and its backtrace to the standard error stream. | | ` void` | ` `[printStackTrace](https://developer.android.com/reference/java/lang/Throwable#printStackTrace(java.io.PrintWriter))`(`[PrintWriter](https://developer.android.com/reference/java/io/PrintWriter)` s) ` Prints this throwable and its backtrace to the specified print writer. | | ` void` | ` `[printStackTrace](https://developer.android.com/reference/java/lang/Throwable#printStackTrace(java.io.PrintStream))`(`[PrintStream](https://developer.android.com/reference/java/io/PrintStream)` s) ` Prints this throwable and its backtrace to the specified print stream. | | ` void` | ` `[setStackTrace](https://developer.android.com/reference/java/lang/Throwable#setStackTrace(java.lang.StackTraceElement[]))`(`[StackTraceElement[]](https://developer.android.com/reference/java/lang/StackTraceElement)` stackTrace) ` Sets the stack trace elements that will be returned by[getStackTrace()](https://developer.android.com/reference/java/lang/Throwable#getStackTrace())and printed by[printStackTrace()](https://developer.android.com/reference/java/lang/Throwable#printStackTrace())and related methods. | | ` `[String](https://developer.android.com/reference/java/lang/String) | ` `[toString](https://developer.android.com/reference/java/lang/Throwable#toString())`() ` Returns a short description of this throwable. | ||
| From class` `[java.lang.Object](https://developer.android.com/reference/java/lang/Object)` ` |--------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` `[Object](https://developer.android.com/reference/java/lang/Object) | ` `[clone](https://developer.android.com/reference/java/lang/Object#clone())`() ` Creates and returns a copy of this object. | | ` boolean` | ` `[equals](https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object))`(`[Object](https://developer.android.com/reference/java/lang/Object)` obj) ` Indicates whether some other object is "equal to" this one. | | ` void` | ` `[finalize](https://developer.android.com/reference/java/lang/Object#finalize())`() ` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. | | ` final `[Class](https://developer.android.com/reference/java/lang/Class)`` | ` `[getClass](https://developer.android.com/reference/java/lang/Object#getClass())`() ` Returns the runtime class of this`Object`. | | ` int` | ` `[hashCode](https://developer.android.com/reference/java/lang/Object#hashCode())`() ` Returns a hash code value for the object. | | ` final void` | ` `[notify](https://developer.android.com/reference/java/lang/Object#notify())`() ` Wakes up a single thread that is waiting on this object's monitor. | | ` final void` | ` `[notifyAll](https://developer.android.com/reference/java/lang/Object#notifyAll())`() ` Wakes up all threads that are waiting on this object's monitor. | | ` `[String](https://developer.android.com/reference/java/lang/String) | ` `[toString](https://developer.android.com/reference/java/lang/Object#toString())`() ` Returns a string representation of the object. | | ` final void` | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait(long,%20int))`(long timeoutMillis, int nanos) ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*, or until a certain amount of real time has elapsed. | | ` final void` | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait(long))`(long timeoutMillis) ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*, or until a certain amount of real time has elapsed. | | ` final void` | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait())`() ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*. | ||
## Public constructors
### HttpRetryException
Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public HttpRetryException (String detail,
int code)
```
Constructs a new`HttpRetryException`from the specified response code and exception detail message
| Parameters ||
|----------|---------------------------------------------------|
| `detail` | `String`: the detail message.
|
| `code` | `int`: the HTTP response code from server.
|
### HttpRetryException
Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public HttpRetryException (String detail,
int code,
String location)
```
Constructs a new`HttpRetryException`with detail message responseCode and the contents of the Location response header field.
| Parameters ||
|------------|---------------------------------------------------|
| `detail` | `String`: the detail message.
|
| `code` | `int`: the HTTP response code from server.
|
| `location` | `String`: the URL to be redirected to
|
## Public methods
### getLocation
Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public String getLocation ()
```
Returns the value of the Location header field if the error resulted from redirection.
| Returns ||
|--------------------------------------------------------------------|----------------------------|
| [String](https://developer.android.com/reference/java/lang/String) | The location string
|
### getReason
Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public String getReason ()
```
Returns a string explaining why the http request could not be retried.
| Returns ||
|--------------------------------------------------------------------|--------------------------|
| [String](https://developer.android.com/reference/java/lang/String) | The reason string
|
### responseCode
Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)
```
public int responseCode ()
```
Returns the http response code
| Returns ||
|-------|--------------------------------|
| `int` | The http response code.
|